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 months ago
examples correct gen-config 2 months ago
pEpACIDgen gen_pybind11: methods add py_arg, add docstrings. 2 months ago
tests update for CS (no APSs) 2 months ago
.editorconfig .editorconfig more filetype specifics 6 months ago
.gitignore gitignore 2 months ago
AUTHORS.txt pEpACIDgen - INITIAL COMMIT 3 months ago
LICENSE.txt adding LICENSE.txt - this adapter is under the GNU Affero General Public License 5 years ago
MANIFEST.in pEpACIDgen - INITIAL COMMIT 3 months ago
Makefile name the venvs, so you know which one you are in. 2 months ago
README yeaaah! 3 months ago
pyproject.toml pEpACIDgen - INITIAL COMMIT 3 months ago
setup.cfg pEpACIDgen - INITIAL COMMIT 3 months ago
setup.py pEpACIDgen - INITIAL COMMIT 3 months 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.