pycxxfilt 0.1.0__tar.gz

pycxxfilt-0.1.0/.clang-format

@@ -0,0 +1,9 @@
+# SPDX-License-Identifier: Apache-2.0
+# PEP 7 style for CPython extension modules
+BasedOnStyle: LLVM
+IndentWidth: 4
+ColumnLimit: 79
+BreakBeforeBraces: Linux
+AlwaysBreakAfterReturnType: TopLevelDefinitions
+AllowShortFunctionsOnASingleLine: None
+UseTab: Never

pycxxfilt-0.1.0/.github/dependabot.yml

@@ -0,0 +1,15 @@
+# SPDX-License-Identifier: Apache-2.0
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      actions:
+        patterns: ["*"]
+
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly

pycxxfilt-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,136 @@
+# SPDX-License-Identifier: Apache-2.0
+name: Build & Publish
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+      - name: Build sdist
+        run: uv build --sdist
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  wheels-linux:
+    name: Build Linux wheels (${{ matrix.arch }})
+    needs: sdist
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        arch: [x86_64, aarch64, ppc64le, s390x]
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
+        with:
+          name: sdist
+          path: dist
+      - name: Resolve sdist path
+        id: sdist
+        run: echo "path=$(ls dist/*.tar.gz)" >> "$GITHUB_OUTPUT"
+        shell: bash
+      - name: Set up QEMU
+        if: matrix.arch != 'x86_64'
+        uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a  # v4.0.0
+        with:
+          platforms: linux/${{ matrix.arch }}
+      - uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
+        with:
+          package-dir: ${{ steps.sdist.outputs.path }}
+        env:
+          CIBW_ARCHS_LINUX: ${{ matrix.arch }}
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: wheels-linux-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+
+  wheels-macos:
+    name: Build macOS wheels (${{ matrix.arch }})
+    needs: sdist
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        arch: [x86_64, arm64]
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
+        with:
+          name: sdist
+          path: dist
+      - name: Resolve sdist path
+        id: sdist
+        run: echo "path=$(ls dist/*.tar.gz)" >> "$GITHUB_OUTPUT"
+        shell: bash
+      - uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
+        with:
+          package-dir: ${{ steps.sdist.outputs.path }}
+        env:
+          CIBW_ARCHS_MACOS: ${{ matrix.arch }}
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: wheels-macos-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+
+  wheels-windows:
+    name: Build Windows wheels
+    needs: sdist
+    runs-on: windows-latest
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
+        with:
+          name: sdist
+          path: dist
+      - name: Resolve sdist path
+        id: sdist
+        run: echo "path=$(ls dist/*.tar.gz)" >> "$GITHUB_OUTPUT"
+        shell: bash
+      - uses: ilammy/msvc-dev-cmd@0b201ec74fa43914dc39ae48a89fd1d8cb592756  # v1.13.0
+      - uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
+        with:
+          package-dir: ${{ steps.sdist.outputs.path }}
+        env:
+          CIBW_ARCHS_WINDOWS: AMD64
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: wheels-windows-AMD64
+          path: wheelhouse/*.whl
+
+  publish:
+    name: Publish to PyPI
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: [sdist, wheels-linux, wheels-macos, wheels-windows]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      attestations: write
+      contents: read
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # v1.14.0
+        with:
+          attestations: true

pycxxfilt-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,123 @@
+# SPDX-License-Identifier: Apache-2.0
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-package:
+    name: Build & verify package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: hynek/build-and-inspect-python-package@fe0a0fb1925ca263d076ca4f2c13e93a6e92a33e  # v2.17.0
+        with:
+          include-free-threaded: 'false'
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+      - run: uvx ruff check src/ tests/
+      - run: uvx ruff format --check src/ tests/
+      - run: clang-format --dry-run --Werror src/pycxxfilt/_cxxfilt.c
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+      - run: uvx ty check src/
+
+  test-linux:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Build and install
+        run: uv pip install --system ".[test]"
+      - name: Run tests
+        run: python -m pytest tests/ -q
+
+  test-linux-qemu:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        arch: [ppc64le, s390x]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a  # v4.0.0
+        with:
+          platforms: linux/${{ matrix.arch }}
+      - uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
+        env:
+          CIBW_ARCHS_LINUX: ${{ matrix.arch }}
+          CIBW_BUILD: cp314-manylinux*
+          CIBW_TEST_COMMAND: python -m pytest {project}/tests/ -q --ignore={project}/tests/test_demangle.py
+
+  test-macos:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.14"]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Build and install
+        run: uv pip install --system ".[test]"
+      - name: Run tests
+        run: python -m pytest tests/ -q
+
+  test-windows:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.14"]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: ilammy/msvc-dev-cmd@0b201ec74fa43914dc39ae48a89fd1d8cb592756  # v1.13.0
+      - name: Build and install
+        run: uv pip install --system ".[test]"
+      - name: Run tests
+        run: python -m pytest tests/ -q

pycxxfilt-0.1.0/.github/workflows/codeql.yml

@@ -0,0 +1,44 @@
+# SPDX-License-Identifier: Apache-2.0
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    # Weekly on Sundays
+    - cron: "0 3 * * 0"
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  analyze:
+    continue-on-error: true
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [python, c-cpp]
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: github/codeql-action/init@95e58e9a2cdfd71adc6e0353d5c52f41a045d225  # v4.35.2
+        with:
+          languages: ${{ matrix.language }}
+      - if: matrix.language == 'c-cpp'
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: "3.14"
+      - if: matrix.language == 'c-cpp'
+        run: pip install -v .
+      - uses: github/codeql-action/analyze@95e58e9a2cdfd71adc6e0353d5c52f41a045d225  # v4.35.2
+        with:
+          category: "/language:${{ matrix.language }}"

pycxxfilt-0.1.0/.github/workflows/scorecard.yml

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+name: Scorecard
+
+on:
+  push:
+    branches: [main]
+  schedule:
+    # Weekly on Saturdays
+    - cron: "30 1 * * 6"
+
+permissions: {}
+
+jobs:
+  analysis:
+    continue-on-error: true
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a  # v2.4.3
+        with:
+          results_file: results.sarif
+          results_format: sarif
+          publish_results: true
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: SARIF file
+          path: results.sarif
+          retention-days: 5
+      - uses: github/codeql-action/upload-sarif@95e58e9a2cdfd71adc6e0353d5c52f41a045d225  # v4.35.2
+        with:
+          sarif_file: results.sarif

pycxxfilt-0.1.0/.gitignore

@@ -0,0 +1,62 @@
+# Claude Code
+.claude/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+*.dylib
+*.pyd
+
+# Distribution / packaging
+build/
+dist/
+eggs/
+*.egg-info/
+*.egg
+sdist/
+wheels/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Install
+*.install
+
+# Meson
+builddir/
+subprojects/
+
+# C/C++ objects and libraries
+*.o
+*.a
+*.lib
+*.obj
+
+# IDE / editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# pytest
+.pytest_cache/
+
+# Coverage
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+
+# mypy
+.mypy_cache/

pycxxfilt-0.1.0/AGENT.md

@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: Apache-2.0
+
+# Agent instructions
+
+## Setup
+
+Use [uv](https://docs.astral.sh/uv/) to create a venv and install
+dependencies:
+
+```
+uv venv .venv && source .venv/bin/activate
+uv pip install meson-python meson
+uv pip install --no-build-isolation -e ".[test]"
+```
+
+## Testing
+
+Run the test suite with pytest:
+
+```
+python -m pytest tests/ -q
+```
+
+## tox
+
+Use tox for the full CI matrix (lint, typecheck, tests across Python
+versions):
+
+```
+tox run                 # all environments
+tox run -e lint         # ruff check + format check
+tox run -e fix          # ruff auto-fix + format
+tox run -e typecheck    # ty type checker
+tox run -e py314        # tests with specific Python version
+```

pycxxfilt-0.1.0/DEVELOPMENT.md

@@ -0,0 +1,80 @@
+# Development
+
+## Prerequisites
+
+- C++20 compiler (GCC, Clang, or MSVC)
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/)
+
+## Building from source
+
+```
+uv venv .venv && source .venv/bin/activate
+uv pip install meson-python meson
+uv pip install --no-build-isolation -e ".[test]"
+python -m pytest tests/ -q
+```
+
+## tox environments
+
+```
+tox run                 # all test envs + lint + typecheck
+tox run -e lint         # ruff check + format check
+tox run -e fix          # ruff auto-fix + format
+tox run -e typecheck    # ty type checker
+tox run -e py314        # run tests with a specific Python version
+```
+
+## Vendored LLVM sources
+
+The Itanium demangler is vendored from LLVM's libcxxabi, release tag
+**llvmorg-22.1.3**. The following files are copied from the LLVM source
+tree:
+
+| Local path | LLVM source |
+|---|---|
+| `vendor/cxa_demangle.cpp` | `libcxxabi/src/cxa_demangle.cpp` |
+| `vendor/demangle/DemangleConfig.h` | `libcxxabi/src/demangle/DemangleConfig.h` |
+| `vendor/demangle/ItaniumDemangle.h` | `libcxxabi/src/demangle/ItaniumDemangle.h` |
+| `vendor/demangle/ItaniumNodes.def` | `libcxxabi/src/demangle/ItaniumNodes.def` |
+| `vendor/demangle/StringViewExtras.h` | `libcxxabi/src/demangle/StringViewExtras.h` |
+| `vendor/demangle/Utility.h` | `libcxxabi/src/demangle/Utility.h` |
+| `vendor/demangle/README.txt` | `libcxxabi/src/demangle/README.txt` |
+| `vendor/DemangleTestCases.inc` | `libcxxabi/test/DemangleTestCases.inc` |
+| `LICENSE.llvm` | `llvm/LICENSE.TXT` |
+
+The update script patches `cxa_demangle.cpp` and `DemangleConfig.h` to
+wrap all symbols in a `pycxxfilt` namespace.
+
+Two **shim headers** provide the libcxxabi-internal symbols that the
+original code depends on:
+
+- `vendor/abort_message.h` -- replaces `libcxxabi/src/abort_message.h`
+- `vendor/__cxxabi_config.h` -- replaces `libcxxabi/include/__cxxabi_config.h`
+
+These shim files must be maintained manually if the upstream API changes.
+
+### Updating to a newer LLVM release
+
+```
+./update-vendor.sh llvmorg-XX.Y.Z
+```
+
+This downloads all files, applies namespace patches, and records the
+tag.  The shim headers are **not** overwritten.  After updating, verify
+that the shims are still compatible and run the test suite.
+
+## Releasing
+
+1. Update the version in `pyproject.toml` and `meson.build`.
+2. Commit and tag: `git tag v0.1.0`
+3. Push the tag: `git push origin v0.1.0`
+4. The `build.yml` GitHub Actions workflow builds wheels and sdist, then
+   publishes to PyPI via trusted publishing.
+
+PyPI trusted publishing must be configured once:
+
+- Go to PyPI project settings → Publishing → Add a new publisher
+- Repository: `tiran/pycxxfilt`
+- Workflow: `build.yml`
+- Environment: `pypi`