marisa-bindings 1.0.3

Python bindings for the MARISA Trie library implemented in C++ using SWIG.

marisa-bindings

Python bindings for the MARISA Trie library implemented in C++ using SWIG.

This is an unofficial binding project and is not affiliated with the original MARISA authors.

Installation

It is recommended to use a virtual environment to isolate dependencies.

python -m venv .venv
source .venv/bin/activate

Install from PyPI

pip install marisa-bindings

Install from GitHub

pip install git+https://github.com/juno-rmks/marisa-bindings.git

Build requirements (source install only)

If a prebuilt wheel is not available for your platform, the package will be built locally. In that case you need:

• A C++ compiler toolchain
• SWIG ≥ 4.0
• Python development headers

Linux

sudo apt install build-essential python3-dev swig

macOS

xcode-select --install
brew install swig

Windows

Install Visual Studio Build Tools (or Visual Studio) with the workload:

• Desktop development with C++

Usage

from marisa_bindings import marisa

For a complete example, see:

• marisa-bindings-sample.py

Vendoring policy

This project vendors the upstream MARISA source using git subtree to ensure:

• reproducible builds
• long-term stability
• independence from upstream availability

Vendored upstream source lives here:

• third_party/marisa-trie/upstream/

Do not modify vendored files directly. If changes are required, prefer upstream contributions; otherwise keep local patches minimal.

License

This repository contains multiple components under different licenses:

Component	License
Bindings code in this repository	BSD-2-Clause
Upstream MARISA Trie (marisa-trie)	BSD-2-Clause or LGPL-2.1+

See LICENSE and the vendored upstream license files for details.

Acknowledgments

Special thanks to the original authors of MARISA Trie for creating the library.