tomlclass 0.1.0__tar.gz

tomlclass-0.1.0/.github/assets/tomlclass-logo.svg

@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2474 620" role="img" aria-labelledby="title">
+  <title id="title">tomlclass</title>
+  <defs>
+    <!-- EP 同款三段渐变：蓝 -> 紫 -> 粉（userSpaceOnUse 垂直方向，
+         字形坐标系 y 翻转后视觉效果为 顶部蓝 -> 中部紫 -> 底部粉） -->
+    <linearGradient id="grad" gradientUnits="userSpaceOnUse" x1="0" y1="1070" x2="0" y2="30">
+      <stop offset="0" stop-color="#F08CBD"/>
+      <stop offset=".38" stop-color="#C9A5EF"/>
+      <stop offset=".62" stop-color="#9CC8F2"/>
+      <stop offset="1" stop-color="#80C8F8"/>
+    </linearGradient>
+  </defs>
+  <g fill="#ffffff" stroke="#ffffff" stroke-width="90" stroke-linejoin="round" stroke-linecap="round">
+    <path transform="translate(36.3,550) scale(0.253906,-0.253906)" d="M808 805Q787 805 758.5 806.5Q730 808 709 808Q668 808 614 800Q632 396 632 272Q632 259 633.0 223.5Q634 188 634 166Q634 -64 489 -64Q434 -64 394 -30Q350 6 350 60Q350 96 353.0 168.0Q356 240 356 276Q356 397 338 794Q276 797 150.5 810.5Q25 824 25 940Q25 996 63.0 1035.0Q101 1074 161 1074Q198 1074 331 1062Q330 1094 326 1168Q322 1232 322 1267Q322 1323 363.0 1360.0Q404 1397 462 1397Q610 1397 610 1148L608 1066Q670 1075 709 1075Q824 1075 866 1060Q946 1032 946 938Q946 881 907.0 843.0Q868 805 808 805Z"/>
+    <path transform="translate(303.8,550) scale(0.253906,-0.253906)" d="M514 -59Q329 -59 196 68Q50 207 43 439Q36 660 164 833Q316 1037 587 1037Q787 1037 905 877Q1011 733 1011 520Q1011 288 887 124Q748 -59 514 -59ZM574 773Q451 774 380 661Q320 566 320 439Q320 319 388 255Q442 204 514 204Q601 204 665 263Q738 332 743 450Q756 772 574 773Z"/>
+    <path transform="translate(605.8,550) scale(0.253906,-0.253906)" d="M361 885Q512 1060 647 1060Q801 1060 873 943Q934 997 1008.0 1024.0Q1082 1051 1168 1051Q1364 1051 1434 856Q1448 816 1477 585Q1505 423 1549 45Q1553 -12 1510.0 -49.0Q1467 -86 1409 -86Q1294 -86 1274 28Q1256 131 1237 319Q1217 525 1204 611Q1177 790 1135 790Q1112 790 1030.0 744.0Q948 698 910 665Q910 551 937 337Q965 118 965 9Q965 -48 926.0 -86.0Q887 -124 827 -124Q767 -124 728.0 -86.0Q689 -48 689 9Q689 123 664.5 344.5Q640 566 640 680Q640 744 629 782Q513 715 396 559Q391 552 379 538Q375 336 375 221Q375 193 373.0 145.5Q371 98 371 75Q371 21 327 -10Q287 -39 228 -39Q143 -39 113 35Q92 85 92 194V566Q92 616 88.0 712.5Q84 809 84 859Q84 948 116 1020Q155 1110 226 1110Q282 1110 326.0 1066.5Q370 1023 370 971Q370 992 361 885Z"/>
+    <path transform="translate(1040.5,550) scale(0.253906,-0.253906)" d="M410 147Q410 -43 272 -43Q212 -43 173.0 -5.0Q134 33 134 93V1476Q134 1534 176 1571Q216 1605 275 1605Q334 1605 372.0 1569.5Q410 1534 410 1476Z"/>
+    <path transform="translate(1176.0,550) scale(0.253906,-0.253906)" d="M562 -63Q342 -63 193 62Q36 194 36 410Q36 609 177 821Q337 1063 549 1063Q653 1063 792 1007Q961 938 961 848Q961 799 927 761Q891 720 834 720Q791 720 730.5 766.5Q670 813 549 813Q472 813 382 662Q296 516 296 410Q296 305 372 245Q444 188 562 188Q629 188 726.0 239.0Q823 290 849 290Q903 290 941.5 251.0Q980 212 980 162Q980 84 810 6Q658 -63 562 -63Z"/>
+    <path transform="translate(1486.0,550) scale(0.253906,-0.253906)" d="M410 147Q410 -43 272 -43Q212 -43 173.0 -5.0Q134 33 134 93V1476Q134 1534 176 1571Q216 1605 275 1605Q334 1605 372.0 1569.5Q410 1534 410 1476Z"/>
+    <path transform="translate(1626.7,550) scale(0.253906,-0.253906)" d="M965 -66Q919 -66 819 34Q727 -10 657.0 -32.5Q587 -55 538 -55Q297 -55 176.5 74.0Q56 203 56 460Q56 701 234.0 872.5Q412 1044 660 1044Q755 1044 880 990Q1031 925 1031 839Q1031 803 1008 776Q998 736 992.5 675.5Q987 615 987 534Q987 343 1014 259Q1017 250 1060 155Q1099 69 1099 57Q1099 4 1058.5 -31.0Q1018 -66 965 -66ZM717 620Q717 652 721.5 693.5Q726 735 735 786Q715 796 699.5 800.5Q684 805 673 805Q537 805 435.0 698.5Q333 592 333 452Q333 318 381.0 250.5Q429 183 525 183Q587 183 642.5 203.5Q698 224 747 264Q717 502 717 620Z"/>
+    <path transform="translate(1932.6,550) scale(0.253906,-0.253906)" d="M806 732Q707 732 687 815Q647 822 605 822Q364 822 364 756Q364 717 509 651Q707 560 777 509Q922 404 922 272Q922 100 762 11Q633 -60 445 -60Q312 -60 202 -19Q52 37 52 146Q52 246 171 246Q217 246 304.0 217.0Q391 188 438 188Q641 188 642 270Q642 321 501 383Q295 474 237 514Q96 613 96 755Q96 956 309 1026Q434 1067 689 1067Q789 1067 837 1041Q903 1006 903 912Q903 732 806 732Z"/>
+    <path transform="translate(2203.7,550) scale(0.253906,-0.253906)" d="M806 732Q707 732 687 815Q647 822 605 822Q364 822 364 756Q364 717 509 651Q707 560 777 509Q922 404 922 272Q922 100 762 11Q633 -60 445 -60Q312 -60 202 -19Q52 37 52 146Q52 246 171 246Q217 246 304.0 217.0Q391 188 438 188Q641 188 642 270Q642 321 501 383Q295 474 237 514Q96 613 96 755Q96 956 309 1026Q434 1067 689 1067Q789 1067 837 1041Q903 1006 903 912Q903 732 806 732Z"/>
+  </g>
+  <g fill="url(#grad)">
+    <path transform="translate(36.3,550) scale(0.253906,-0.253906)" d="M808 805Q787 805 758.5 806.5Q730 808 709 808Q668 808 614 800Q632 396 632 272Q632 259 633.0 223.5Q634 188 634 166Q634 -64 489 -64Q434 -64 394 -30Q350 6 350 60Q350 96 353.0 168.0Q356 240 356 276Q356 397 338 794Q276 797 150.5 810.5Q25 824 25 940Q25 996 63.0 1035.0Q101 1074 161 1074Q198 1074 331 1062Q330 1094 326 1168Q322 1232 322 1267Q322 1323 363.0 1360.0Q404 1397 462 1397Q610 1397 610 1148L608 1066Q670 1075 709 1075Q824 1075 866 1060Q946 1032 946 938Q946 881 907.0 843.0Q868 805 808 805Z"/>
+    <path transform="translate(303.8,550) scale(0.253906,-0.253906)" d="M514 -59Q329 -59 196 68Q50 207 43 439Q36 660 164 833Q316 1037 587 1037Q787 1037 905 877Q1011 733 1011 520Q1011 288 887 124Q748 -59 514 -59ZM574 773Q451 774 380 661Q320 566 320 439Q320 319 388 255Q442 204 514 204Q601 204 665 263Q738 332 743 450Q756 772 574 773Z"/>
+    <path transform="translate(605.8,550) scale(0.253906,-0.253906)" d="M361 885Q512 1060 647 1060Q801 1060 873 943Q934 997 1008.0 1024.0Q1082 1051 1168 1051Q1364 1051 1434 856Q1448 816 1477 585Q1505 423 1549 45Q1553 -12 1510.0 -49.0Q1467 -86 1409 -86Q1294 -86 1274 28Q1256 131 1237 319Q1217 525 1204 611Q1177 790 1135 790Q1112 790 1030.0 744.0Q948 698 910 665Q910 551 937 337Q965 118 965 9Q965 -48 926.0 -86.0Q887 -124 827 -124Q767 -124 728.0 -86.0Q689 -48 689 9Q689 123 664.5 344.5Q640 566 640 680Q640 744 629 782Q513 715 396 559Q391 552 379 538Q375 336 375 221Q375 193 373.0 145.5Q371 98 371 75Q371 21 327 -10Q287 -39 228 -39Q143 -39 113 35Q92 85 92 194V566Q92 616 88.0 712.5Q84 809 84 859Q84 948 116 1020Q155 1110 226 1110Q282 1110 326.0 1066.5Q370 1023 370 971Q370 992 361 885Z"/>
+    <path transform="translate(1040.5,550) scale(0.253906,-0.253906)" d="M410 147Q410 -43 272 -43Q212 -43 173.0 -5.0Q134 33 134 93V1476Q134 1534 176 1571Q216 1605 275 1605Q334 1605 372.0 1569.5Q410 1534 410 1476Z"/>
+    <path transform="translate(1176.0,550) scale(0.253906,-0.253906)" d="M562 -63Q342 -63 193 62Q36 194 36 410Q36 609 177 821Q337 1063 549 1063Q653 1063 792 1007Q961 938 961 848Q961 799 927 761Q891 720 834 720Q791 720 730.5 766.5Q670 813 549 813Q472 813 382 662Q296 516 296 410Q296 305 372 245Q444 188 562 188Q629 188 726.0 239.0Q823 290 849 290Q903 290 941.5 251.0Q980 212 980 162Q980 84 810 6Q658 -63 562 -63Z"/>
+    <path transform="translate(1486.0,550) scale(0.253906,-0.253906)" d="M410 147Q410 -43 272 -43Q212 -43 173.0 -5.0Q134 33 134 93V1476Q134 1534 176 1571Q216 1605 275 1605Q334 1605 372.0 1569.5Q410 1534 410 1476Z"/>
+    <path transform="translate(1626.7,550) scale(0.253906,-0.253906)" d="M965 -66Q919 -66 819 34Q727 -10 657.0 -32.5Q587 -55 538 -55Q297 -55 176.5 74.0Q56 203 56 460Q56 701 234.0 872.5Q412 1044 660 1044Q755 1044 880 990Q1031 925 1031 839Q1031 803 1008 776Q998 736 992.5 675.5Q987 615 987 534Q987 343 1014 259Q1017 250 1060 155Q1099 69 1099 57Q1099 4 1058.5 -31.0Q1018 -66 965 -66ZM717 620Q717 652 721.5 693.5Q726 735 735 786Q715 796 699.5 800.5Q684 805 673 805Q537 805 435.0 698.5Q333 592 333 452Q333 318 381.0 250.5Q429 183 525 183Q587 183 642.5 203.5Q698 224 747 264Q717 502 717 620Z"/>
+    <path transform="translate(1932.6,550) scale(0.253906,-0.253906)" d="M806 732Q707 732 687 815Q647 822 605 822Q364 822 364 756Q364 717 509 651Q707 560 777 509Q922 404 922 272Q922 100 762 11Q633 -60 445 -60Q312 -60 202 -19Q52 37 52 146Q52 246 171 246Q217 246 304.0 217.0Q391 188 438 188Q641 188 642 270Q642 321 501 383Q295 474 237 514Q96 613 96 755Q96 956 309 1026Q434 1067 689 1067Q789 1067 837 1041Q903 1006 903 912Q903 732 806 732Z"/>
+    <path transform="translate(2203.7,550) scale(0.253906,-0.253906)" d="M806 732Q707 732 687 815Q647 822 605 822Q364 822 364 756Q364 717 509 651Q707 560 777 509Q922 404 922 272Q922 100 762 11Q633 -60 445 -60Q312 -60 202 -19Q52 37 52 146Q52 246 171 246Q217 246 304.0 217.0Q391 188 438 188Q641 188 642 270Q642 321 501 383Q295 474 237 514Q96 613 96 755Q96 956 309 1026Q434 1067 689 1067Q789 1067 837 1041Q903 1006 903 912Q903 732 806 732Z"/>
+  </g>
+</svg>

tomlclass-0.1.0/.github/workflows/code-quality-check.yml

@@ -0,0 +1,298 @@
+name: 🧪 tomlclass Test Check
+
+permissions:
+  contents: read
+  pull-requests: write
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  ruff-check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Generate App Token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.TOMLCLASS_BOT_APP_ID }}
+          private-key: ${{ secrets.TOMLCLASS_BOT_PRIVATE_KEY }}
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --extra lint
+
+      - name: Run ruff check
+        id: ruff-check
+        run: |
+          echo "Running Ruff code check..."
+          ruff_output=$(uv run ruff check src/ tests/ 2>&1; echo "RUFF_EXIT_CODE=$?")
+          exit_code=${ruff_output##*RUFF_EXIT_CODE=}
+          ruff_output=${ruff_output%RUFF_EXIT_CODE=*}
+
+          echo "RUFF_OUTPUT<<EOF" >> $GITHUB_ENV
+          echo "$ruff_output" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+          if [ "$exit_code" -ne 0 ]; then
+            echo "has_ruff_issues=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_ruff_issues=false" >> $GITHUB_OUTPUT
+          fi
+
+          # Blocking gate: failure fails the job (comment posted in the next step)
+          exit $exit_code
+
+      - name: Post Ruff check results to PR
+        if: always() && steps.ruff-check.outputs.has_ruff_issues == 'true' && github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ steps.app-token.outputs.token }}
+          script: |
+            const botName = '${{ steps.app-token.outputs.app-slug }}[bot]';
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number
+            });
+
+            const botComment = comments.find(comment =>
+              comment.user.login === botName &&
+              comment.body.includes('Ruff Code Check')
+            );
+
+            const message = `## Ruff Code Check Results
+
+            > Blocking check: merge is blocked until the issues below are fixed
+
+            ```
+            ${process.env.RUFF_OUTPUT}
+            ```
+            `;
+
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: message
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                body: message
+              });
+            }
+
+  pytest-check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - name: Generate App Token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.TOMLCLASS_BOT_APP_ID }}
+          private-key: ${{ secrets.TOMLCLASS_BOT_PRIVATE_KEY }}
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install project dependencies
+        run: uv sync --extra test
+
+      - name: Run tests
+        id: pytest-check
+        run: |
+          echo "Running Pytest tests..."
+          pytest_output=$(uv run pytest tests/unit -p no:cacheprovider -n auto --tb=short -q --no-cov 2>&1; echo "PYTEST_EXIT_CODE=$?")
+          exit_code=${pytest_output##*PYTEST_EXIT_CODE=}
+          pytest_output=${pytest_output%PYTEST_EXIT_CODE=*}
+          echo "$pytest_output"
+
+          echo "PYTEST_OUTPUT<<EOF" >> $GITHUB_ENV
+          echo "$pytest_output" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+          if [ "$exit_code" -ne 0 ]; then
+            echo "has_errors=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_errors=false" >> $GITHUB_OUTPUT
+          fi
+
+          if [ "$exit_code" -ne 0 ]; then
+            exit 1
+          fi
+
+      - name: Post test success to PR
+        if: always() && steps.pytest-check.outputs.has_errors != 'true' && github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ steps.app-token.outputs.token }}
+          script: |
+            const botName = '${{ steps.app-token.outputs.app-slug }}[bot]';
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number
+            });
+
+            const botComment = comments.find(comment =>
+              comment.user.login === botName &&
+              (comment.body.includes('Test Results') || comment.body.includes('Test Passed'))
+            );
+
+            const message = `## Test Passed
+
+            All tests completed successfully.
+            `;
+
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: message
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                body: message
+              });
+            }
+
+      - name: Post test results to PR
+        if: always() && steps.pytest-check.outputs.has_errors == 'true' && github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ steps.app-token.outputs.token }}
+          script: |
+            const botName = '${{ steps.app-token.outputs.app-slug }}[bot]';
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number
+            });
+
+            const botComment = comments.find(comment =>
+              comment.user.login === botName &&
+              (comment.body.includes('Test Results') || comment.body.includes('Test Passed'))
+            );
+
+            const output = process.env.PYTEST_OUTPUT || '';
+            const lines = output.split('\n');
+            const MAX_LINES = 50;
+            const truncated = lines.length > MAX_LINES;
+            const displayLines = truncated ? lines.slice(-MAX_LINES) : lines;
+            const displayOutput = displayLines.join('\n');
+
+            const runUrl = `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`;
+
+            let message;
+            if (truncated) {
+              message = `## Tests failed — merge blocked
+
+            > Output truncated to last ${MAX_LINES} lines (total: ${lines.length} lines)
+            > [View full output in Actions](${runUrl})
+
+            \`\`\`
+            ... (top ${lines.length - MAX_LINES} lines omitted)
+            ${displayOutput}
+            \`\`\`
+            `;
+            } else {
+              message = `## Tests failed — merge blocked
+
+            \`\`\`
+            ${displayOutput}
+            \`\`\`
+            `;
+            }
+
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: message
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                body: message
+              });
+            }
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage.xml
+          if-no-files-found: ignore
+
+  typecheck:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run basedpyright type check
+        run: uv run basedpyright src/tomlclass
+
+  security-audit:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Run pip-audit on locked dependencies
+        run: |
+          uv export --format requirements-txt --no-hashes --no-emit-project -o requirements-audit.txt
+          uvx pip-audit -r requirements-audit.txt --strict

tomlclass-0.1.0/.github/workflows/python-publish.yml

@@ -0,0 +1,71 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      # url: https://pypi.org/p/YOURPROJECT
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

tomlclass-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# uv
+# (uv.lock intentionally NOT committed — see ErisPulse project precedent)
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store
+Thumbs.db
+
+# uv.lock intentionally NOT committed (ErisPulse project precedent)
+uv.lock

tomlclass-0.1.0/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## Format
+
+- Entry format: `## [x.y.z] - YYYY/MM/DD`, grouped by type (Added / Changed / Fixed / Breaking), with the contributor marked as `@GithubUsername`
+- Multiple changes to the same topic are folded into their existing entry as the final state; no iterative "later fixed / no longer..." entries
+- Changes introduced and reverted within the same version are not listed separately
+- Test-only additions and internal tweaks without user impact are omitted
+- The summary states the version theme and the 1-3 largest changes; upgrade notes give only conclusions and actions
+
+## [0.1.0] - 2026/10/04
+
+Initial release: engine, semantics and annotation layers.
+
+**Summary**
+
+tomlclass 0.1.0 provides a lossless TOML 1.0 engine and an annotation-based config layer. `parse -> edit -> dumps` round-trips byte-for-byte (the full toml-test 1.0 suite passes: 208 valid, 501 invalid). `Config` classes declare the schema and produce commented templates with aggregated validation. Parsing measures within 2x of tomli and 5.8-6.4x faster than tomlkit 0.15.1 on the same machine; `dumps` on an unedited document is approximately O(1). Zero third-party dependencies.
+
+**Upgrade notes**
+
+- First release; no upgrade path.
+
+### Added
+
+- @wsu2059q
+  - Engine: single-pass character-dispatch parsing (precompiled regex block matching, no per-character loops), source-slice rendering, and a two-tier node model that materializes style data only on edit. Editing APIs (value changes, key/table creation, deletion, AoT append and whole replacement) preserve comments, ordering and formatting byte-for-byte. Untouched array `append` splices into the source, keeping existing elements and their comments intact. Atomic writes via tempfile + `os.replace`.
+  - Error hierarchy: `TOMLError` base; `TOMLParseError` subclasses `ValueError` (matching `tomllib.TOMLDecodeError`) with `line` / `col` / `offset` / `segment`; `TOMLTypeError` subclasses `TypeError` and is raised when a value cannot be represented in TOML (`None`, functions, arbitrary objects).
+  - Semantics: diff-based write-back (only changed keys are written), defaults merged in memory and never persisted, unknown keys preserved (`strict=True` rejects them, propagated through nested tables and unions), env overrides via `PREFIX__PATH` with best-effort type conversion, `None` on an Optional field deletes the key on save while `None` on a non-optional field raises `ConfigError`.
+  - Annotation layer: `Config` / `Field` (nested classes as tables, docstring field sections as comments, `Literal` and numeric/length/pattern constraints, `coerce`), `template()` (byte-stable per schema), `validate_dict()` (aggregates all errors), `load()` (env prefix, `strict`, `comments` injection modes `none` / `missing` / `all`), `save()`, `watch()` (optional dependency watchfiles, `stop_event` supported), `migrate()` with `_migrate_key_map`.
+  - Comment API: `Document.comment()` / `set_comment()` per key (comments are anchored to their key; replacement keeps the original leading whitespace, removal strips it), `to_dict()` builds a plain dict directly from the document, `find()` dotted-path lookup.
+  - tomllib compatibility: `loads(text) -> dict` and `load(binary_fp) -> dict` follow the stdlib calling convention; `parse(text)` / `load(path) -> Document` keeps the lossless editing form.
+  - Multi-line string rendering uses triple quotes with the opener alone on its first line; `'''` is used when the content conflicts with `"""` and needs no escapes.
+  - Performance: parse within 2x of tomli (1.73x / 1.94x on two public benchmark corpora, same machine), 5.8-6.4x faster than tomlkit 0.15.1, unedited `dumps` approximately O(1), resident memory 0.67x tomlkit. Budgets are enforced in CI; baseline recorded in `tests/bench/BASELINE.md`.
+  - Tests: the full toml-test 1.0 manifest (208 valid with semantic comparison plus byte-exact round-trip, 501 invalid rejected), round-trip axiom, style matrix, edit-semantics and schema-semantics tables; 765 tests total.