xo-umbrella2/xo-pyfacet/README.md

python bindings for c++ faceted object model (xo-facet)

Exposes xo-facet -- the faceted object model (fomo) -- to python. The interesting surface here is the handle machinery: python needs to hold fomo objects across a gc cycle, which is what DHandleStore and ObjectHandle exist to make possible.

Status: scaffold. The module builds, imports and links against xo_facet, but binds nothing yet.

Getting Started

build + install dependencies

• github/Rconybea/xo-facet
• github/Rconybea/xo-pyutil

build + install

$ cd xo-pyfacet
$ mkdir build
$ cd build
$ INSTALL_PREFIX=/usr/local  # or wherever you prefer, e.g. ~/local
$ cmake \
    -DCMAKE_MODULE_PATH=${INSTALL_PREFIX}/share/cmake \
    -DCMAKE_PREFIX_PATH=${INSTALL_PREFIX} \
    -DCMAKE_INSTALL_PREFIX=${INSTALL_PREFIX} ..
$ make
$ make install

Examples

Assumes xo-pyfacet installed to ~/local2/lib/python

PYTHONPATH=~/local2/lib/python:$PYTHONPATH python
>>> import xo.facet
>>> dir(xo.facet)
['__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__']
>>>