cppgolf 0.1.9

C++ multi-file merge & code golf / minifier tool

CPPGolf

cppgolf is a C/C++ multi-file merge and code-golf/minifier tool.

Install

pip install cppgolf

libclang-backed features such as symbol renaming, type renaming, and static deduplication are optional at runtime. The base CLI and text transforms work without clang.cindex.

CLI

cppgolf solution.cpp
cppgolf solution.cpp -o golf.cpp
cppgolf solution.cpp --merge-only -I include/
cppgolf solution.cpp -DDEBUG=1 --inject-define --merge-only
cppgolf solution.cpp -I include/ --rename-functions --stats
cppgolf solution.cpp -DBOTZONE_PIKAFISH_STANDALONE=1 -DZSTD_DISABLE_ASM
cppgolf solution.cpp --no-rename

Common options

Option	Meaning
-o FILE	Write output to a file instead of stdout.
-I DIR	Add an include search directory. Can be repeated.
-D MACRO[=VALUE]	Pass a macro definition to libclang-backed optional passes. Can be repeated.
--inject-define	Write -D macro definitions into the generated source code.
--merge-only	Only merge files. Skip all later transforms and compression passes.
--no-merge	Skip inlining #include "...".
--no-strip-comments	Keep comments.
--no-compress-ws	Keep whitespace formatting.
--no-std-ns	Do not add using namespace std;.
--no-typedefs	Do not add shortcuts such as ll / ld.
--no-rename	Disable symbol renaming.
--no-win-lean	Do not inject Windows header conflict guards.
--keep-main-return	Keep the trailing return 0; in main.
--keep-endl	Keep endl.
--keep-inline	Keep inline.
--dedup-statics	Deduplicate merged static definitions with libclang.
--aggressive	Remove braces from single-statement if / for / while.
--shortcuts	Insert #define shortcuts for frequent cout / cin.
--rename-functions	Also rename user-defined functions and methods.
--rename-type	Add typedef aliases for long user-defined type names.
--stats	Print size reduction statistics to stderr.

Python API

from pathlib import Path

from cppgolf import process

result, merged_size = process(
    Path("solution.cpp"),
    include_dirs=[],
    defines=["BOTZONE_PIKAFISH_STANDALONE=1"],
    inject_defines=False,
    merge_only=False,
    rename_symbols=False,
)

print(merged_size)
print(result)

Individual passes can also be used directly:

from cppgolf import compress_whitespace, strip_comments
from cppgolf.transforms import golf_typedefs

code = Path("a.cpp").read_text()
code = strip_comments(code)
code = golf_typedefs(code)
code = compress_whitespace(code)

Features

• Merge local #include "..." files recursively and deduplicate top-level system headers.
• Strip comments while preserving strings, character literals, and raw strings.
• Apply safe default text transforms such as std:: removal, typedef shortcuts, endl replacement, inline removal, and trailing return 0; removal in main.
• Compress whitespace at token granularity while preserving preprocessor line structure.
• Optionally rename symbols and user-defined types with libclang.