Metadata-Version: 2.1
Name: inclua
Version: 0.2.0
Summary: C to scripting languages wrapper generator, INitialy for binding C to LUA
Home-page: https://github.com/gilzoide/inclua
Author: gilzoide
Author-email: gilzoide@gmail.com
License: GPLv3
Keywords: language bindings development
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Requires-Dist: c-api-extract (>=0.4)
Requires-Dist: docopt
Requires-Dist: pyyaml

Inclua
======
Wrapper generator from C to scripting languages, currently supporting LuaJIT_ FFI only.
It uses clang_ via c_api_extract_ for parsing and understanding C header files.

.. _LuaJIT: https://luajit.org/
.. _clang: https://pypi.org/project/clang/
.. _c_api_extract: https://github.com/gilzoide/c_api_extract-py


Installing
----------
**inclua** is available on PyPI_ and may be installed using ``pip``::

  $ pip install inclua

.. _PyPI: https://pypi.org/project/inclua/


Usage
-----
On your shell::

    $ inclua <input> [-m <module_name>] [-p <pattern>...] [-n <namespace>...] [-g] [-d <definitions_file> | --no-metatypes] [-- <clang_args>...]

Check out the help for more information on arguments::

    $ inclua -h


It is recommended to pass ``-I <path to clang headers>`` to *clang* to correctly
include some standard headers like **stddef.h** and **stdbool.h**.

Check out the ``examples`` folder for an example of usage.


