lemma 0.8.21

A pure, declarative language for business rules.
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

# lemma

> **A pure, declarative language for business rules.** Command-line interface for [Lemma](https://github.com/lemma/lemma).

Run Lemma without installing anything globally:

```bash
npx lemma help
```

Or install globally:

```bash
npm install -g lemma
lemma --help
```

## How it works

This package is a thin Node.js launcher. The actual `lemma` binary is shipped as a platform-specific optional dependency (one of `@lemmabase/cli-linux-x64`, `@lemmabase/cli-linux-arm64`, `@lemmabase/cli-darwin-x64`, `@lemmabase/cli-darwin-arm64`, `@lemmabase/cli-win32-x64`). npm installs only the package matching your OS and CPU; the launcher then `exec`s the native binary directly. No download steps, no `postinstall` scripts, works offline.

## Supported platforms

- Linux x86_64 (musl, statically linked)
- Linux aarch64 (musl, statically linked)
- macOS x86_64
- macOS aarch64 (Apple Silicon)
- Windows x86_64

If your platform is not supported, install via Cargo instead:

```bash
cargo install lemma
```

## Common commands

```bash
npx lemma run shipping
npx lemma run tax_calculation --rules=tax_owed
npx lemma run tax_calculation income=75000 filing_status="married"
npx lemma list
npx lemma schema pricing
npx lemma server --prefix ./examples --port 8012
```

Each command supports `--help`.

## Documentation

- CLI reference: <https://github.com/lemma/lemma/blob/main/documentation/reference/cli.md>
- Learn guide: <https://github.com/lemma/lemma/blob/main/documentation/learn/readme.md>
- Examples: <https://github.com/lemma/lemma/tree/main/documentation/examples>

## Local development

To rebuild and test this package locally:

```bash
cargo build --release -p lemma
mkdir -p /tmp/lemma-bins/linux-x64
cp target/release/lemma /tmp/lemma-bins/linux-x64/lemma
node cli/packages/npm/build.js --binaries /tmp/lemma-bins
cd cli/packages/npm/dist/lemma && npm pack --dry-run
```

End-to-end smoke test:

```bash
cd cli/packages/npm/dist
npm pack ./lemma ./platforms/linux-x64
mkdir -p /tmp/lemma-smoke && cd /tmp/lemma-smoke
npm init -y >/dev/null
npm install /path/to/cli/packages/npm/dist/lemma-*.tgz \
            /path/to/cli/packages/npm/dist/lemmabase-cli-linux-x64-*.tgz
npx lemma --help
```

## License

Apache-2.0