Python C/C++ API Professional Template (Meson Version)

A high-performance, modern template for creating Python extension modules using the native Python C API (<Python.h>) with the Meson build system and Ninja backend.

Features

• Meson & Ninja: The fastest and most modern build system for C/C++ projects.
• Modern C++: Pre-configured for C++20.
• uv Support: High-speed environment management (with fallback to standard Python).
• Hybrid Parallelism Friendly: Easily extensible to support OpenMP or other libraries via Meson dependencies.
• Complex Examples Included:
  • Keyword argument handling (PyArg_ParseTupleAndKeywords).
  • Python sequence processing (List to std::vector).
  • Dictionary creation and mapping.
  • Custom Exception handling with proper reference counting.

Directory Structure

• cppmodule/: The C++ extension source code.
  • src/: Implementation files (.cpp).
  • include/: Header files (.h).
• lib/: Third-party C/C++ libraries (gitkept).
• tests/: Python unit tests using pytest.
• main.py: Entry point for quick demonstration and manual testing.
• meson.build: The Meson build configuration.
• Makefile: Convenient wrapper for environment and build management.

Getting Started

1. Initialize Environment

The Makefile automatically detects uv or standard Python to create a virtual environment and install build tools (Meson, Ninja).

make venv

2. Configure & Build

make setup
make build

3. Run Demonstration

make run

4. Run Tests

make tests

Makefile Targets

Author

nguyenpanda
Email: [email protected]
Website: https://nguyenpanda.com

License

MIT License