https://github.com/mckib2/cythonator

C++ header to Cython transpilation.
https://github.com/mckib2/cythonator

Last synced: 20 days ago
JSON representation

C++ header to Cython transpilation.

• Host: GitHub
• URL: https://github.com/mckib2/cythonator
• Owner: mckib2
• Created: 2020-08-07T15:21:06.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-11-15T05:07:15.000Z (about 4 years ago)
• Last Synced: 2024-10-31T10:12:06.905Z (2 months ago)
• Language: C++
• Size: 1.23 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
Cythonator

==========

THIS PROJECT IS A WORK-IN-PROGRESS

The goal is to use the LLVM/Clang parser and AST tooling to parse a C++ header file and transform the resulting AST into Cython wrappers.  I've created a similar tool using Doxygen's parser and XML output tools in the past but it chokes on modern C++ features, heavy templating, and macro usage.

The tool is made to be as friendly as possible:

    python -m cythonator.cythonator --header my/header/file.hpp --output my/cython/file.pyx

This will produce a compilable PYX file auto-magically generated from the definitions in the C++ header file.

I'm slowly gathering a pool of test cases.  Most breakage I find is due to templates and meta-programming -- mostly Cython not having infrastructure to handle it.

LLVM/Clang

==========

The goal is build the Clang frontend and tooling libraries required for parsing sources and generating an AST as part of this Python package.  The build currently works on Ubuntu 18.04 (plus or minus a few generated files), but needs modification to work on Windows and Mac.

The current state of `cythonator` requires `clang` to be installed and accessible on the PATH.