pycpp-tools 0.3.1

A utility to initialize basic CMake C++ / pybind11 projects.

pycpp-tools

A command-line utility to initialize a basic CMake C++ or pybind11 project.

Features

• Initialize a CMake C++ project (CMake 3.30, C++23, Ninja)
• Initialize a pybind11 project with --pybind11
• Generate VS Code tasks.json (config / build / run) and CodeLLDB launch.json

Installation

pip install .

Or install in development mode:

pip install -e .

After installation, the pycpp command will be available in your terminal.

Usage

CMake C++ Project

pycpp init --name myproject

Generates:

• src/main.cpp
• CMakeLists.txt
• .vscode/tasks.json (config / build / run)
• .vscode/launch.json (CodeLLDB)

Pybind11 Project

pycpp init --name mymodule --pybind11

Generates:

• src/pywrapper.cpp
• test.py
• CMakeLists.txt (configured against the current Python / pybind11)
• .vscode/tasks.json (config / build / run → python test.py)
• .vscode/launch.json (CodeLLDB attached to Python + test.py)

Options:

• --name <name>: project / module name (default: demo)
• --pybind11: initialize as a pybind11 module

Then build as usual:

cmake -B build -G Ninja
cmake --build build

Or use the VS Code tasks: config → build → run.

Requirements

• Python 3.13 or higher
• CMake 3.30 or higher
• C++ compiler supporting C++23
• Ninja
• CodeLLDB (for debugging)

License

MIT License

Author

R.E. ([e-mail])