meco-core 0.2.1

Mongolian Encoding Converter — pure-by-default Rust library and CLI, ported from Java meco.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# meco-core

`meco-core` is the pure-by-default Rust engine for the Mongolian Encoding Converter. It supports
`Zvvnmod`, `Delehi`, `MenkShape`, `MenkLetter`, and `Z52`; conversions route through the Zvvnmod
hub. The minimum supported Rust version is 1.82.

## Basic use

```rust
use meco_core::{translate, CodeType};

let input = "\u{E0E5}";
let output = translate(CodeType::MenkShape, CodeType::Zvvnmod, input)
    .expect("ZVVNMOD conversion should succeed");
```

## Command line

The package also installs a `meco` binary without changing how Rust projects depend on the library:

```sh
cargo install meco-core --version 0.2.1 --locked
meco translate --from z52 --to menk_shape 'text'
```

Omit the final text argument to read UTF-8 from stdin. Output is written unchanged to stdout without
an extra newline, so the command is safe in pipelines:

```sh
printf '%s' 'text' | meco translate --from z52 --to menk_shape
```

Run `meco --help` for the canonical encoding names and `meco --version` to verify the installed
release.

## Optional UTN #57 output

Canonical UTN #57 Unicode output is available through the same API with the explicit
`utn57-command` feature:

```toml
[dependencies]
meco-core = { version = "0.2.1", features = ["utn57-command"] }
```

The feature is also available to the CLI:

```sh
cargo install meco-core --version 0.2.1 --features utn57-command --locked
```

```rust
use meco_core::{translate, CodeType};

let input = "\u{E0E5}";
let output = translate(CodeType::MenkShape, CodeType::Utn57, input)
    .expect("UTN #57 conversion should succeed");
```

The feature adds the command-backed `zvvnmod-utn57` integration but does not install Python or
run a downloader during the Cargo build. A server or desktop deployment that converts formal
ZVVNMOD shapes must install the reviewed backend explicitly:

```sh
cargo install zvvnmod-utn57 --version 0.1.0-alpha.3 --locked
zvvnmod-install-mongol-norm
```

Without the feature, a non-identity conversion targeting `CodeType::Utn57` returns
`MecoError::Unsupported(CodeType::Utn57)`. With the feature enabled, an unavailable or failing
backend returns `MecoError::Utn57(reason)`. Reverse conversion from UTN #57 remains unsupported.
Identity and blank-input conversions retain the normal short-circuit behavior and do not start the
backend.

The optional conversion path is:

```text
source encoding
→ meco-core ZVVNMOD hub
→ zvvnmod-utn57 0.1.0-alpha.3
→ explicitly installed mongol-norm command
→ canonical Unicode
```

For bindings, distribution, and the Java-oracle verification details, see the
[meco-rust repository](https://github.com/Satsrag/meco-rust).