WxRust

A comprehensive Rust SDK for the WeChat ecosystem, ported from WxJava

English | 简体中文

Overview · Modules · Architecture · Quick Start · Features · Quality · Compatibility · Contributing

Version: 0.1.0 MSRV: Rust 1.85 Edition: 2024 Workspace Resolver: 3 Maturity: Experimental Last verified: 2026-08-10

1. Overview

1.1 What is WxRust?

WxRust is a Rust workspace providing a full-stack SDK for WeChat backend development, covering Official Accounts (MP), Mini Programs, WeChat Pay, WeChat Work (CP), Open Platform, Channels/Shop, and AI Speech.

It is a semantic port of WxJava (v4.8.4.B), aiming for 100% functional behavior parity while adopting idiomatic Rust patterns.

1.2 What WxRust is NOT

• Not a binary-compatible drop-in for WxJava; API names are preserved but signatures use Rust idioms (Result, Option, async fn).
• Not a thin FFI wrapper; it is a pure Rust reimplementation.
• Not production-ready yet; the project is in experimental/migration phase.

1.3 Status Evidence

2. Module Map

3. Architecture

┌─────────────────────────────────────────────────────────┐
│  Integration (future)  wx-rust-vernal / wx-rust-axum    │
├─────────────────────────────────────────────────────────┤
│  Business Layer  wx-rust-mp / miniapp / pay / cp /       │
│                  open / channel / aispeech / qidian      │
│                  Service traits + sub-domain services    │
├─────────────────────────────────────────────────────────┤
│  Foundation      wx-rust-common                          │
│                  error / config / http / bean / session  │
├─────────────────────────────────────────────────────────┤
│  Facade          wx-rust (feature-gated re-exports)      │
└─────────────────────────────────────────────────────────┘

3.1 Dependency Rules

• wx-rust-common has zero business-crate dependencies.
• Business crates depend only on common; no inter-business dependencies.
• Facade does re-exports only; no logic.

3.2 Key Java-to-Rust Mappings

4. Rust Baseline

5. Quick Start

5.1 Add dependency

[dependencies]
wx-rust-common = { git = "https://github.com/easy-4-rust/WxRust", branch = "main" }

5.2 Minimal example

use wx_rust_common::error::WxError;

fn main() {
    let json = r#"{"errcode":0,"errmsg":"ok"}"#;
    let err = WxError::from_json(json);
    println!("error_code={}", err.error_code);
}

5.3 Enable a business module

[dependencies]
wx-rust-mp = { git = "https://github.com/easy-4-rust/WxRust", branch = "main" }

6. Cargo Features

[dependencies]
wx-rust-common = { version = "0.1.0", default-features = false, features = ["redis"] }

7. Project Structure

WxRust/
├── Cargo.toml              # Workspace
├── crates/
│   ├── wx-rust/            # Facade (feature-gated)
│   ├── wx-rust-common/     # Foundation
│   ├── wx-rust-mp/         # Official Accounts
│   ├── wx-rust-miniapp/    # Mini Programs
│   ├── wx-rust-pay/        # WeChat Pay
│   ├── wx-rust-cp/         # WeChat Work
│   ├── wx-rust-open/       # Open Platform
│   ├── wx-rust-channel/    # Channels / Shop
│   ├── wx-rust-aispeech/   # AI Speech
│   └── wx-rust-qidian/     # Qidian
├── docs/                   # Architecture, migration, tech stack
├── scripts/                # Audit and generation scripts
├── integration/            # Framework integrations (future)
└── README.md

8. Quality Gates

8.1 Core gates

cargo check --workspace
cargo test --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings

8.2 Coverage

cargo llvm-cov --workspace --summary-only

Coverage is a signal for gap detection, not a completion authority. Completion authority is the per-module object ledger + semantic table + name consistency check.

9. Compatibility with WxJava

9.1 Upstream reference

9.2 Object migration status

9.3 Key semantic mappings

9.4 Explicit non-migration items

10. Documentation

11. Troubleshooting

12. Contributing & License

Contributions welcome. Before submitting, run:

cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace

This project is licensed under Apache-2.0.

Upstream: WxJava (Apache-2.0).

Back to top · Issues