CPython 3.14.7 cross-compiled for 64-bit AROS with the ABIv11 system
interface (the ABIv11 releases of deadwood2/AROS and systems built on them).
You run python and write ordinary Python code. This repository holds
everything needed to rebuild it: the patches, build scripts, package files,
tests and the reproducers for the platform problems found on the way.
0.1.0 preview is the first version, for testers and for running scripts. Binaries: releases. Three limits matter most:
- L1: a running script cannot be interrupted. Ctrl-C and
Breakdo not stop it. A script that does not end by itself needs a reboot. - L2: sockets work only in the main thread. In any other thread, name
lookup and
socket()fail. - L12: the network is not always ready after a boot. In 2 of 12 test
boots with a correct network configuration, network access failed. Once,
name lookup failed for every host for the whole boot. Once, checked 150 s
after the boot, the network stack was not available (a C program could
not open
bsdsocket.libraryeither); whether it would have started later was not established. A restart cleared it both times. The two cases were measured differently and are not known to share a cause.
Work on the port continues; see Further work.
Measured on the ABIv11 2026.09 release in QEMU; details in package/ACCEPTANCE.txt.
| Works | Does not work |
|---|---|
| Files and JSON | Interrupting a script with Ctrl-C or Break (L1) |
| 182 of the 205 standard library modules checked by the import probe import (importing a module does not show that all of it works) | Sockets outside the main thread (L2) |
| zlib, gzip, bz2, lzma, zipfile, tarfile | Starting processes: subprocess, os.popen, multiprocessing (this port has no way to create processes) |
| HTTPS with certificate and host name verification | ctypes, mmap, curses, readline, dbm, tkinter, termios, tty, pty |
| Threads, locks, queues, thread pools, timers | pip installing source distributions |
| pip installing pure-Python wheels | Loading additional native C/C++ extension modules (the built-in ones, such as ssl and the compression modules, work) |
| Several interpreters at the same time | locale.gettext() and the other C-level gettext functions |
| Many runs in one Shell | |
os.system |
Self-tests shipped in the package: wheel-test.py passes 6 of 6;
install-test.py passes 4 of 6, and the two failing checks are L2.
CPython's own test suite (Lib/test) does not pass as a whole. One pass
with this interpreter: of 492 test modules, 218 pass, 135 fail in some test
cases, 30 do not run (half of them because test.support needs the
resource module, which is not built), 84 are skipped as a whole, 24 did
not finish within 1500 s, 1 changed the environment. Details, causes and
the difference between failing functions and blocked tests:
docs/libtest-0.1.0.md. This is a preview.
What works, in an AROS Shell (paths are Unix-style: /RAM/x is RAM:x,
/Python/... is Python:...):
python -c "import sys; print(sys.version)"
python /RAM/script.py
python -c "import json; print(json.dumps({'a': [1, 2]}))"
python -c "import zipfile; z = zipfile.ZipFile('/RAM/a.zip', 'w'); z.writestr('x.txt', 'hi'); z.close()"
python -c "import urllib.request as u; print(u.urlopen('https://www.python.org').status)"
python -c "import threading; t = threading.Thread(target=print, args=('hi',)); t.start(); t.join()"
python -m pip install --no-index --no-build-isolation --target /Python/lib/python3.14/site-packages /RAM/some_package-1.0-py3-none-any.whl
What does not work yet:
python /RAM/endless.py # Ctrl-C does not stop it (L1)
# a socket or an HTTPS request in a worker thread fails (L2)
python -c "import subprocess; subprocess.run(['Echo', 'hi'])"
# OSError: aros does not support processes
python -c "import ctypes" # ModuleNotFoundError: No module named '_ctypes'
python -m pip install /RAM/some-package-1.0.tar.gz
# source distributions need subprocess
- The ABIv11 2026.09 release for x86_64 (tag
ABIv11_2026.09), installed on a hard disk. Other ABIv11 systems, including earlier AROS One releases, are not tested. z1.library,bz2.libraryand AROSTCP (bsdsocket.library), all part of that release.- The network running before python starts: the interpreter opens
bsdsocket.libraryat startup.
It does not run on mainline AROS (ABIv1).
Download the release archive, then follow README.txt inside it
(package/README.txt): unpack on the host, zip the
Python directory, unpack it on AROS with UnZip, copy it to SYS:Python,
install the launcher and reboot.
See docs/building.md. In short, with the ABIv11 GCC
10.5.0 cross compiler in $AROS_TOOLCHAIN and a host Python 3.14:
scripts/fetch-sources.sh # downloads, checked by SHA-256 (sources.txt)
scripts/prepare-source.sh # CPython 3.14.7 + patches/cpython
scripts/build-deps.sh # static OpenSSL, jitterentropy, liblzma
scripts/configure.sh
scripts/build.sh
scripts/build-package.sh # archives in work/dist| Path | Contents |
|---|---|
patches/cpython/ |
22 patches on CPython 3.14.7, one change each, with the reason in the message |
patches/*.diff |
OpenSSL 4.0.1, jitterentropy 3.7.0, and pip 26.2.1 (loading without mmap) |
config/config.site |
answers for cross-configure, each with its reason |
scripts/ |
environment, download, build and packaging |
package/ |
launcher, README, ACCEPTANCE, third-party notices and licenses |
tests/guest/ |
the test scripts run on AROS |
tests/c/ |
small C programs that reproduce the platform problems |
docs/ |
building, testing, platform notes |
- L1, interruption. The interpreter has to turn the task's break signal
into
KeyboardInterruptwhere it checks for pending signals, andtime.sleephas to wait for the break signal as well. This belongs in the interpreter and does not depend on terminal support. - L2, sockets in threads.
bsdsocket.librarygives each task its own library base and refuses calls through another task's base. The socket, select and ssl modules, and OpenSSL's socket I/O, need a base per thread. - Terminal support with the upcoming AROS terminal (aros-xterm).
termiosis disabled because the ABIv11 C library hastcgetattrandtcsetattrbut nottcsendbreak,tcdrain,tcflushandtcflow. aros-xterm implements equivalents of the last three, besides getting and setting attributes, but on AROS DOS handles, while Python uses numeric file descriptors; the existing bridge between the two has limits in handle lifetime, concurrency and I/O readiness. The plan is a joint review starting withtermiosandtty;ptycomes later, as it also depends on starting processes. A workingNewShell WINDOW XTERM:on ABIv11 is not yet a tested POSIX PTY. - More testing: other ABIv11 systems (AROS One), real hardware, longer runs, and more third-party pure-Python packages.
Problems in the ABIv11 system that this port works around, each with a reproducer: docs/platform-notes.md.
The files in this repository are under the BSD 3-Clause License
(LICENSE). The patches in patches/cpython/ modify CPython and
are offered under CPython's license (PSF License Agreement), like the code
they change. The package contains third-party components under their own
licenses; see package/THIRD-PARTY-NOTICES.txt
and package/licenses/.
Built on the work of the Python Software Foundation and the CPython developers, the OpenSSL project, Stephan Mueller (jitterentropy), the Tukaani project (xz), the SQLite developers, the Expat developers, Stefan Krah (mpdecimal), the HACL* authors, the pip maintainers, the curl project (CA bundle), and the AROS Development Team and deadwood2 (ABIv11 releases, SDK and toolchain).