Publish merjs to PyPI registry

[justrach]

Goal

Make merjs installable via pip: pip install merlionjs

Deliverables

• Create packages/pypi/ package structure
• Set up PyPI account and API token
• Package name merlionjs secured and published
• Test on macOS, Linux, Windows
• Update README with pip installation instructions

Package Structure

packages/pypi/
├── pyproject.toml     # Modern Python packaging
├── setup.py           # Custom install with binary download
├── src/merjs/
│   ├── __init__.py    # Package API
│   ├── cli.py         # Entry point wrapper
│   └── install.py     # Binary downloader
└── README.md

Installation Flow

1. User runs pip install merlionjs
2. Setup script triggers binary download during install
3. Downloads appropriate binary from GitHub releases
4. Verifies SHA256 checksum
5. Places binary in package bin/ directory
6. mer and merjs CLI commands registered via entry points

Install Commands

pip install merlionjs
mer init my-app

Technical Details

• Uses modern pyproject.toml + setuptools
• Entry points: mer and merjs commands
• Downloads from: https://github.com/justrach/merjs/releases
• Supports: macOS (x64/arm64), Linux (x64/arm64), Windows (x64)
• Requires Python 3.8+

Published

✅ Package: https://pypi.org/project/merlionjs/0.2.2/

Related

• npm distribution issue Publish merjs to npm registry #77
• Issue dx: consumer build.zig has to reach into merjs internals (src/main.zig, tools/codegen.zig, src/worker.zig) #67 (build system DX)

[justrach]

Resolved by PR #81.