Skip to main content

Python integration of the 'nuklear' C library.

Project description

https://travis-ci.org/nathanrw/nuklear-cffi.svg?branch=master

A semi-automatic Python binding for the nuklear C library.

The core of this is a python program that parses the nuklear.h header for declarations and passes this to the ‘cffi’ Python binding generator.

Declarations are extracted using a C preprocessor followed by some simple ad hoc text transformations. The ‘pcpp’ preprocessor is used. This is a C preprocessor written in Python, so the preprocessing step doesn’t actually require a C compiler to be installed.

However, the process of generating the Python binding requires a C compiler.

Some code for interfacing nuklear with pygame is provided under pynk.nkpygame.

Usage

See demo.py. The gist of it is to call the nuklear API via the ffi and lib objects imported from pynk - this is provided by the cffi library. Some code for interfacing with pygame is provided.

Installation

The package on pypi should work: https://pypi.python.org/pypi/pynk

Otherwise

python2 setup.py install

in the git repository should do it.

Dependencies

  • cffi, a Python library.

  • pcpp, a C preprocessor written in Python.

As such you will need a C compiler installed if you want to build the library.

Note that at present the pcpp in pypi won’t cut it, because in order to preprocess nuklear.h we rely on a fix that has not (as of writing) yet been integrated. You will have to install the one in my github fork.

For the pygame integration code, pygame is necessary, but it’s not a requirement for installation or to use the binding.

How to do a release

The following script will increment the version, commit the change and push a tag. The Travis build will then deploy a new version.

python ./bin/version.py (--major|--minor|--patch)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pynk-0.4.7.tar.gz (187.9 kB view details)

Uploaded Source

Built Distribution

pynk-0.4.7-py2.7-linux-x86_64.egg (886.2 kB view details)

Uploaded Egg

File details

Details for the file pynk-0.4.7.tar.gz.

File metadata

  • Download URL: pynk-0.4.7.tar.gz
  • Upload date:
  • Size: 187.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/2.7.14

File hashes

Hashes for pynk-0.4.7.tar.gz
Algorithm Hash digest
SHA256 4b392ee814296e6a39cdfdabfb1159d4b3ea7b4ec59964f1dfb2825eed24f8a5
MD5 6a0111eab836a2411c9930fe8f25e627
BLAKE2b-256 748a802a528fdee34df7607941794379e39346fefb760db2421956de8b6d7c52

See more details on using hashes here.

File details

Details for the file pynk-0.4.7-py2.7-linux-x86_64.egg.

File metadata

  • Download URL: pynk-0.4.7-py2.7-linux-x86_64.egg
  • Upload date:
  • Size: 886.2 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/2.7.14

File hashes

Hashes for pynk-0.4.7-py2.7-linux-x86_64.egg
Algorithm Hash digest
SHA256 8f07eeba99d84271b54118865f35dfb9b69d6202af1c913fb20c74dc2813f343
MD5 1856a4040d4d13276bd991cc1b937044
BLAKE2b-256 5e689ecc7916c4a19f029b3ee5d848d18a884c7c14a1cb8a0c54f309f2eaeb10

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page