tartrazine/python/README.md

# Python bindings for enry

Python bindings through cFFI (API, out-of-line) for calling enry Go functions exposed by CGo wrapper.

## Build

```
$ pushd .. && make static && popd
$ pip install -r requirements.txt
$ python build_enry.py
```

Will build a static library for Cgo wrapper `libenry`, then generate and build `enry.c` - a CPython extension that provides actual bindings.

## Run

Example for single exposed API function is provided.

```
$ python enry.py
```

## TODOs
 - [x] helpers for sending/receiving Go slices to C
 - [x] read `libenry.h` and generate `ffibuilder.cdef(...)` content
 - [x] cover the rest of enry API
 - [x] add `setup.py`
 - [ ] build/release automation on CI (publish on pypi)
 - [ ] try ABI mode, to avoid dependency on C compiler on install (+perf test?)