xpline 0.1.0__tar.gz

xpline-0.1.0/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+First release.
+
+- Four-stage bundler: load, analyze, names, emit
+- CLI: `xpline`, `python3 -m xpline`, and the repo wrapper `bundler.py`
+- Self-bundled single-file CLI at `dist/xpline.py`
+- `--debug-dir` stage snapshots and `--list-stages`

xpline-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xpline contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xpline-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include bundler.py
+include dist/xpline.py
+recursive-include tests *.py

xpline-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: xpline
+Version: 0.1.0
+Summary: Bundle a Python program into a single readable source file.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Naimy441/xpline
+Project-URL: Repository, https://github.com/Naimy441/xpline
+Project-URL: Issues, https://github.com/Naimy441/xpline/issues
+Project-URL: Changelog, https://github.com/Naimy441/xpline/blob/main/CHANGELOG.md
+Keywords: bundler,inline,ast,single-file
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: numpy; extra == "dev"
+Dynamic: license-file
+
+# xpline
+
+Explain + Inline = Expline → Xpline
+
+Flatten a Python program into one readable `.py` file. xpline follows imports, keeps reachable source, and emits a single file you can still read and run.
+
+Local modules and many pure-Python third-party packages are inlined. The standard library, C extensions, and a few identity-sensitive modules stay as normal imports. This is not PyInstaller, zipapp, or a dependency freezer — the output still needs a Python interpreter and whatever it still imports.
+
+Requires **Python 3.9+**.
+
+## Install
+
+```bash
+pip install xpline
+```
+
+From a checkout:
+
+```bash
+pip install .
+```
+
+Or skip install and use the self-bundled CLI:
+
+```bash
+python3 dist/xpline.py app.py -o app_bundle.py
+```
+
+## Usage
+
+```bash
+xpline app.py -o app_bundle.py
+python3 -m xpline app.py -o app_bundle.py
+```
+
+From a checkout, `python3 bundler.py app.py -o app_bundle.py` is the same command.
+
+### Library
+
+```python
+from pathlib import Path
+from xpline import bundle_file
+
+bundle_file(Path("app.py"), Path("app_bundle.py"))
+```
+
+### Debug a run
+
+`--debug-dir` writes `01_load.json`, `02_analyze.json`, `03_names.json`, and `04_emit.py` so you can see what each stage decided.
+
+```bash
+xpline app.py -o app_bundle.py --debug-dir .xpline-debug
+xpline --list-stages
+xpline --version
+xpline --self-bundle -o dist/xpline.py
+```
+
+## What stays as an import
+
+- The standard library
+- C extensions, builtins, and frozen modules
+- `matplotlib.font_manager` — Agg/FreeType compare `FontProperties` by class identity
+- Anything xpline cannot load as `.py` source
+
+## Limitations
+
+- `if TYPE_CHECKING:` blocks are dropped
+- Analysis errors out after 50,000 reachable symbols
+- Bundled output may include `_xpline_setglobal` or `__xpline_restore_class_name` helpers when flattening needs them
+
+## How it works
+
+Source lives in `xpline/`. Each stage is its own module so you can read and debug them separately. Those stages are then bundled back into `dist/xpline.py` to show the tool working on itself.
+
+```
+xpline/
+  models.py          shared types
+  astutil.py         AST helpers
+  resolve.py         module lookup
+  pipeline.py        runs the stages
+  cli.py
+  stages/
+    load.py          01  parse and index
+    analyze.py       02  keep reachable code
+    names.py         03  allocate flatten-safe names
+    emit.py          04  rewrite and interleave
+    rewrite.py       AST rewrite used by emit
+tests/
+dist/xpline.py       self-bundled CLI (generated)
+bundler.py           thin wrapper: python3 bundler.py in.py -o out.py
+```
+
+## Develop
+
+```bash
+pip install -e ".[dev]"
+python3 -m unittest tests.test_pipeline tests.test_bundler
+```
+
+`tests/test_popular_modules.py`, `tests/test_extra_modules.py`, and `tests/test_matplotlib.py` skip packages that are not installed.
+
+## License
+
+MIT

xpline-0.1.0/README.md

@@ -0,0 +1,104 @@
+# xpline
+
+Explain + Inline = Expline → Xpline
+
+Flatten a Python program into one readable `.py` file. xpline follows imports, keeps reachable source, and emits a single file you can still read and run.
+
+Local modules and many pure-Python third-party packages are inlined. The standard library, C extensions, and a few identity-sensitive modules stay as normal imports. This is not PyInstaller, zipapp, or a dependency freezer — the output still needs a Python interpreter and whatever it still imports.
+
+Requires **Python 3.9+**.
+
+## Install
+
+```bash
+pip install xpline
+```
+
+From a checkout:
+
+```bash
+pip install .
+```
+
+Or skip install and use the self-bundled CLI:
+
+```bash
+python3 dist/xpline.py app.py -o app_bundle.py
+```
+
+## Usage
+
+```bash
+xpline app.py -o app_bundle.py
+python3 -m xpline app.py -o app_bundle.py
+```
+
+From a checkout, `python3 bundler.py app.py -o app_bundle.py` is the same command.
+
+### Library
+
+```python
+from pathlib import Path
+from xpline import bundle_file
+
+bundle_file(Path("app.py"), Path("app_bundle.py"))
+```
+
+### Debug a run
+
+`--debug-dir` writes `01_load.json`, `02_analyze.json`, `03_names.json`, and `04_emit.py` so you can see what each stage decided.
+
+```bash
+xpline app.py -o app_bundle.py --debug-dir .xpline-debug
+xpline --list-stages
+xpline --version
+xpline --self-bundle -o dist/xpline.py
+```
+
+## What stays as an import
+
+- The standard library
+- C extensions, builtins, and frozen modules
+- `matplotlib.font_manager` — Agg/FreeType compare `FontProperties` by class identity
+- Anything xpline cannot load as `.py` source
+
+## Limitations
+
+- `if TYPE_CHECKING:` blocks are dropped
+- Analysis errors out after 50,000 reachable symbols
+- Bundled output may include `_xpline_setglobal` or `__xpline_restore_class_name` helpers when flattening needs them
+
+## How it works
+
+Source lives in `xpline/`. Each stage is its own module so you can read and debug them separately. Those stages are then bundled back into `dist/xpline.py` to show the tool working on itself.
+
+```
+xpline/
+  models.py          shared types
+  astutil.py         AST helpers
+  resolve.py         module lookup
+  pipeline.py        runs the stages
+  cli.py
+  stages/
+    load.py          01  parse and index
+    analyze.py       02  keep reachable code
+    names.py         03  allocate flatten-safe names
+    emit.py          04  rewrite and interleave
+    rewrite.py       AST rewrite used by emit
+tests/
+dist/xpline.py       self-bundled CLI (generated)
+bundler.py           thin wrapper: python3 bundler.py in.py -o out.py
+```
+
+## Develop
+
+```bash
+pip install -e ".[dev]"
+python3 -m unittest tests.test_pipeline tests.test_bundler
+```
+
+`tests/test_popular_modules.py`, `tests/test_extra_modules.py`, and `tests/test_matplotlib.py` skip packages that are not installed.
+
+## License
+
+MIT

xpline-0.1.0/bundler.py

@@ -0,0 +1,17 @@
+"""Compatibility entry for the staged package: python3 bundler.py in.py -o out.py"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from xpline.cli import main
+from xpline.pipeline import Bundler, bundle_file
+
+__all__ = ["Bundler", "bundle_file", "main"]
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())