feat(worker): implement

.github/workflows/worker.yml

@@ -0,0 +1,37 @@
+name: Deploy Worker
+on:
+  push:
+  pull_request:
+  repository_dispatch:
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    # For Workers Deployment fork only
+    if: github.repository != 'Gowee/zhconv-rs'
+    timeout-minutes: 60
+    steps:
+      # - run: echo '${{ toJSON(github.event) }}' | jq .
+      - uses: actions/checkout@v2
+      - name: Activate OpenCC Dicts
+        run: sed -i 's/default = \[/\0"opencc"/' worker/Cargo.toml
+      - name: Disable other workflows in Workers fork
+        if: github.run_number == 1 && github.event_name == 'repository_dispatch' && github.event.repository.fork == true
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          flows=$(gh workflow list --json 'name,id' --jq '.[] | select(.name != "${{ github.workflow }}") | .id')
+          echo "Workflows to disable: $flows"
+          for flow in $flows; do
+            gh workflow disable $flow
+          done
+          # runs=$(gh run list --json 'databaseId' --jq '.[] | select(.databaseId != ${{ github.run_id }}) | .databaseId')
+          # echo "Runs to cancel: $runs"
+          # for run in $runs; do
+          #   gh run cancel $run
+          # done
+      - name: Build & Deploy Worker
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CF_API_TOKEN }}
+          accountId: ${{ secrets.CF_ACCOUNT_ID }}
+          workingDirectory: worker

Cargo.toml

@@ -27,6 +27,7 @@ once_cell = "1.20"
 regex = "1.11"
 ruzstd = { version = "0.7", optional = true }
 strum = { version = "0.26", features = ["derive"] }
+serde = { version = "1.0",  optional = true, features = ["serde_derive"] }
 
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 wasm-bindgen = "0.2"

README.md

@@ -18,6 +18,12 @@ It leverages the [Aho-Corasick](https://github.com/daac-tools/daachorse) algorit
 
 🐍 **Python package w/ wheels via PyO3**: `pip install zhconv-rs` or `pip install zhconv-rs-opencc` (with rulesets from OpenCC)
 
+<a href="https://deploy.workers.cloudflare.com/?url=https://github.com/gowee/zhconv-rs">
+    <img src="https://deploy.workers.cloudflare.com/button" align="right" alt="Deploy to Cloudflare Workers">
+</a>
+
+🧩 **API demo**: https://zhconv.bamboo.workers.dev
+
 <details open>
  <summary>Python snippet</summary>
 

src/variant.rs

@@ -15,29 +15,52 @@ use crate::utils::get_with_fallback;
 
 /// Chinese variants (a.k.a 中文變體), parsed from language tags, as listed in [Help:高级字词转换语法#组合转换标签](https://zh.wikipedia.org/wiki/Help:高级字词转换语法#组合转换标签).
 #[derive(
-    Clone, Copy, Debug, PartialEq, Eq, Hash, Display, EnumString, VariantNames, IntoStaticStr,
+    Clone,
+    Copy,
+    Debug,
+    Default,
+    PartialEq,
+    Eq,
+    Hash,
+    Display,
+    EnumString,
+    VariantNames,
+    IntoStaticStr,
 )]
 #[strum(serialize_all = "kebab_case", ascii_case_insensitive)]
-#[derive(Default)]
+#[cfg_attr(
+    feature = "serde",
+    derive(serde::Serialize, serde::Deserialize),
+    serde(rename_all = "kebab-case")
+)]
 pub enum Variant {
     #[default]
     /// Chinese (dummy variant)
     Zh,
     /// Script: Traditional Chinese
+    #[cfg_attr(feature = "serde", serde(alias = "zh-Hant"))]
     ZhHant,
     /// Script: Simplified Chinese
+    #[cfg_attr(feature = "serde", serde(alias = "zh-Hans"))]
     ZhHans,
     /// Short for `zh-Hant-TW`, Script: Traditional Chinese, Region: Taiwan
+    #[cfg_attr(feature = "serde", serde(rename = "zh-tw", alias = "zh-TW"))]
+    // zh-t-w by serde by default
     ZhTW,
     /// Short for`zh-Hant-HK`, Script: Traditional Chinese, Region: Hong Kong
+    #[cfg_attr(feature = "serde", serde(rename = "zh-hk", alias = "zh-HK"))]
     ZhHK,
     /// Short for`zh-Hant-MO`, Script: Traditional Chinese, Region: Macau
+    #[cfg_attr(feature = "serde", serde(rename = "zh-mo", alias = "zh-MO"))]
     ZhMO,
     /// Short for`zh-Hans-MY`, Script: Simplified Chinese, Region: Malaysia
+    #[cfg_attr(feature = "serde", serde(rename = "zh-my", alias = "zh-MY"))]
     ZhMY,
     /// Short for`zh-Hans-SG`, Script: Simplified Chinese, Region: Singapore
+    #[cfg_attr(feature = "serde", serde(rename = "zh-sg", alias = "zh-SG"))]
     ZhSG,
     /// Short for`zh-Hans-CN`, Script: Simplified Chinese, Region: China (mainland)
+    #[cfg_attr(feature = "serde", serde(rename = "zh-cn", alias = "zh-CN"))]
     ZhCN,
     // Unknown(String)
 }

worker/.gitignore

@@ -0,0 +1,4 @@
+target
+node_modules
+.wrangler
+dist/