freedos-micro-python 0.1.0__py3-none-any.whl

freedos_micro_python/scripts/build_port.sh

@@ -0,0 +1,241 @@
+#!/bin/sh
+# Multi-TU build of MicroPython through uc386 — produces a runnable
+# `build/micropython.bin` that boots to the REPL banner under
+# `uc386.dos_emu.run`.
+#
+# Sources:
+#   - upstream/py/*.c                        (132)
+#   - upstream/shared/libc/printf.c
+#                       /string0.c
+#                       /__errno.c
+#                       /abort_.c
+#   - upstream/shared/readline/readline.c
+#   - upstream/shared/runtime/pyexec.c
+#                            /stdout_helpers.c
+#                            /interrupt_char.c
+#                            /sys_stdio_mphal.c
+#   - upstream/ports/minimal/main.c          (REPL driver)
+#   - upstream/ports/minimal/uart_core.c     (mp_hal_stdin/stdout)
+#
+# Includes:
+#   - lib/include                            (uc386 libc)
+#   - upstream                               (py/, shared/)
+#   - uc386-dos                              (mpconfigport.h, mphalport.h)
+#   - build                                  (genhdr/qstrdefs.generated.h,
+#                                             moduledefs.h, mpversion.h,
+#                                             root_pointers.h — emitted
+#                                             by ./build.sh during the
+#                                             per-file triage pass)
+#
+# Defines:
+#   -D__linux__=1                            triggers the minimal port's
+#                                            MICROPY_MIN_USE_STDOUT path
+#                                            (read(STDIN_FILENO)/write(...))
+#                                            — uc386 lowers those into
+#                                            INT 21h DOS syscalls.
+#
+# Wall-clock: ~14 minutes on the dev Mac (Apple Silicon, Python 3.12,
+# uc386 in-process). Multi-TU is heavy because uc_core's preprocessor
+# runs once per TU.
+#
+# Outputs:
+#   build/micropython.asm    — NASM-syntax assembly (1.5 MB+)
+#   build/micropython.bin    — flat 32-bit DOS bin (170 KB)
+#
+# Run:
+#   .venv/bin/python -c "from pathlib import Path; \
+#       from uc386.dos_emu import run; \
+#       r = run(Path('addons/gnu/micropython/build/micropython.bin'), \
+#               timeout_seconds=10.0); \
+#       print(r.stdout)"
+#
+# The REPL banner ("MicroPython uc386-triage on ...; uc386-dos with i386")
+# should appear, followed by `>>> ` and the boot waits on stdin.
+set -eu
+
+
+if [ ! -d upstream ]; then
+    echo "micropython: run ./fetch.sh first." >&2
+    exit 1
+fi
+
+# build.sh emits the genhdr/* stubs (qstrdefs.generated.h,
+# moduledefs.h, mpversion.h, root_pointers.h) that py/*.c expects.
+# Run it first if those aren't here yet.
+if [ ! -f build/genhdr/qstrdefs.generated.h ]; then
+    echo "micropython: stub headers missing; running ./build.sh first." >&2
+    ./build.sh > /dev/null
+fi
+
+# Two ways this script gets its uc386 paths:
+#  1. Invoked via `freedos-micropython port` — the Python CLI exports
+#     UC386_LIB_INCLUDE (and FREEDOS_MP_PORT_DIR) from the installed
+#     uc386 / freedos_micro_python packages, and pre-symlinks the
+#     port files into cwd as ./uc386-dos.
+#  2. Invoked standalone from a uc386 source checkout — falls back
+#     to walking up to the uc386 repo root.
+if [ -z "${UC386_LIB_INCLUDE:-}" ]; then
+    REPO="$(cd ../../.. && pwd)"
+    UC386_LIB_INCLUDE="$REPO/src/uc386/lib/include"
+fi
+if [ -n "${PYTHON:-}" ]; then
+    :
+elif [ -n "${REPO:-}" ] && [ -x "$REPO/.venv/bin/python" ]; then
+    PYTHON="$REPO/.venv/bin/python"
+else
+    PYTHON="$(command -v python3.12 || command -v python3 || command -v python)"
+fi
+INCLUDE="$UC386_LIB_INCLUDE"
+
+SOURCES_FILE="build/_port_sources.txt"
+{
+    find upstream/py -name '*.c' | sort
+    echo upstream/shared/libc/__errno.c
+    echo upstream/shared/libc/abort_.c
+    echo upstream/shared/libc/printf.c
+    echo upstream/shared/libc/string0.c
+    echo upstream/shared/readline/readline.c
+    echo upstream/shared/runtime/pyexec.c
+    echo upstream/shared/runtime/stdout_helpers.c
+    echo upstream/shared/runtime/interrupt_char.c
+    echo upstream/shared/runtime/sys_stdio_mphal.c
+    echo upstream/shared/timeutils/timeutils.c
+    echo upstream/extmod/modtime.c
+    echo upstream/extmod/moductypes.c
+    echo upstream/extmod/modrandom.c
+    echo upstream/extmod/modbinascii.c
+    echo upstream/extmod/modhashlib.c
+    echo upstream/extmod/modre.c
+    echo upstream/extmod/modheapq.c
+    # moddeflate.c inline-#includes all the uzlib sources
+    # (tinflate.c, header.c, adler32.c, crc32.c, lz77.c → defl_static.c)
+    # so don't add them to the source list — that would duplicate
+    # symbols.
+    echo upstream/extmod/moddeflate.c
+    echo upstream/extmod/modjson.c
+    echo upstream/extmod/modplatform.c
+    echo upstream/extmod/modselect.c
+    # MD5 + SHA1 are now from upstream/lib/axtls/crypto/ (added below
+    # in the axtls section). B-Con's MD5 + SHA1 sources are still
+    # fetched by fetch.sh's `fetch_b_con_crypto` hook so the legacy
+    # shim at uc386-dos/lib/axtls/crypto/crypto.h still resolves
+    # cleanly if you flip MICROPY_PY_SSL=0 + drop axtls from this
+    # list, but they aren't compiled in the SSL build to avoid
+    # carrying two MD5 implementations.
+    # lwIP — IPv4-only TCP/UDP/DNS stack with loopback for testing.
+    # Phase 1: just core + ipv4 + netif/ethernet. DHCP / IPv6 / SLIP /
+    # PPP are off in lwipopts.h so their sources don't pull in.
+    # axtls — real TLS via upstream/lib/axtls/. The MP glue is our
+    # vendored fork at uc386-dos/modtls_axtls_uc386dos.c (which adds
+    # real verify_mode + load_verify_locations on top of upstream's
+    # minimal version). axtls library sources mirror upstream/extmod/
+    # extmod.mk's AXTLS_DIR list.
+    echo uc386-dos/modtls_axtls_uc386dos.c
+    echo upstream/lib/axtls/ssl/asn1.c
+    echo upstream/lib/axtls/ssl/loader.c
+    echo upstream/lib/axtls/ssl/tls1.c
+    echo upstream/lib/axtls/ssl/tls1_svr.c
+    echo upstream/lib/axtls/ssl/tls1_clnt.c
+    echo upstream/lib/axtls/ssl/x509.c
+    echo upstream/lib/axtls/crypto/aes.c
+    echo upstream/lib/axtls/crypto/bigint.c
+    echo upstream/lib/axtls/crypto/crypto_misc.c
+    echo upstream/lib/axtls/crypto/hmac.c
+    echo upstream/lib/axtls/crypto/md5.c
+    echo upstream/lib/axtls/crypto/sha1.c
+    # SHA384/SHA512 — needed for cert chain verification when the CA
+    # signs with those algorithms (RSA-SHA384 / RSA-SHA512 are common
+    # on modern X.509 chains). Upstream MP's extmod.mk doesn't pull
+    # these because their config has CONFIG_SSL_CERT_VERIFICATION
+    # off; we have it on (uc386-dos has the room) so we need them.
+    echo upstream/lib/axtls/crypto/sha384.c
+    echo upstream/lib/axtls/crypto/sha512.c
+    echo upstream/lib/axtls/crypto/rsa.c
+    echo upstream/extmod/modlwip.c
+    echo upstream/lib/lwip/src/core/init.c
+    echo upstream/lib/lwip/src/core/def.c
+    echo upstream/lib/lwip/src/core/dns.c
+    echo upstream/lib/lwip/src/core/inet_chksum.c
+    echo upstream/lib/lwip/src/core/ip.c
+    echo upstream/lib/lwip/src/core/mem.c
+    echo upstream/lib/lwip/src/core/memp.c
+    echo upstream/lib/lwip/src/core/netif.c
+    echo upstream/lib/lwip/src/core/pbuf.c
+    echo upstream/lib/lwip/src/core/raw.c
+    echo upstream/lib/lwip/src/core/stats.c
+    echo upstream/lib/lwip/src/core/sys.c
+    echo upstream/lib/lwip/src/core/tcp.c
+    echo upstream/lib/lwip/src/core/tcp_in.c
+    echo upstream/lib/lwip/src/core/tcp_out.c
+    echo upstream/lib/lwip/src/core/timeouts.c
+    echo upstream/lib/lwip/src/core/udp.c
+    echo upstream/lib/lwip/src/core/ipv4/dhcp.c
+    echo upstream/lib/lwip/src/core/ipv4/etharp.c
+    echo upstream/lib/lwip/src/core/ipv4/icmp.c
+    echo upstream/lib/lwip/src/core/ipv4/igmp.c
+    echo upstream/lib/lwip/src/core/ipv4/ip4.c
+    echo upstream/lib/lwip/src/core/ipv4/ip4_addr.c
+    echo upstream/lib/lwip/src/core/ipv4/ip4_frag.c
+    echo upstream/lib/lwip/src/netif/ethernet.c
+    echo uc386-dos/lwip_uc386dos.c
+    echo upstream/ports/minimal/main.c
+    echo upstream/ports/minimal/uart_core.c
+    echo uc386-dos/mphal_uc386dos.c
+    echo uc386-dos/file_uc386dos.c
+    echo uc386-dos/os_uc386dos.c
+    echo uc386-dos/path_uc386dos.c
+    echo uc386-dos/base64_uc386dos.c
+    echo uc386-dos/shutil_uc386dos.c
+    echo uc386-dos/tempfile_uc386dos.c
+    echo uc386-dos/urllib_parse_uc386dos.c
+    echo uc386-dos/urllib_uc386dos.c
+    echo uc386-dos/uc386_net_uc386dos.c
+    echo uc386-dos/pktdrv_uc386dos.c
+    echo uc386-dos/math_gamma.c
+    # Real time(), mktime(), gettimeofday() backed by the DOS RTC —
+    # replaces the libc.asm stubs (now removed). Required by axtls
+    # cert verification (notBefore/notAfter window check).
+    echo uc386-dos/time_real_uc386dos.c
+} > "$SOURCES_FILE"
+
+n_sources="$(wc -l < "$SOURCES_FILE")"
+echo "micropython: compiling $n_sources sources via uc386 (multi-TU; ~14 min) …"
+
+# tr+xargs delivery so the source list survives without arg-list overflow.
+# `set -e` would abort on uc386 failure; we want to surface it explicitly.
+set +e
+tr '\n' '\0' < "$SOURCES_FILE" \
+    | xargs -0 "$PYTHON" -m uc386.main \
+        -I "$INCLUDE" \
+        -I upstream \
+        -I upstream/lib/lwip/src/include \
+        -I upstream/extmod/lwip-include \
+        -I upstream/lib/axtls/ssl \
+        -I upstream/lib/axtls/crypto \
+        -I upstream/extmod/axtls-include \
+        -I uc386-dos \
+        -I build \
+        -D__linux__=1 \
+        -DNDEBUG=1 \
+        -DMICROPY_SSL_AXTLS=1 \
+        -DMICROPY_PY_SSL=1 \
+        -Dmp_stream_errno=errno \
+        -o build/micropython.asm
+rc=$?
+set -e
+if [ $rc -ne 0 ]; then
+    echo "micropython: uc386 returned $rc; not assembling." >&2
+    exit $rc
+fi
+
+asm_size="$(wc -c < build/micropython.asm | tr -d ' ')"
+echo "micropython: wrote build/micropython.asm ($asm_size bytes)"
+echo "micropython: assembling via nasm …"
+# `-w-error=label-redef-late`: same convergence warning we suppress for
+# DOOM. Long programs hit short/long jump promotion edge cases NASM 3.x
+# now warns about; the binary's correct after convergence.
+nasm -f bin -w-error=label-redef-late \
+    build/micropython.asm -o build/micropython.bin
+bin_size="$(wc -c < build/micropython.bin | tr -d ' ')"
+echo "micropython: built build/micropython.bin ($bin_size bytes)"
+ls -l build/micropython.bin

freedos_micro_python/scripts/fetch.sh

@@ -0,0 +1,238 @@
+#!/bin/sh
+# Fetch MicroPython upstream into upstream/.
+# Idempotent: a second run is a no-op once upstream/ exists.
+set -eu
+
+# B-Con public-domain crypto reference impls used by hashlib's
+# md5/sha1 (sha256 is already in upstream's tarball). Pull these
+# even when upstream/ already exists, so an older fetch that
+# pre-dates the crypto-algorithms additions self-heals on next run.
+fetch_b_con_crypto() {
+    CA_BASE="https://raw.githubusercontent.com/B-Con/crypto-algorithms/master"
+    mkdir -p upstream/lib/crypto-algorithms
+    for f in md5.c md5.h sha1.c sha1.h; do
+        if [ ! -f "upstream/lib/crypto-algorithms/$f" ]; then
+            echo "micropython: fetching crypto-algorithms/$f …"
+            curl -fsSL "$CA_BASE/$f" -o "upstream/lib/crypto-algorithms/$f"
+        fi
+    done
+}
+
+# axtls — TLS library, submodule in upstream/.gitmodules pointing at
+# micropython/axtls (a fork of axtls-2.1.x maintained for MP). Pinned
+# to the SHA the upstream MP tarball references (gitlinks aren't pulled
+# by the tarball, so we fetch a tree archive directly). The MP-extmod
+# glue at upstream/extmod/modtls_axtls.c expects this tree at
+# upstream/lib/axtls/.
+fetch_axtls() {
+    AXTLS_SHA="531cab9c278c947d268bd4c94ecab9153a961b43"
+    AXTLS_DIR="upstream/lib/axtls"
+    if [ -d "$AXTLS_DIR/ssl" ]; then
+        return 0
+    fi
+    echo "micropython: fetching axtls $AXTLS_SHA …"
+    AXTLS_TMP="$(mktemp -d)"
+    trap 'rm -rf "$AXTLS_TMP"' RETURN 2>/dev/null || true
+    curl -fsSL \
+        "https://github.com/micropython/axtls/archive/${AXTLS_SHA}.tar.gz" \
+        -o "$AXTLS_TMP/axtls.tgz"
+    tar -xzf "$AXTLS_TMP/axtls.tgz" -C "$AXTLS_TMP"
+    mkdir -p "$AXTLS_DIR"
+    cp -r "$AXTLS_TMP"/axtls-*/ssl    "$AXTLS_DIR/"
+    cp -r "$AXTLS_TMP"/axtls-*/crypto "$AXTLS_DIR/"
+    rm -rf "$AXTLS_TMP"
+}
+
+# lwIP — submodule in upstream/.gitmodules but not pulled by the
+# tarball. Fetch a pinned release tarball into upstream/lib/lwip/
+# alongside the existing crypto-algorithms stash. STABLE-2_2_1 is
+# the latest tagged release as of mid-2026 and is what our port
+# integration targets.
+fetch_lwip() {
+    LWIP_TAG="STABLE-2_2_1_RELEASE"
+    LWIP_DIR="upstream/lib/lwip"
+    if [ -d "$LWIP_DIR/src/core" ]; then
+        return 0
+    fi
+    echo "micropython: fetching lwIP $LWIP_TAG …"
+    LWIP_TMP="$(mktemp -d)"
+    trap 'rm -rf "$LWIP_TMP"' RETURN 2>/dev/null || true
+    curl -fsSL \
+        "https://github.com/lwip-tcpip/lwip/archive/refs/tags/${LWIP_TAG}.tar.gz" \
+        -o "$LWIP_TMP/lwip.tgz"
+    tar -xzf "$LWIP_TMP/lwip.tgz" -C "$LWIP_TMP"
+    mkdir -p "$LWIP_DIR"
+    cp -r "$LWIP_TMP"/lwip-*/src "$LWIP_DIR/"
+    rm -rf "$LWIP_TMP"
+}
+
+# Patch upstream's `mod_lwip_reset` to register our loopback packet
+# pump as the poll callback (instead of nulling it). LWIP_NETIF_LOOPBACK=1
+# with NO_SYS=1 needs manual netif_poll(netif_default) per tick to
+# deliver packets; uc386dos_loopback_poll (in uc386-dos/lwip_uc386dos.c)
+# does that. Idempotent: skips when the patched line is already present.
+patch_modlwip_loopback_poll() {
+    F="upstream/extmod/modlwip.c"
+    if [ ! -f "$F" ]; then return 0; fi
+    if grep -q "uc386dos_loopback_poll" "$F"; then return 0; fi
+    if ! grep -q "lwip_poll_list.poll = NULL;" "$F"; then
+        echo "micropython: warn: modlwip.c reset shape changed — skipping loopback patch." >&2
+        return 0
+    fi
+    echo "micropython: patching modlwip.c mod_lwip_reset for loopback poll …"
+    awk '
+        /static mp_obj_t mod_lwip_reset/ { in_reset = 1 }
+        in_reset && /lwip_poll_list\.poll = NULL;/ {
+            print "    extern void uc386dos_loopback_poll(void *arg);"
+            print "    lwip_poll_list.poll = uc386dos_loopback_poll;"
+            print "    lwip_poll_list.poll_arg = NULL;"
+            in_reset = 0
+            next
+        }
+        in_reset && /^}/ { in_reset = 0 }
+        { print }
+    ' "$F" > "$F.tmp" && mv "$F.tmp" "$F"
+}
+
+# Inject write(1, ...) checkpoints into ports/minimal/main.c so the
+# rig can see how far MP startup gets. write() goes through libc's
+# INT 21h AH=0x40 BX=1 — which respects DOS file-handle redirection
+# (the > MP_OUT.TXT in autoexec.bat). printf() uses INT 21h AH=02h
+# which writes to the console regardless of redirect, so under
+# `dosbox-x -silent` it lands in /dev/null. The MP REPL itself uses
+# mp_hal_stdout_tx_strn -> write(STDOUT_FILENO, ...), so these
+# markers exercise the same redirect path as the MP banner. The
+# last-seen marker in RIG.LOG identifies the statement that
+# silently aborts. Idempotent: skip if the markers are already in
+# place.
+patch_main_startup_markers() {
+    F="upstream/ports/minimal/main.c"
+    if [ ! -f "$F" ]; then return 0; fi
+    if grep -q "mp-startup-marker" "$F"; then
+        # Old printf-based markers from a prior fetch.sh? Strip them
+        # so the new write()-based markers are what gets compiled.
+        if grep -q "printf(\"\[mp-" "$F"; then
+            echo "micropython: stripping stale printf startup markers from ports/minimal/main.c …"
+            grep -v "mp-startup-marker\|printf(\"\[mp-\|fflush(stdout)" "$F" > "$F.tmp" && mv "$F.tmp" "$F"
+        else
+            return 0
+        fi
+    fi
+    echo "micropython: patching ports/minimal/main.c with write() startup markers …"
+    awk '
+        /^#include "shared\/runtime\/pyexec.h"/ {
+            print
+            print "#include <unistd.h>  /* mp-startup-marker: write() */"
+            next
+        }
+        /^int main\(int argc, char \*\*argv\) \{/ {
+            print
+            print "    /* mp-startup-marker injected by addons/gnu/micropython/fetch.sh */"
+            print "    write(1, \"[mp-main-entered]\\n\", 18);"
+            in_main = 1
+            next
+        }
+        in_main && /mp_stack_ctrl_init\(\);/ {
+            print "    write(1, \"[mp-before-stack-ctrl]\\n\", 23);"
+            print
+            next
+        }
+        in_main && /mp_init\(\);/ {
+            print "    write(1, \"[mp-before-mp-init]\\n\", 20);"
+            print
+            print "    write(1, \"[mp-after-mp-init]\\n\", 19);"
+            next
+        }
+        in_main && /pyexec_friendly_repl\(\);/ {
+            print "    write(1, \"[mp-before-repl]\\n\", 17);"
+            print
+            print "    write(1, \"[mp-after-repl]\\n\", 16);"
+            next
+        }
+        in_main && /mp_deinit\(\);/ {
+            print "    write(1, \"[mp-before-deinit]\\n\", 19);"
+            print
+            in_main = 0
+            next
+        }
+        { print }
+    ' "$F" > "$F.tmp" && mv "$F.tmp" "$F"
+}
+
+# Patch upstream/extmod/axtls-include/config.h to flip CONFIG_SSL_HAS_PEM
+# and CONFIG_SSL_CERT_VERIFICATION from undef to defined. Upstream MP
+# ports compile axtls in skeleton mode without verification because
+# CA bundles don't fit on most embedded targets; uc386-dos has the
+# room and wants real authentication. The flips engage axtls's
+# x509_dn_compare / signature checking / notBefore-notAfter window
+# checks and make `ssl.SSLContext.load_verify_locations` meaningful.
+# Idempotent: leaves the flips in place once applied.
+patch_axtls_config_verify() {
+    F="upstream/extmod/axtls-include/config.h"
+    if [ ! -f "$F" ]; then return 0; fi
+    if grep -q "^#define CONFIG_SSL_CERT_VERIFICATION 1$" "$F"; then
+        return 0
+    fi
+    echo "micropython: enabling axtls cert verification + PEM in $F …"
+    sed -i.bak \
+        -e 's|^#undef CONFIG_SSL_HAS_PEM$|#define CONFIG_SSL_HAS_PEM 1|' \
+        -e 's|^#undef CONFIG_SSL_CERT_VERIFICATION$|#define CONFIG_SSL_CERT_VERIFICATION 1|' \
+        "$F"
+    rm -f "$F.bak"
+}
+
+# Add `#include <endian.h>` at the top of upstream/extmod/axtls-include/
+# axtls_os_port.h. axtls's sha512.c uses be64toh() but doesn't include
+# the header itself — on Linux glibc's <sys/time.h> transitively pulls
+# in endian.h, on uc386's libc it doesn't. Adding the include via
+# axtls_os_port.h (which every axtls TU pulls through os_port.h) is
+# the minimal-blast-radius fix. Idempotent.
+patch_axtls_endian_include() {
+    F="upstream/extmod/axtls-include/axtls_os_port.h"
+    if [ ! -f "$F" ]; then return 0; fi
+    if grep -q "<endian.h>" "$F"; then
+        return 0
+    fi
+    echo "micropython: adding endian.h include to $F …"
+    sed -i.bak \
+        's|^#include <errno.h>$|#include <errno.h>\
+#include <endian.h>|' \
+        "$F"
+    rm -f "$F.bak"
+}
+
+if [ -d upstream ]; then
+    echo "micropython: upstream/ already present — skipping main fetch."
+    fetch_b_con_crypto
+    fetch_lwip
+    fetch_axtls
+    patch_modlwip_loopback_poll
+    patch_main_startup_markers
+    patch_axtls_config_verify
+    patch_axtls_endian_include
+    exit 0
+fi
+
+# Pinned to a specific upstream commit so the source we ship in the
+# tarball alongside the binary always matches what was built. The
+# port currently targets v1.26-era APIs; bump with
+# `git ls-remote https://github.com/micropython/micropython HEAD`
+# and re-run the build cycle when promoting to a newer revision.
+SHA="9f396bba8d675ffb53f7fb047def21c7a581948e"  # 2025-08-01
+URL="https://github.com/micropython/micropython/archive/${SHA}.tar.gz"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+echo "micropython: fetching $URL …"
+curl -fsSL "$URL" -o "$TMP/micropython.tar.gz"
+tar -xzf "$TMP/micropython.tar.gz" -C "$TMP"
+mv "$TMP"/micropython-* upstream
+echo "micropython: upstream tree at $(pwd)/upstream/"
+
+fetch_b_con_crypto
+fetch_lwip
+fetch_axtls
+patch_modlwip_loopback_poll
+patch_main_startup_markers
+patch_axtls_config_verify
+patch_axtls_endian_include

freedos_micro_python-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,37 @@
+freedos_micro_python/__init__.py,sha256=--xMyQE4FSZY0nZlOgZRFOj1y75MTj6ZxMShA63RJSU,257
+freedos_micro_python/cli.py,sha256=nm8J6nrTkQo-VFS39B_PEDwhxBdNyhwfEtlnmBRrdwg,3519
+freedos_micro_python/gen_qstrdefs.py,sha256=jMV5-7nYazwNKpCEWsGx8WabBuZ715TL77j2PryYSYQ,11392
+freedos_micro_python/port/base64_uc386dos.c,sha256=s175D2z9hkzoDtIXL8paQ7bsMNrRIyhrRcSUeO-65_0,5823
+freedos_micro_python/port/file_uc386dos.c,sha256=Wb7qRuNcxpRnQ6BWhNYWO-mmC22fHtU2m1igXNhQSq8,7631
+freedos_micro_python/port/lwip-arch-cc.h,sha256=cMs_iQ3OEbO4FdTRGANJpdmpOYEhZWTstlDO0pHbqzE,1655
+freedos_micro_python/port/lwip_uc386dos.c,sha256=50jOUUsHycy3QfL-ebwAsW4T-gl5cEGw9i1gsBqwqJ4,9966
+freedos_micro_python/port/lwipopts.h,sha256=3pIDgAlFHpzDDxC7Xk8CejrzvQMlcJKJGKdLkN7SsjQ,5422
+freedos_micro_python/port/math_gamma.c,sha256=hSD3i4ZcJ5Eo1NqOZMo71WMOkU_uKTKMnmYoNEgo0DY,2042
+freedos_micro_python/port/modtime_uc386dos.c,sha256=HvHYeq_bIGaK8GdX-UtJI18N-IV9RIJ7ZFPWms6H-tA,2384
+freedos_micro_python/port/modtls_axtls_uc386dos.c,sha256=bYH8eF6IneFX5tqNQYzGSJWMp74YbWRcxqRUWqA76SU,17582
+freedos_micro_python/port/mpconfigport.h,sha256=tF2o-Ln0S7y0d3t81EuijR4qa50mP0b047aXArmY5F4,18657
+freedos_micro_python/port/mphal_uc386dos.c,sha256=1kbKEj9JKphPNgo-AheDLMzHUz7KuJ30l_aw0PPi8GA,3775
+freedos_micro_python/port/mphalport.h,sha256=eg7gM8DUj7Ib_Df-BicrzXBPeF5Mho5rgeSWptLpjM0,456
+freedos_micro_python/port/os_uc386dos.c,sha256=E-YWNB7LPUECLjaq7c5lYVphXQuiVRzi0jiZ0N6XVMQ,10391
+freedos_micro_python/port/path_uc386dos.c,sha256=S0ruBU4_TrYB-RkXiVifTC1brd49rZq7usvdGERlEHE,11401
+freedos_micro_python/port/pktdrv_uc386dos.c,sha256=WygcMSgJRnS5AvAv_SfUeQmf5_8NLANvlnxpD_Z3OAc,26564
+freedos_micro_python/port/qstrdefsport.h,sha256=HihE94Cf8aRNcmOuD0-MqoRG5IDOW_KoDyp1nBkT6tU,101
+freedos_micro_python/port/shutil_uc386dos.c,sha256=bqywTyER2jIZUnv1RDsTKu1m-NB0969IEmTbo8KzfPo,3897
+freedos_micro_python/port/tempfile_uc386dos.c,sha256=HVcU7l9YUtolkPueMy3Sr0fg28wRVkxe4YPqbSq1WDM,4899
+freedos_micro_python/port/time_real_uc386dos.c,sha256=xeuJTR5EmZ0OHYwLDJahZNl539RsNTEzqKLwXuim_XE,2778
+freedos_micro_python/port/uc386_net_uc386dos.c,sha256=g6AN_kDuatlrAwAvcaamMlKSnyxhzKW3QYFuZISLYOg,5071
+freedos_micro_python/port/urllib_parse_uc386dos.c,sha256=1EAM6_iZYMhHO7FjV4ZVpfNvLcyJl68GwQVOI4koJ4Y,13489
+freedos_micro_python/port/urllib_uc386dos.c,sha256=T2-WclQnsKBnQsyLGicYbFj7AqhOpx1TquslUDh-gg4,1218
+freedos_micro_python/port/arch/bpstruct.h,sha256=ozGLp9D4wIl6vP48isExUE5a1PP-r360ZQIQKp1DOWs,141
+freedos_micro_python/port/arch/cc.h,sha256=IRm8Z6GzV1BWZYSSLisoRuUIs7VIxDOwX_mfbS-VUTA,222
+freedos_micro_python/port/arch/epstruct.h,sha256=XoxKvRvdXZbWxFJRCb6ROTAQu6YN4AL_6icQnEPcNug,33
+freedos_micro_python/port/lib/axtls/crypto/crypto.h,sha256=JURkZnHeNjv856FfmLIoJTTbplFKT9ilfr_zMfUnarM,1657
+freedos_micro_python/scripts/build.sh,sha256=YcQHRoZ5-T5n6_lUD4-WXiZWcMRdMFHnvmoyN4QYNVU,28574
+freedos_micro_python/scripts/build_port.sh,sha256=WFDF3Q9QVD2FIYr374DpN-CA2u7Kx91p65lDTBJHu9U,10211
+freedos_micro_python/scripts/fetch.sh,sha256=zzyYf_9J9mBjwRV6F7iov3VINkwrZsH7hCR1kOA-CdA,9519
+freedos_micro_python-0.1.0.dist-info/licenses/LICENSE,sha256=2LLG0iwPCJSbyBl2S_A-2S44bhxI9ebRYaiAGeC6Zh0,1337
+freedos_micro_python-0.1.0.dist-info/METADATA,sha256=ehF8LhedRJdWSiBmlkhw9gjBQm75-_mZw_8nzdeLO4w,4725
+freedos_micro_python-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+freedos_micro_python-0.1.0.dist-info/entry_points.txt,sha256=DCCG64mGnGhyCVkYRIWCl5yNwi_2XcvNc2ineYRqSIU,70
+freedos_micro_python-0.1.0.dist-info/top_level.txt,sha256=NB5PoXRRCfPJfnv7pEoSIiELl4b12Ka-zaU299QqhzQ,21
+freedos_micro_python-0.1.0.dist-info/RECORD,,

freedos_micro_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

freedos_micro_python-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+freedos-micropython = freedos_micro_python.cli:main