p≡p Abstract C Interface Description Generator. Featuring a pyBind11 backend using yml2.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
heck 5aea5d8074 gen_pybind11: methods add py_arg, add docstrings. 2 years ago
examples correct gen-config 2 years ago
pEpACIDgen gen_pybind11: methods add py_arg, add docstrings. 2 years ago
tests update for CS (no APSs) 2 years ago
.editorconfig .editorconfig more filetype specifics 2 years ago
.gitignore gitignore 2 years ago
AUTHORS.txt pEpACIDgen - INITIAL COMMIT 2 years ago
LICENSE.txt adding LICENSE.txt - this adapter is under the GNU Affero General Public License 6 years ago
MANIFEST.in pEpACIDgen - INITIAL COMMIT 2 years ago
Makefile name the venvs, so you know which one you are in. 2 years ago
README yeaaah! 2 years ago
pyproject.toml pEpACIDgen - INITIAL COMMIT 2 years ago
setup.cfg pEpACIDgen - INITIAL COMMIT 2 years ago
setup.py pEpACIDgen - INITIAL COMMIT 2 years ago

README

██▓███  ▓█████  ██▓███   ▄▄▄       ▄████▄   ██▓▓█████▄   ▄████ ▓█████  ███▄    █
▓██░ ██▒▓█ ▀ ▓██░ ██▒▒████▄ ▒██▀ ▀█ ▓██▒▒██▀ ██▌ ██▒ ▀█▒▓█ ▀ ██ ▀█ █
▓██░ ██▓▒▒███ ▓██░ ██▓▒▒██ ▀█▄ ▒▓█ ▄ ▒██▒░██ █▌▒██░▄▄▄░▒███ ▓██ ▀█ ██▒
▒██▄█▓▒ ▒▒▓█ ▄ ▒██▄█▓▒ ▒░██▄▄▄▄██ ▒▓▓▄ ▄██▒░██░░▓█▄ ▌░▓█ ██▓▒▓█ ▄ ▓██▒ ▐▌██▒
▒██▒ ░ ░░▒████▒▒██▒ ░ ░ ▓█ ▓██▒▒ ▓███▀ ░░██░░▒████▓ ░▒▓███▀▒░▒████▒▒██░ ▓██░
▒▓▒░ ░ ░░░ ▒░ ░▒▓▒░ ░ ░ ▒▒ ▓▒█░░ ░▒ ▒ ░░▓ ▒▒▓ ▒ ░▒ ▒ ░░ ▒░ ░░ ▒░ ▒ ▒
░▒ ░ ░ ░ ░░▒ ░ ▒ ▒▒ ░ ░ ▒ ▒ ░ ░ ▒ ▒ ░ ░ ░ ░ ░░ ░░ ░ ▒░
░░ ░ ░░ ░ ▒ ░ ▒ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░
░ ░ ░ ░░ ░ ░ ░ ░ ░ ░ ░
░ ░

pEpACIDgen
==========

pEpACIDgen stands for "pEp Abstract C Interface Description Generator"

pEpACIDgen generates an Abstract C Interface Defintion file (json or yml2) given the inputs:
* headerfile
* list of function names needed
* list of var names needed

The generator searches each function/var in the headerfile (recursively) and collects all the
types needed (var type, return type, parm types).
As structs can contain further types, these dependent types need to be collected
recursively.
Finally, all the collected types will be resolved to their final underlying type.
If a type is primitive, nothing needs to be done, cause its already defined.
But types of typekind struct or enum need to be defined.
Their definition will be searched for in the headerfile and included in the interface definition
The ACID file (yml2) contains all the information needed to represent:
* functions
* vars
* structs
* enums

well enough so they can be expressed in pyBind11.
use "pyBind11-CID" to generate the pyBind11 code out of the ACID file.