freedos-micro-python 0.1.0__tar.gz

freedos_micro_python-0.1.0/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 freedos_micro_python 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.
+
+Note: this license covers the integration glue (build scripts, port files,
+CLI wrapper, tests). The MicroPython upstream sources fetched by build_port.sh
+remain under their original MIT license — see https://github.com/micropython/micropython.

freedos_micro_python-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: freedos_micro_python
+Version: 0.1.0
+Summary: MicroPython port for FreeDOS / i386 — built end-to-end through the uc386 C23 compiler
+Author: freedos_micro_python contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/avwohl/freedos_micro_python
+Project-URL: Repository, https://github.com/avwohl/freedos_micro_python
+Project-URL: Issues, https://github.com/avwohl/freedos_micro_python/issues
+Keywords: micropython,python,freedos,dos,i386,retro-computing,embedded,interpreter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: System :: Emulators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: uc386>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# freedos_micro_python
+
+[MicroPython](https://github.com/micropython/micropython) port for
+**FreeDOS / i386**, built end-to-end through the
+[uc386](https://pypi.org/project/uc386/) C23 compiler. Produces a
+runnable flat-binary or PMODE/W `.exe` with a fully-functional
+Python REPL — arithmetic, control flow, classes, list comprehensions,
+exception handling, and ~25 named builtins all work.
+
+```
+MicroPython uc386-triage on 2026-05-01; uc386-dos with i386
+Type "help()" for more information.
+>>> def fib(n):
+...     if n < 2: return n
+...     return fib(n-1) + fib(n-2)
+...
+>>> print([fib(i) for i in range(10)])
+[0, 1, 1, 2, 3, 5, 8, 13, 21, 34]
+```
+
+## Status
+
+- ~444 KB binary at the EXTRA_FEATURES + axtls TLS configuration
+- ~70 smoke tests pin REPL banner, builtins, comprehensions, exceptions,
+  module imports (`os`, `time`, `re`, `json`, `hashlib`, `ssl`, ...),
+  and the long-int / float code paths
+- See [`NOTES.md`](NOTES.md) for the full per-slice development log
+
+## Install
+
+```
+pip install freedos_micro_python
+```
+
+This pulls in `uc386` (the compiler) automatically. You also need:
+
+- a Unix-y shell to drive the `build_port.sh` script (macOS / Linux)
+- `git` (for fetching the upstream MicroPython sources)
+- `make` is **not** required
+
+## Quick start
+
+```bash
+mkdir mp-build && cd mp-build
+freedos-micropython fetch        # clones upstream MicroPython into ./upstream
+freedos-micropython build        # per-TU triage build (generates qstrdefs)
+freedos-micropython port         # multi-TU build → ./build/micropython.bin
+```
+
+Wall-clock for the `port` step is ~14 minutes on a recent Mac. The
+output is `./build/micropython.bin`, a flat i386 DOS binary runnable
+under uc386's emulator:
+
+```python
+from uc386.dos_emu import run
+res = run("build/micropython.bin", timeout_seconds=10.0,
+          instruction_limit=2_000_000_000)
+print(res.stdout)   # → "MicroPython uc386-triage on ...\n..."
+```
+
+To produce a real DOS `.exe` (PMODE/W bound, ~12 KB stub overhead):
+use uc386's `addons/harness/exe.py`.
+
+## Testing
+
+After a successful `port` build:
+
+```bash
+pytest --pyargs freedos_micro_python    # parametric: tests live in tests/
+# or, against a checkout:
+pytest tests/
+```
+
+The smoke tests skip cleanly if `build/micropython.bin` doesn't exist.
+
+## Layout
+
+- `src/freedos_micro_python/scripts/` — the three shell scripts
+  (`fetch.sh`, `build.sh`, `build_port.sh`); invoked via the CLI
+  wrapper, which sets `UC386_LIB_INCLUDE` from the installed `uc386`
+- `src/freedos_micro_python/port/` — the FreeDOS port files
+  (`mpconfigport.h`, `*_uc386dos.c`, lwIP + axtls glue)
+- `src/freedos_micro_python/gen_qstrdefs.py` — qstr table generator
+  (mirrors upstream's `tools/makeqstrdata.py`)
+- `src/freedos_micro_python/cli.py` — the `freedos-micropython` CLI
+- `tests/` — pytest smoke tests + qstr unit tests
+- `rigs/dosbox-x-rig/` — DOSBox-X regression rig (network packet driver)
+- `rigs/tls-rig/` — axtls TLS regression rig
+
+## License
+
+[MIT](LICENSE), matching upstream MicroPython. The integration glue
+(scripts, port files, CLI, tests) is what's covered here; the
+upstream MicroPython sources fetched by `build_port.sh` retain their
+own MIT license.
+
+## Related projects
+
+- [uc386](https://github.com/avwohl/uc386) — the C23 compiler that
+  builds this port. Hosts the `dos_emu` test harness.
+- [uc_core](https://github.com/avwohl/uc_core) — shared C23 frontend
+  used by uc386 (and the Z80 sibling, uc80).
+- [MicroPython](https://github.com/micropython/micropython) — upstream.

freedos_micro_python-0.1.0/README.md

@@ -0,0 +1,103 @@
+# freedos_micro_python
+
+[MicroPython](https://github.com/micropython/micropython) port for
+**FreeDOS / i386**, built end-to-end through the
+[uc386](https://pypi.org/project/uc386/) C23 compiler. Produces a
+runnable flat-binary or PMODE/W `.exe` with a fully-functional
+Python REPL — arithmetic, control flow, classes, list comprehensions,
+exception handling, and ~25 named builtins all work.
+
+```
+MicroPython uc386-triage on 2026-05-01; uc386-dos with i386
+Type "help()" for more information.
+>>> def fib(n):
+...     if n < 2: return n
+...     return fib(n-1) + fib(n-2)
+...
+>>> print([fib(i) for i in range(10)])
+[0, 1, 1, 2, 3, 5, 8, 13, 21, 34]
+```
+
+## Status
+
+- ~444 KB binary at the EXTRA_FEATURES + axtls TLS configuration
+- ~70 smoke tests pin REPL banner, builtins, comprehensions, exceptions,
+  module imports (`os`, `time`, `re`, `json`, `hashlib`, `ssl`, ...),
+  and the long-int / float code paths
+- See [`NOTES.md`](NOTES.md) for the full per-slice development log
+
+## Install
+
+```
+pip install freedos_micro_python
+```
+
+This pulls in `uc386` (the compiler) automatically. You also need:
+
+- a Unix-y shell to drive the `build_port.sh` script (macOS / Linux)
+- `git` (for fetching the upstream MicroPython sources)
+- `make` is **not** required
+
+## Quick start
+
+```bash
+mkdir mp-build && cd mp-build
+freedos-micropython fetch        # clones upstream MicroPython into ./upstream
+freedos-micropython build        # per-TU triage build (generates qstrdefs)
+freedos-micropython port         # multi-TU build → ./build/micropython.bin
+```
+
+Wall-clock for the `port` step is ~14 minutes on a recent Mac. The
+output is `./build/micropython.bin`, a flat i386 DOS binary runnable
+under uc386's emulator:
+
+```python
+from uc386.dos_emu import run
+res = run("build/micropython.bin", timeout_seconds=10.0,
+          instruction_limit=2_000_000_000)
+print(res.stdout)   # → "MicroPython uc386-triage on ...\n..."
+```
+
+To produce a real DOS `.exe` (PMODE/W bound, ~12 KB stub overhead):
+use uc386's `addons/harness/exe.py`.
+
+## Testing
+
+After a successful `port` build:
+
+```bash
+pytest --pyargs freedos_micro_python    # parametric: tests live in tests/
+# or, against a checkout:
+pytest tests/
+```
+
+The smoke tests skip cleanly if `build/micropython.bin` doesn't exist.
+
+## Layout
+
+- `src/freedos_micro_python/scripts/` — the three shell scripts
+  (`fetch.sh`, `build.sh`, `build_port.sh`); invoked via the CLI
+  wrapper, which sets `UC386_LIB_INCLUDE` from the installed `uc386`
+- `src/freedos_micro_python/port/` — the FreeDOS port files
+  (`mpconfigport.h`, `*_uc386dos.c`, lwIP + axtls glue)
+- `src/freedos_micro_python/gen_qstrdefs.py` — qstr table generator
+  (mirrors upstream's `tools/makeqstrdata.py`)
+- `src/freedos_micro_python/cli.py` — the `freedos-micropython` CLI
+- `tests/` — pytest smoke tests + qstr unit tests
+- `rigs/dosbox-x-rig/` — DOSBox-X regression rig (network packet driver)
+- `rigs/tls-rig/` — axtls TLS regression rig
+
+## License
+
+[MIT](LICENSE), matching upstream MicroPython. The integration glue
+(scripts, port files, CLI, tests) is what's covered here; the
+upstream MicroPython sources fetched by `build_port.sh` retain their
+own MIT license.
+
+## Related projects
+
+- [uc386](https://github.com/avwohl/uc386) — the C23 compiler that
+  builds this port. Hosts the `dos_emu` test harness.
+- [uc_core](https://github.com/avwohl/uc_core) — shared C23 frontend
+  used by uc386 (and the Z80 sibling, uc80).
+- [MicroPython](https://github.com/micropython/micropython) — upstream.

freedos_micro_python-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "freedos_micro_python"
+version = "0.1.0"
+description = "MicroPython port for FreeDOS / i386 — built end-to-end through the uc386 C23 compiler"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "uc386>=0.1.0",
+]
+authors = [
+    {name = "freedos_micro_python contributors"}
+]
+keywords = [
+    "micropython", "python", "freedos", "dos", "i386",
+    "retro-computing", "embedded", "interpreter"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Compilers",
+    "Topic :: System :: Emulators",
+]
+
+[project.urls]
+Homepage = "https://github.com/avwohl/freedos_micro_python"
+Repository = "https://github.com/avwohl/freedos_micro_python"
+Issues = "https://github.com/avwohl/freedos_micro_python/issues"
+
+[project.scripts]
+freedos-micropython = "freedos_micro_python.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+freedos_micro_python = [
+    "scripts/*.sh",
+    "port/*.c",
+    "port/*.h",
+    "port/arch/*.h",
+    "port/lib/**/*.h",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+]

freedos_micro_python-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

freedos_micro_python-0.1.0/src/freedos_micro_python/__init__.py

@@ -0,0 +1,8 @@
+"""freedos_micro_python - MicroPython port for FreeDOS / i386 via uc386."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("freedos_micro_python")
+except PackageNotFoundError:
+    __version__ = "0.0.0+unknown"

freedos_micro_python-0.1.0/src/freedos_micro_python/cli.py

@@ -0,0 +1,106 @@
+"""freedos-micropython CLI: builds the FreeDOS MicroPython binary.
+
+Subcommands:
+    fetch    Run scripts/fetch.sh to clone upstream MicroPython.
+    build    Run scripts/build.sh (per-TU triage build, generates qstrdefs).
+    port     Run scripts/build_port.sh (multi-TU build → micropython.bin).
+
+Each subcommand is a thin wrapper around the bundled shell script. The
+wrapper:
+
+  1. Locates uc386's lib/ via the installed package and exports
+     UC386_LIB_INCLUDE so the scripts don't have to compute it.
+  2. Picks a working directory: uses --workdir if given, else cwd.
+  3. Execs the script with stdin/stdout/stderr passed through.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import subprocess
+import sys
+from importlib.resources import files
+from pathlib import Path
+
+
+def _uc386_lib_include() -> Path:
+    import uc386
+    return Path(uc386.__file__).resolve().parent / "lib" / "include"
+
+
+def _scripts_dir() -> Path:
+    return Path(str(files("freedos_micro_python") / "scripts"))
+
+
+def _port_dir() -> Path:
+    return Path(str(files("freedos_micro_python") / "port"))
+
+
+def _ensure_port_symlink(workdir: Path) -> None:
+    """The shipped scripts reference port files as `uc386-dos/foo.c`.
+    Make sure `workdir/uc386-dos` points at the bundled port dir so
+    those references resolve regardless of where the user is running
+    from."""
+    link = workdir / "uc386-dos"
+    target = _port_dir()
+    if link.is_symlink():
+        if link.resolve() == target.resolve():
+            return
+        link.unlink()
+    elif link.exists():
+        # Real directory at uc386-dos/ — leave it alone, user knows
+        # what they're doing.
+        return
+    link.symlink_to(target)
+
+
+def _run_script(name: str, workdir: Path, extra_args: list[str]) -> int:
+    script = _scripts_dir() / name
+    if not script.exists():
+        print(f"freedos-micropython: bundled script not found: {script}",
+              file=sys.stderr)
+        return 1
+    env = os.environ.copy()
+    env["UC386_LIB_INCLUDE"] = str(_uc386_lib_include())
+    env["FREEDOS_MP_PORT_DIR"] = str(_port_dir())
+    env["FREEDOS_MP_SCRIPTS_DIR"] = str(_scripts_dir())
+    workdir.mkdir(parents=True, exist_ok=True)
+    _ensure_port_symlink(workdir)
+    return subprocess.run(
+        [str(script), *extra_args],
+        cwd=workdir, env=env,
+    ).returncode
+
+
+def main(argv: list[str] | None = None) -> int:
+    ap = argparse.ArgumentParser(
+        prog="freedos-micropython",
+        description=(
+            "Build the FreeDOS / i386 MicroPython port end-to-end "
+            "through the uc386 C23 compiler. Produces a flat .bin "
+            "runnable under uc386.dos_emu (or a PMODE/W .exe via "
+            "uc386's exe.py harness)."
+        ),
+    )
+    ap.add_argument(
+        "--workdir", type=Path, default=Path.cwd(),
+        help="Directory the build runs in (upstream/ and build/ "
+             "land here). Default: current dir.",
+    )
+    sub = ap.add_subparsers(dest="cmd", required=True)
+    sub.add_parser("fetch", help="Clone upstream micropython into ./upstream")
+    sub.add_parser("build", help="Per-TU triage build (generates qstrdefs)")
+    sub.add_parser("port",  help="Multi-TU build → build/micropython.bin")
+
+    ns, extra = ap.parse_known_args(argv)
+    script_map = {
+        "fetch": "fetch.sh",
+        "build": "build.sh",
+        "port":  "build_port.sh",
+    }
+    return _run_script(script_map[ns.cmd], ns.workdir, extra)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())