fatcat-metadata 0.1.0__tar.gz

fatcat_metadata-0.1.0/.gitattributes

@@ -0,0 +1,9 @@
+# Keep text files consistent across platforms; leave binary files untouched.
+* text=auto eol=lf
+
+# These upstream snapshots are verified against their original byte hashes.
+licenses/third-party/** -text !eol whitespace=cr-at-eol
+compatibility/current-src/native-project-sources/profiles/** -text !eol
+
+# Keep the root license in the standard LF text form.
+/LICENSE text eol=lf

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

@@ -0,0 +1,97 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  python-extension:
+    name: Python extension (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install --upgrade pip
+      - name: Build wheel
+        run: python -m pip wheel . --no-deps --wheel-dir dist
+        env:
+          MACOSX_DEPLOYMENT_TARGET: "14.0"
+      - name: Install the built wheel
+        run: python -m pip install --no-index --find-links dist fatcat-metadata
+      - run: python "${{ github.workspace }}/scripts/check_installed_package.py"
+        working-directory: ${{ runner.temp }}
+      - run: python -m unittest discover -s "${{ github.workspace }}/cpp/tests" -p "test_*.py" -v
+        working-directory: ${{ runner.temp }}
+      - name: Save the verified wheel
+        uses: actions/upload-artifact@v7
+        with:
+          name: fatcat-metadata-${{ runner.os }}-${{ runner.arch }}-cp${{ matrix.python-version }}
+          path: dist/*.whl
+          if-no-files-found: error
+          retention-days: 30
+          compression-level: 0
+
+  cpp:
+    name: C++ ${{ matrix.build_type }} (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        build_type: [Debug, Release]
+    steps:
+      - uses: actions/checkout@v7
+      - run: cmake -S cpp -B build -DFATCAT_BUILD_PYTHON=OFF -DFATCAT_BUILD_TESTS=ON -DFATCAT_INSTALL_CPP=ON -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
+      - run: cmake --build build --config ${{ matrix.build_type }} --parallel 2
+      - run: ctest --test-dir build --output-on-failure -C ${{ matrix.build_type }}
+      - run: cmake --install build --config ${{ matrix.build_type }} --prefix "${{ runner.temp }}/fatcat-sdk"
+      - run: cmake -S cpp/examples/out_of_tree_consumer -B build-installed-consumer -DFATCAT_CONSUME_INSTALLED=ON -DCMAKE_PREFIX_PATH="${{ runner.temp }}/fatcat-sdk" -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
+      - run: cmake --build build-installed-consumer --config ${{ matrix.build_type }} --parallel 2
+      - run: ctest --test-dir build-installed-consumer --output-on-failure -C ${{ matrix.build_type }} --no-tests=error
+
+  cpp-non-c-locale:
+    name: C++ comma-decimal locale (Linux)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      # GitHub's Ubuntu image includes locales; generate the required data offline.
+      - run: sudo locale-gen de_DE.UTF-8
+      - run: locale -a
+      - run: cmake -S cpp -B build-locale -DFATCAT_BUILD_PYTHON=OFF -DFATCAT_BUILD_TESTS=ON -DFATCAT_TEST_NON_C_LOCALE=ON -DCMAKE_BUILD_TYPE=Release
+      - run: cmake --build build-locale --parallel 2
+      - run: ctest --test-dir build-locale --output-on-failure --no-tests=error -R '^fatcat_locale_test_non_c$'
+
+  out-of-tree-consumer:
+    name: Out-of-tree C++ consumer
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - run: cmake -S cpp/examples/out_of_tree_consumer -B build/consumer -DCMAKE_BUILD_TYPE=Release
+      - run: cmake --build build/consumer --parallel 2
+      - run: ./build/consumer/fatcat_metadata_out_of_tree_consumer
+
+  neroued-3mf:
+    name: Neroued 3MF integration
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install . "neroued-3mf==0.4.0"
+      - run: python cpp/examples/python_neroued_consumer/write_example.py --output "$RUNNER_TEMP/fatcat-consumer-example.3mf"
+      - run: python cpp/examples/python_neroued_consumer/verify_3mf.py "$RUNNER_TEMP/fatcat-consumer-example.3mf"
+      - run: python cpp/examples/python_neroued_consumer/minimal.py --output "$RUNNER_TEMP/fatcat-minimal-example.3mf"
+      - run: python cpp/examples/python_neroued_consumer/verify_3mf.py "$RUNNER_TEMP/fatcat-minimal-example.3mf"

fatcat_metadata-0.1.0/.github/workflows/distributions.yml

@@ -0,0 +1,175 @@
+name: Distributions
+
+# Building stays separate from the one job allowed to publish.
+on:
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: Publish the complete Python release to PyPI (main only)
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+concurrency:
+  group: distributions-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  wheels:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            arch: x86_64
+          - os: macos-latest
+            arch: arm64
+          - os: windows-latest
+            arch: AMD64
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - run: python -m pip install cibuildwheel==4.3.1
+      - run: python -m cibuildwheel --output-dir "${{ runner.temp }}/wheelhouse"
+        env:
+          CIBW_BUILD: cp312-* cp313-* cp314-*
+          CIBW_SKIP: '*musllinux*'
+          CIBW_ARCHS: ${{ matrix.arch }}
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+          CIBW_ENVIRONMENT: 'FATCAT_BUILD_REVISION=${{ github.sha }} FATCAT_BUILD_DIRTY=0 MACOSX_DEPLOYMENT_TARGET=14.0'
+          CIBW_TEST_COMMAND: 'python "{project}/scripts/check_installed_package.py" && python -m fatcat_metadata_cli --version'
+      - run: python scripts/package_distribution.py --dist-dir "${{ runner.temp }}/wheelhouse" --output-dir "${{ runner.temp }}/prepared-wheels"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: fatcat-wheels-${{ runner.os }}-${{ matrix.arch }}-${{ github.sha }}
+          path: ${{ runner.temp }}/prepared-wheels/
+          if-no-files-found: error
+          retention-days: 90
+          compression-level: 0
+
+  source:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - run: python -m pip install build twine
+      - run: python -m build --sdist --outdir "${{ runner.temp }}/source"
+      - name: Build and install from the source distribution
+        run: |
+          python -m pip wheel "${{ runner.temp }}"/source/*.tar.gz --no-deps --wheel-dir "${{ runner.temp }}/source-wheel"
+          python -m pip install --no-index --find-links "${{ runner.temp }}/source-wheel" fatcat-metadata
+        env:
+          FATCAT_BUILD_REVISION: ${{ github.sha }}
+          FATCAT_BUILD_DIRTY: "0"
+      - run: python "${{ github.workspace }}/scripts/check_installed_package.py"
+        working-directory: ${{ runner.temp }}
+      - run: python -m fatcat_metadata_cli --version
+        working-directory: ${{ runner.temp }}
+      - run: python scripts/package_distribution.py --dist-dir "${{ runner.temp }}/source" --output-dir "${{ runner.temp }}/prepared-source"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: fatcat-source-${{ github.sha }}
+          path: ${{ runner.temp }}/prepared-source/
+          if-no-files-found: error
+          retention-days: 90
+          compression-level: 0
+
+  python-release:
+    needs: [wheels, source]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: fatcat-wheels-*
+          path: ${{ runner.temp }}/prepared/wheels
+      - uses: actions/download-artifact@v8
+        with:
+          name: fatcat-source-${{ github.sha }}
+          path: ${{ runner.temp }}/prepared/source
+      - name: Collect the complete Python release
+        working-directory: ${{ runner.temp }}
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+          import shutil
+
+          wheels = sorted(Path("prepared/wheels").rglob("*.whl"))
+          sources = sorted(Path("prepared/source").glob("*.tar.gz"))
+          if len(wheels) != 9 or len(sources) != 1:
+              raise SystemExit("Expected nine platform/Python wheels and one source distribution")
+          Path("dist").mkdir()
+          for artifact in wheels + sources:
+              shutil.copy2(artifact, Path("dist") / artifact.name)
+          PY
+          python "${{ github.workspace }}/scripts/package_distribution.py" --dist-dir dist --output-dir release
+          python -m pip install twine
+          python -m twine check --strict release/*.whl release/*.tar.gz
+      - uses: actions/upload-artifact@v7
+        with:
+          name: fatcat-python-release-${{ github.sha }}
+          path: ${{ runner.temp }}/release/
+          if-no-files-found: error
+          retention-days: 90
+          compression-level: 0
+
+  pypi:
+    if: inputs.publish && github.ref == 'refs/heads/main'
+    needs: python-release
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/fatcat-metadata
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: fatcat-python-release-${{ github.sha }}
+          path: release
+      - name: Stage only uploadable Python distributions
+        run: |
+          mkdir dist
+          cp release/*.whl release/*.tar.gz dist/
+      - name: Publish the prepared distributions with PyPI Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          packages-dir: dist/
+
+  sdk:
+    if: '!inputs.publish'
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - run: cmake -S cpp -B build -DFATCAT_BUILD_PYTHON=OFF -DFATCAT_BUILD_TESTS=OFF -DFATCAT_INSTALL_CPP=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_DEPLOYMENT_TARGET=13.3
+      - run: cmake --build build --config Release --parallel 2
+      - run: cmake --install build --config Release --prefix "${{ runner.temp }}/fatcat-sdk"
+      - run: python scripts/package_distribution.py --sdk-prefix "${{ runner.temp }}/fatcat-sdk" --output-dir "${{ runner.temp }}/prepared-sdk"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: fatcat-sdk-${{ runner.os }}-${{ runner.arch }}-${{ github.sha }}
+          path: ${{ runner.temp }}/prepared-sdk/
+          retention-days: 90

fatcat_metadata-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Python bytecode and local environments
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+venv/
+env/
+.env
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+
+# Build and package output
+build/
+build-*/
+dist/
+*.egg-info/
+*.whl
+*.tar.gz
+
+# Native build products
+*.o
+*.obj
+*.a
+*.lib
+*.so
+*.dylib
+*.dll
+*.pyd
+
+# Generated example archives and editor/OS state
+*.3mf
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

fatcat_metadata-0.1.0/COPYRIGHT.md

@@ -0,0 +1,15 @@
+# Copyright and licensing
+
+Unless an individual file says otherwise, original Fat Cat source code in this
+repository is licensed under the GNU Affero General Public License, version 3
+only (AGPL-3.0-only). Copyright remains with the applicable author or authors.
+
+The copyright holder of original Fat Cat code may separately offer commercial
+terms for code they own. That option does not cover third-party profile data,
+other upstream works, or the Neroued project. Contact the project maintainer on
+the hosting platform for inquiries to be forwarded to the relevant copyright
+holder.
+
+This notice does not assert that a contributor license agreement or copyright
+assignment exists. Contributions remain subject to the repository's
+AGPL-3.0-only terms unless the parties make a separate written agreement.