px-idle 0.1.0__tar.gz

px_idle-0.1.0/.github/workflows/validation.yml

@@ -0,0 +1,91 @@
+name: Artifact and real IDLE validation
+on: [push, pull_request, workflow_dispatch]
+jobs:
+  modern:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        python: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y python3-tk xvfb
+      - run: python -m pip install build twine
+      - run: python -m build
+      - run: python scripts/inspect_artifacts.py
+      - run: python -m twine check dist/*
+      - if: runner.os != 'Linux'
+        run: python scripts/validate_artifact.py --artifact dist/px_idle-0.1.0-py3-none-any.whl --output docs/results/ci-wheel.json
+      - if: runner.os == 'Linux'
+        run: xvfb-run -a python scripts/validate_artifact.py --artifact dist/px_idle-0.1.0-py3-none-any.whl --output docs/results/ci-wheel.json
+      - if: runner.os != 'Linux'
+        run: python scripts/validate_artifact.py --artifact dist/px_idle-0.1.0.tar.gz --output docs/results/ci-sdist.json
+      - if: runner.os == 'Linux'
+        run: xvfb-run -a python scripts/validate_artifact.py --artifact dist/px_idle-0.1.0.tar.gz --output docs/results/ci-sdist.json
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: evidence-${{ matrix.os }}-${{ matrix.python }}
+          path: docs/results/
+  prerelease:
+    continue-on-error: true
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.15-dev'
+          allow-prereleases: true
+      - run: python -m pip install build
+      - run: python -m build
+      - run: python scripts/validate_artifact.py --artifact dist/px_idle-0.1.0-py3-none-any.whl --output docs/results/ci-prerelease.json
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: prerelease-evidence
+          path: docs/results/
+  legacy:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.3.5', '3.4.4', '3.6.8', '3.7.9', '3.8.10']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.13'
+      - run: python -m pip install build
+      - run: python -m build
+      - run: python -m pip download --no-deps --dest .runtimes/legacy-tools pip==9.0.3 setuptools==39.2.0 wheel==0.29.0
+      - shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force .runtimes/wix | Out-Null
+          Invoke-WebRequest https://github.com/wixtoolset/wix3/releases/download/wix3141rtm/wix314-binaries.zip -OutFile .runtimes/wix/wix.zip
+          Expand-Archive .runtimes/wix/wix.zip .runtimes/wix -Force
+          ./scripts/obtain_windows_runtime.ps1 -Version '${{ matrix.python }}'
+      - run: python scripts/validate_artifact.py --python .runtimes/${{ matrix.python }}/python/python.exe --artifact dist/px_idle-0.1.0-py3-none-any.whl --output docs/results/ci-legacy-wheel.json
+      - run: python scripts/validate_artifact.py --python .runtimes/${{ matrix.python }}/python/python.exe --artifact dist/px_idle-0.1.0.tar.gz --output docs/results/ci-legacy-sdist.json
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: legacy-${{ matrix.python }}
+          path: docs/results/
+  fidelity:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.13'
+      - run: git clone https://github.com/mcc-exam/src.git upstream
+      - run: git -C upstream checkout a44c65dee9eadf37310a54bcbc90fe78df2289f3
+      - run: python -m pip install .
+      - run: python -m unittest discover -s tests -p test_core.py -v
+      - run: python scripts/import_practicals.py upstream --output regenerated
+      - run: diff -r src/px_idle/practicals regenerated

px_idle-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+px-idle local-use license
+
+Copyright (c) 2026 the project owner. All rights reserved.
+
+The project owner authorizes distribution of this package through PyPI and
+TestPyPI. Recipients may download, install, and use px-idle locally, including
+inserting, editing, and executing its bundled practical code for local use.
+No permission is granted to recipients to redistribute, republish, sublicense,
+or repackage the extension or bundled practical content. All other rights are
+reserved by the project owner.
+
+The project owner confirmed ownership of mcc-exam/src and selected
+"Keep all rights reserved; local use only" and authorized PyPI publication on
+2026-10-07. These terms retain that local-use restriction while permitting the
+owner's requested public package distribution.
+This notice does not alter the licenses of Python or other separately installed
+software, which are not bundled in this distribution.

px_idle-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE NOTICE README.md
+recursive-include scripts *.py *.ps1 *.sh
+recursive-include docs *.md *.json
+include research/idle-source-matrix.json
+recursive-include tests *.py
+recursive-include .github *.yml

px_idle-0.1.0/NOTICE

@@ -0,0 +1,10 @@
+Practical source is taken verbatim (UTF-8 and LF normalization only) from
+https://github.com/mcc-exam/src.git
+commit a44c65dee9eadf37310a54bcbc90fe78df2289f3.
+
+The upstream snapshot contains no license file. The project owner confirmed
+ownership and selected all rights reserved, local use only on 2026-10-07.
+The LICENSE in this distribution records that local-use restriction for both
+the extension and bundled practicals. No practical code is executed by px-idle.
+The owner subsequently authorized PyPI publication; recipients' redistribution
+rights remain reserved.

px_idle-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: px-idle
+Version: 0.1.0
+Summary: Offline keyword-driven practical-code expansion for Python IDLE Editors
+License-Expression: LicenseRef-PxIdle-Local-Use
+Project-URL: Practical Source, https://github.com/mcc-exam/src
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Other Environment
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
+Requires-Python: !=3.5.4,>=3.3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Dynamic: license-file
+
+# px-idle
+
+Offline practical-code expansion inside normal Python IDLE Editor windows.
+Type `#>` on a dedicated comment line to discover the complete catalogue, or
+`#>spell` to filter it. Up/Down navigate, Enter or Tab insert, Escape dismisses.
+The exact bundled source replaces the active trigger directly in the Text buffer
+as one undo operation. Each editor has an independent popup. Shell is excluded.
+
+## Local installation
+
+The owner of this project and the upstream practical repository selected all
+rights reserved, local use only, and authorized distribution through PyPI.
+Recipients may install and use the package locally; redistribution rights are
+reserved. See LICENSE. Publication awaits configured account access and
+TestPyPI verification. Until then, install the local wheel:
+
+```
+python -m pip install dist/px_idle-0.1.0-py3-none-any.whl
+px-idle install
+```
+
+Use the same Python installation to launch IDLE. Restart IDLE after registration.
+Registration is explicit; pip installation never modifies your IDLE settings.
+
+`px-idle status` reports registration. `px-idle doctor` checks Python, Tk, IDLE,
+shim import and all bundled source hashes. `px-idle uninstall` removes only
+PxIdle configuration sections; it leaves the Python package installed.
+Use `--config-dir DIRECTORY` for an isolated test configuration. Existing
+configuration is backed up before mutation and written atomically; malformed
+configuration is backed up and left unchanged.
+
+## Source and offline behavior
+
+13 source entries from [mcc-exam/src](https://github.com/mcc-exam/src), snapshot
+`a44c65dee9eadf37310a54bcbc90fe78df2289f3`, are bundled. See
+[the audit](docs/engineering-research.md) and generated registry for mappings,
+aliases, imports and resource requirements. No git, internet, clipboard or
+third-party runtime packages are required for expansion. px-idle never executes
+practicals. Their own execution may require matplotlib, numpy, networkx,
+requests/beautifulsoup4, scikit-learn, nltk or NLTK punkt_tab data; the crawler
+itself uses the internet. These dependencies are not installed by px-idle.
+
+## Compatibility and limitations
+
+Requires-Python is `>=3.3,!=3.5.4`, based on actual Python 3.3.5 installation
+and IDLE tests. Runtime syntax deliberately avoids post-3.3 features. Source research
+covers 2.7 and every 3.0–3.15 generation; it does not prove runtime compatibility.
+See `research/idle-source-matrix.json` for primary-source evidence.
+Exact executed Windows environments are listed below. Every passing row includes
+wheel installation, CLI lifecycle, the actual IDLE loader and Editor, popup
+controls, source insertion, undo, repeat expansion, real Shell exclusion,
+multiple editors and safe uninstall. Full artifact results, including sdist
+tests and Linux evidence, are in [the matrix](docs/compatibility-matrix.md) and
+its machine-readable JSON. Metadata's minimum does not assert that untested
+patch releases or operating systems have passed.
+
+| Python on Windows 11 | Tk | Result / tier |
+| --- | --- | --- |
+| 3.3.5 | 8.5.11 | Passed / legacy |
+| 3.4.4 | 8.6.1 | Passed / legacy |
+| 3.5.4 | 8.6.4 | Unsupported: native IDLE undo segfault, also without px-idle |
+| 3.6.8 | 8.6.6 | Passed / legacy |
+| 3.7.9 | 8.6.9 | Passed / legacy |
+| 3.8.10 | 8.6.9 | Passed / extended |
+| 3.9.13 | 8.6.12 | Passed / extended |
+| 3.10.11 | 8.6.12 | Passed / primary |
+| 3.11.9 | 8.6.12 | Passed / primary |
+| 3.12.10 | 8.6.15 | Passed / primary |
+| 3.13.14 | 8.6.15 | Passed / primary |
+| 3.14.8 | 9.0.4 | Passed / primary |
+| 3.15.0rc3 | 9.0.4 | Passed / experimental prerelease |
+
+Python 2.7 and 3.0–3.2 are unsupported. macOS and CPython main have no executed
+runtime evidence here. Configured CI jobs do not count as observed passes.
+Linux tests use Ubuntu WSL with WSLg or isolated Xvfb (recorded per run), with
+distro Python 3.14.4/Tk 8.6.17 and
+portable Python 3.11.17, 3.12.15, 3.13.16, 3.14.8 and 3.15.0rc3/Tk 9.0.4.
+The portable Linux Python 3.10.22/Tk 9.0.4 build fails native IDLE startup even
+with px-idle unregistered and is unsupported. Consult the matrix for each
+artifact result; a Python version alone does not identify a tested Tk environment.
+Old pip installation uses a small setup.py fallback justified by an actual
+pip 9 sdist failure. Build tooling runs on modern Python; runtime has no external
+dependencies. A tested local wheel is the legacy fallback. See
+[publication status](docs/testpypi.md).
+
+Triggers activate only on a line containing optional whitespace and `#>query`.
+Normal comments and inline strings do not activate. Existing IDLE STRING tags
+suppress multiline string triggers; delayed coloring is a known limitation to
+be checked in GUI tests. Companion files require a saved primary file with the
+matching original filename. Existing meaningful content is never overwritten.
+The current catalogue has no companion files. Source fidelity takes priority
+over modernization: practical syntax may require a newer Python than expansion.
+
+## Development
+
+Fetch the authoritative repository into `upstream/` and run
+`python scripts/import_practicals.py upstream`. The importer reads data and ASTs,
+never imports or runs repository scripts. Run `python -m unittest discover -s tests`.
+Build using `python -m build`, inspect with `python -m twine check dist/*`, then
+test each built artifact in a clean environment. Public upload must follow
+TestPyPI validation first. Unexecuted CI jobs are never recorded as passes.

px_idle-0.1.0/README.md

@@ -0,0 +1,101 @@
+# px-idle
+
+Offline practical-code expansion inside normal Python IDLE Editor windows.
+Type `#>` on a dedicated comment line to discover the complete catalogue, or
+`#>spell` to filter it. Up/Down navigate, Enter or Tab insert, Escape dismisses.
+The exact bundled source replaces the active trigger directly in the Text buffer
+as one undo operation. Each editor has an independent popup. Shell is excluded.
+
+## Local installation
+
+The owner of this project and the upstream practical repository selected all
+rights reserved, local use only, and authorized distribution through PyPI.
+Recipients may install and use the package locally; redistribution rights are
+reserved. See LICENSE. Publication awaits configured account access and
+TestPyPI verification. Until then, install the local wheel:
+
+```
+python -m pip install dist/px_idle-0.1.0-py3-none-any.whl
+px-idle install
+```
+
+Use the same Python installation to launch IDLE. Restart IDLE after registration.
+Registration is explicit; pip installation never modifies your IDLE settings.
+
+`px-idle status` reports registration. `px-idle doctor` checks Python, Tk, IDLE,
+shim import and all bundled source hashes. `px-idle uninstall` removes only
+PxIdle configuration sections; it leaves the Python package installed.
+Use `--config-dir DIRECTORY` for an isolated test configuration. Existing
+configuration is backed up before mutation and written atomically; malformed
+configuration is backed up and left unchanged.
+
+## Source and offline behavior
+
+13 source entries from [mcc-exam/src](https://github.com/mcc-exam/src), snapshot
+`a44c65dee9eadf37310a54bcbc90fe78df2289f3`, are bundled. See
+[the audit](docs/engineering-research.md) and generated registry for mappings,
+aliases, imports and resource requirements. No git, internet, clipboard or
+third-party runtime packages are required for expansion. px-idle never executes
+practicals. Their own execution may require matplotlib, numpy, networkx,
+requests/beautifulsoup4, scikit-learn, nltk or NLTK punkt_tab data; the crawler
+itself uses the internet. These dependencies are not installed by px-idle.
+
+## Compatibility and limitations
+
+Requires-Python is `>=3.3,!=3.5.4`, based on actual Python 3.3.5 installation
+and IDLE tests. Runtime syntax deliberately avoids post-3.3 features. Source research
+covers 2.7 and every 3.0–3.15 generation; it does not prove runtime compatibility.
+See `research/idle-source-matrix.json` for primary-source evidence.
+Exact executed Windows environments are listed below. Every passing row includes
+wheel installation, CLI lifecycle, the actual IDLE loader and Editor, popup
+controls, source insertion, undo, repeat expansion, real Shell exclusion,
+multiple editors and safe uninstall. Full artifact results, including sdist
+tests and Linux evidence, are in [the matrix](docs/compatibility-matrix.md) and
+its machine-readable JSON. Metadata's minimum does not assert that untested
+patch releases or operating systems have passed.
+
+| Python on Windows 11 | Tk | Result / tier |
+| --- | --- | --- |
+| 3.3.5 | 8.5.11 | Passed / legacy |
+| 3.4.4 | 8.6.1 | Passed / legacy |
+| 3.5.4 | 8.6.4 | Unsupported: native IDLE undo segfault, also without px-idle |
+| 3.6.8 | 8.6.6 | Passed / legacy |
+| 3.7.9 | 8.6.9 | Passed / legacy |
+| 3.8.10 | 8.6.9 | Passed / extended |
+| 3.9.13 | 8.6.12 | Passed / extended |
+| 3.10.11 | 8.6.12 | Passed / primary |
+| 3.11.9 | 8.6.12 | Passed / primary |
+| 3.12.10 | 8.6.15 | Passed / primary |
+| 3.13.14 | 8.6.15 | Passed / primary |
+| 3.14.8 | 9.0.4 | Passed / primary |
+| 3.15.0rc3 | 9.0.4 | Passed / experimental prerelease |
+
+Python 2.7 and 3.0–3.2 are unsupported. macOS and CPython main have no executed
+runtime evidence here. Configured CI jobs do not count as observed passes.
+Linux tests use Ubuntu WSL with WSLg or isolated Xvfb (recorded per run), with
+distro Python 3.14.4/Tk 8.6.17 and
+portable Python 3.11.17, 3.12.15, 3.13.16, 3.14.8 and 3.15.0rc3/Tk 9.0.4.
+The portable Linux Python 3.10.22/Tk 9.0.4 build fails native IDLE startup even
+with px-idle unregistered and is unsupported. Consult the matrix for each
+artifact result; a Python version alone does not identify a tested Tk environment.
+Old pip installation uses a small setup.py fallback justified by an actual
+pip 9 sdist failure. Build tooling runs on modern Python; runtime has no external
+dependencies. A tested local wheel is the legacy fallback. See
+[publication status](docs/testpypi.md).
+
+Triggers activate only on a line containing optional whitespace and `#>query`.
+Normal comments and inline strings do not activate. Existing IDLE STRING tags
+suppress multiline string triggers; delayed coloring is a known limitation to
+be checked in GUI tests. Companion files require a saved primary file with the
+matching original filename. Existing meaningful content is never overwritten.
+The current catalogue has no companion files. Source fidelity takes priority
+over modernization: practical syntax may require a newer Python than expansion.
+
+## Development
+
+Fetch the authoritative repository into `upstream/` and run
+`python scripts/import_practicals.py upstream`. The importer reads data and ASTs,
+never imports or runs repository scripts. Run `python -m unittest discover -s tests`.
+Build using `python -m build`, inspect with `python -m twine check dist/*`, then
+test each built artifact in a clean environment. Public upload must follow
+TestPyPI validation first. Unexecuted CI jobs are never recorded as passes.

px_idle-0.1.0/docs/artifact-inspection.json

@@ -0,0 +1,14 @@
+[
+  {
+    "artifact": "px_idle-0.1.0-py3-none-any.whl",
+    "sha256": "8b2be7e0edc374e819ecdad7419b5341cf25e30f09b738ef82efa42365c0e8a2",
+    "assets": 13,
+    "inspection": "passed"
+  },
+  {
+    "artifact": "px_idle-0.1.0.tar.gz",
+    "sha256": "f5e5becbebc6155734450320aa5ef1311441128e07adebb681129871f9836f33",
+    "assets": 13,
+    "inspection": "passed"
+  }
+]