Python package generation script

[kwabenantim]

Fixes #102

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.75%. Comparing base (d7de4ca) to head (8694917).

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #121      +/-   ##
===========================================
+ Coverage    99.73%   99.75%   +0.02%     
===========================================
  Files           29       31       +2     
  Lines         2258     2469     +211     
  Branches       490      532      +42     
===========================================
+ Hits          2252     2463     +211     
  Misses           5        5              
  Partials         1        1              

Flag	Coverage Δ
cells	71.26% <18.77%> (-4.96%)	⬇️
shapes	71.28% <23.58%> (-4.94%)	⬇️
unit	93.14% <97.37%> (+0.37%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
cppwg/__main__.py	100.00% <100.00%> (ø)
cppwg/generators.py	99.45% <100.00%> (+0.02%)	⬆️
cppwg/genpackage.py	100.00% <100.00%> (ø)
cppwg/info/base_info.py	100.00% <ø> (ø)
cppwg/info/class_info.py	100.00% <100.00%> (ø)
cppwg/info/exclusions.py	100.00% <100.00%> (ø)
cppwg/utils/constants.py	100.00% <100.00%> (ø)
cppwg/utils/package_model.py	100.00% <100.00%> (ø)
cppwg/writers/free_function_writer.py	100.00% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Adds config-driven generation of Python package layers to prevent wrapper/package drift.

Changes:

• Emits a YAML package model during wrapper generation.
• Adds cppwg genpackage for generating imports and template aliases.
• Updates examples, tests, and documentation.

Reviewed changes

Copilot reviewed 29 out of 29 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
tools/cppwg_genpackage.py	Adds standalone launcher.
tests/test_package_model.py	Tests package-model construction.
tests/test_genpackage.py	Tests package generation and CLI.
examples/shapes/wrapper/package_layout.yaml	Defines shapes package layout.
examples/shapes/wrapper/cppwg_package_model.yaml	Adds generated shapes model.
examples/shapes/src/py/pyshapes/primitives/_generated.py	Generates primitive exports and aliases.
examples/shapes/src/py/pyshapes/primitives/__init__.py	Imports generated primitives.
examples/shapes/src/py/pyshapes/math_funcs/_generated.py	Generates function exports.
examples/shapes/src/py/pyshapes/math_funcs/__init__.py	Imports generated functions.
examples/shapes/src/py/pyshapes/geometry/_generated.py	Generates geometry aliases.
examples/shapes/src/py/pyshapes/geometry/__init__.py	Imports generated geometry.
examples/shapes/src/py/pyshapes/composites/_generated.py	Generates composite exports.
examples/shapes/src/py/pyshapes/composites/__init__.py	Imports generated composites.
examples/cells/tests/test_cells.py	Tests nested template subscripting.
examples/cells/src/py/pycells/_generated.py	Generates cell exports and aliases.
examples/cells/src/py/pycells/__init__.py	Imports generated cell API.
examples/cells/dynamic/wrappers/cppwg_package_model.yaml	Adds generated cells model.
examples/cells/dynamic/package_layout.yaml	Defines flat cells layout.
doc/python-packages.md	Documents package generation.
doc/index.md	Adds documentation navigation.
doc/configuration.md	Updates project naming.
doc/basics.md	Updates project naming.
cppwg/utils/package_model.py	Builds serializable package models.
cppwg/utils/constants.py	Adds model and template constants.
cppwg/info/class_info.py	Centralizes template-name separators.
cppwg/info/base_info.py	Revises option commentary.
cppwg/genpackage.py	Implements package-layer generation.
cppwg/generators.py	Writes package models.
cppwg/__main__.py	Dispatches the new subcommand.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 30 out of 30 changed files in this pull request and generated 1 comment.

Suppressed comments (2)

cppwg/genpackage.py:95

• This still omits untemplated classes from the C++-to-Python index. If OldCell is wrapped as NewCell and used by Factory<OldCell>, the generated key remains ("OldCell",) while Factory[NewCell] normalizes to ("NewCell",), causing KeyError. Carry the real C++ name for untemplated classes too and index every instantiation, not only those with template arguments.

                if inst["args"]:
                    cpp = inst.get("cpp_name") or (
                        f'{class_info["base"]}<{",".join(inst["args"])}>'
                    )
                    index[cpp] = inst["py_name"]

cppwg/genpackage.py:163

• Importing the helper as public TemplateClass makes from ._generated import * expose it from every generated subpackage. It can also overwrite a legitimately wrapped class named TemplateClass, making that binding inaccessible whenever any templated stub is present. Import the helper under a private alias and render stubs against that alias (or define an explicit __all__ that excludes the helper).

    lines = [GENERATED_HEADER.rstrip("\n"), "", compiled_import]
    if templated_classes:
        lines.append(f"from {package}._syntax import TemplateClass")

[Copilot]

Pull request overview

Copilot reviewed 33 out of 33 changed files in this pull request and generated no new comments.

Suppressed comments (3)

cppwg/genpackage.py:190

• This import binds the top-level package name in _generated.py. Since the sibling __init__.py star-imports this file, an empty subpackage unexpectedly exports pkg despite owning no symbols. Alias the extension to a private name so the validity-only import does not leak into the package API.

        return f"import {package}.{compiled_module}  # noqa: F401"

cppwg/genpackage.py:261

• The shared-module split only knows the enum type name, but an enum with should_export_values() also creates module-level enumerator bindings. For example, ShapeKind exposes CIRCLE (examples/shapes/src/py/tests/test_classes.py:89-95); assigning ShapeKind to a split subpackage imports only ShapeKind, so subpackage.CIRCLE disappears even though it is wrapped. Include exported enumerator names in the package model and import/export them with their owning enum.

        for name in module["enums"] + module["free_functions"]:
            other_names.add(name)

cppwg/genpackage.py:95

• Un-templated classes are excluded from this index, so a renamed class used as a template argument still cannot resolve. For example, if C++ OldName is exposed as NewName, the model renders Factory<OldName> with key ("OldName",), while Factory[NewName] normalizes to ("NewName",) and raises KeyError. Carry the untemplated instantiation's C++ name in the model and index it here as OldName -> NewName.

                if inst["args"]:
                    cpp = inst.get("cpp_name") or (
                        f'{class_info["base"]}<{",".join(inst["args"])}>'
                    )
                    index[cpp] = inst["py_name"]