Project Status

There is support for producing CPython distributions for Windows, macOS, Linux, and iOS. All distributions are highly self-contained and have limited shared library dependencies.

Planned and features include:

  • Static/dynamic linking toggles for dependencies
  • Support for configuring which toolchain/version to use
  • Support for BSDs
  • Support for Android
  • Support for Python distributions that aren’t CPython

Target Notes

Non-Darwin Apple Targets

Apple targets that aren’t Darwin/macOS (iOS, tvOS, watchOS, and corresponding simulators) are considered alpha quality. The builds may or may not work. The builds haven’t been widely tested.

Only Python 3.9 is currently supported.

Non-x86 Linux Targets

Linux targets for non-x86 (not i686-* or x86_64-*) are considered alpha quality.

The Linux cross builds use a different build environment based on Debian Stretch (as opposed to Debian Jessie) and they use the cross tools Debian packages (as opposed to using a modern Clang built from source).

These builds haven’t been widely tested. There are likely several rough edges with them.

Only Python 3.9 is currently supported.

Test Failures

This repository contains test-distribution.py script that can be used to run the Python test harness from a distribution archive.

Here, we track the various known failures when running test-distribution.py /path/to/distribution.tar.zst -u all.

test__locale

Known failing on: Windows

This test fails as follows:

======================================================================
ERROR: test_float_parsing (test.test__locale._LocaleTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmpjx7a33kd\python\install\lib\test\test__locale.py", line 184, in test_float_parsing
    if localeconv()['decimal_point'] != '.':
UnicodeDecodeError: 'locale' codec can't decode byte 0xa0 in position 0: decoding error

======================================================================
ERROR: test_lc_numeric_localeconv (test.test__locale._LocaleTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmpjx7a33kd\python\install\lib\test\test__locale.py", line 130, in test_lc_numeric_localeconv
    formatting = localeconv()
UnicodeDecodeError: 'locale' codec can't decode byte 0xa0 in position 0: decoding error

----------------------------------------------------------------------

test_locale

Known failing on: Windows

This test fails on Windows:

======================================================================
ERROR: test_getsetlocale_issue1813 (test.test_locale.TestMiscellaneous)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test_locale.py", line 567, in test_getsetlocale_issue1813
    locale.setlocale(locale.LC_CTYPE, loc)
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\locale.py", line 608, in setlocale
    return _setlocale(category, locale)
locale.Error: unsupported locale setting

----------------------------------------------------------------------

test_subprocess

Known Failing on: Linux

This fails in the following manner:

test_executable_without_cwd (test.test_subprocess.ProcessTestCaseNoPoll) ... Could not find platform independent libraries <prefix>
Could not find platform dependent libraries <exec_prefix>
Consider setting $PYTHONHOME to <prefix>[:<exec_prefix>]
Fatal Python error: initfsencoding: Unable to get the locale encoding
ModuleNotFoundError: No module named 'encodings'

Current thread 0x00007fd77c231740 (most recent call first):
FAIL

======================================================================
FAIL: test_executable_without_cwd (test.test_subprocess.ProcessTestCaseNoPoll)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/tmp/tmp8hef0kr4/python/install/lib/python3.7/test/test_subprocess.py", line 436, in test_executable_without_cwd
    executable=sys.executable)
  File "/tmp/tmp8hef0kr4/python/install/lib/python3.7/test/test_subprocess.py", line 355, in _assert_cwd
    self.assertEqual(47, p.returncode)
AssertionError: 47 != -6

We’re unsure what is going on here. The error from initfsencoding is what happens when the first import during Py_Initialize() fails. So it appears the test somehow can’t locate the Python standard library.

test_tk

Known Failing on: Linux

This fails in the following manner:

======================================================================
FAIL: test_from (tkinter.test.test_tkinter.test_widgets.ScaleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/tmp/tmpoqqjd5gi/python/install/lib/python3.7/tkinter/test/test_tkinter/test_widgets.py", line 867, in test_from
    self.checkFloatParam(widget, 'from', 100, 14.9, 15.1, conv=float_round)
  File "/tmp/tmpoqqjd5gi/python/install/lib/python3.7/tkinter/test/widget_tests.py", line 106, in checkFloatParam
    self.checkParam(widget, name, value, conv=conv, **kwargs)
  File "/tmp/tmpoqqjd5gi/python/install/lib/python3.7/tkinter/test/widget_tests.py", line 63, in checkParam
    self.assertEqual2(widget[name], expected, eq=eq)
  File "/tmp/tmpoqqjd5gi/python/install/lib/python3.7/tkinter/test/widget_tests.py", line 47, in assertEqual2
    self.assertEqual(actual, expected, msg)
AssertionError: 14.9 != 15.0

This seems like a minor issue and might be a bug in the test itself.

test_winconsoleio

This fails as follows:

======================================================================
ERROR: test_ctrl_z (test.test_winconsoleio.WindowsConsoleIOTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test_winconsoleio.py", line 190, in test_ctrl_z
    a, b = stdin.read(1), stdin.readall()
OSError: [WinError 87] The parameter is incorrect

======================================================================
ERROR: test_input (test.test_winconsoleio.WindowsConsoleIOTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test_winconsoleio.py", line 144, in test_input
    self.assertStdinRoundTrip('abc123')
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test_winconsoleio.py", line 137, in assertStdinRoundTrip
    actual = input()
OSError: [WinError 87] The parameter is incorrect

======================================================================
FAIL: test_partial_reads (test.test_winconsoleio.WindowsConsoleIOTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test_winconsoleio.py", line 166, in test_partial_reads
    self.assertEqual(actual, expected, 'stdin.read({})'.format(read_count))
AssertionError: b'\r\n' != b'\xcf\xbc\xd1\x9e\xd0\xa2\xce\xbb\xd0\xa4\xd0\x99\r\n' : stdin.read(1)

======================================================================
FAIL: test_partial_surrogate_reads (test.test_winconsoleio.WindowsConsoleIOTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test_winconsoleio.py", line 183, in test_partial_surrogate_reads
    self.assertEqual(actual, expected, 'stdin.read({})'.format(read_count))
AssertionError: b'\xc3\x84\r\n' != b'\xf4\x81\xbf\xbf\xf4\x81\x80\x81\r\n' : stdin.read(1)

----------------------------------------------------------------------

Ran 10 tests in 0.006s

FAILED (failures=2, errors=2)
test test_winconsoleio failed
0:00:00 Re-running test__locale in verbose mode
test_float_parsing (test.test__locale._LocaleTests) ... ERROR
test_lc_numeric_basic (test.test__locale._LocaleTests) ... skipped 'nl_langinfo is not available'
test_lc_numeric_localeconv (test.test__locale._LocaleTests) ... ERROR
test_lc_numeric_nl_langinfo (test.test__locale._LocaleTests) ... skipped 'nl_langinfo is not available'

======================================================================
ERROR: test_float_parsing (test.test__locale._LocaleTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test__locale.py", line 184, in test_float_parsing
    if localeconv()['decimal_point'] != '.':
UnicodeDecodeError: 'locale' codec can't decode byte 0xa0 in position 0: decoding error

======================================================================
ERROR: test_lc_numeric_localeconv (test.test__locale._LocaleTests)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "C:\Users\gps\AppData\Local\Temp\tmp8m94v2m5\python\install\lib\test\test__locale.py", line 130, in test_lc_numeric_localeconv
    formatting = localeconv()
UnicodeDecodeError: 'locale' codec can't decode byte 0xa0 in position 0: decoding error

----------------------------------------------------------------------

Test Skips

Linux

The following tests are skipped on Linux:

test_asdl_parser
test irrelevant for an installed Python
test_clinic
install/lib/Tools/clinic’ path does not exist
test_dbm_gnu
No module named ‘_gdbm’
test_devpoll
test works only on Solaris OS family
test_gdb
test_gdb only works on source builds at the moment.
test_kqueue
test works only on BSD
test_msilib
No module named ‘msilib’
test_ossaudiodev
[Errno 2] No such file or directory: ‘/dev/dsp’
test_startfile
object <module ‘os’ from ‘…/install/lib/python3.7/os.py’> has no attribute ‘startfile’
test_winconsoleio
test only relevant on win32
test_winreg
No module named ‘winreg’
test_winsound
No module named ‘winsound’
test_zipfile64
test requires loads of disk-space bytes and a long time to run

macOS

The following tests are skipped on macOS:

test_asdl_parser
test irrelevant for an installed Python
test_clinic
python/install/lib/Tools/clinic’ path does not exist
test_dbm_gnu
No module named ‘_gdbm’
test_devpoll
test works only on Solaris OS family
test_epoll
test works only on Linux 2.6
test_gdb
Couldn’t find gdb on the path
test_msilib
No module named ‘msilib’
test_multiprocessing_fork
test may crash on macOS (bpo-33725)
test_nis
No module named ‘nis’
test_ossaudiodev
No module named ‘ossaudiodev’
test_spwd
No module named ‘spwd’
test_startfile
object <module ‘os’ from ‘…/install/lib/python3.7/os.py’> has no attribute ‘startfile’
test_tix
cannot run without OS X gui process
test_tk
cannot run without OS X gui process
test_ttk_guionly
cannot run without OS X gui process
test_winconsoleio
test only relevant on win32
test_winreg
No module named ‘winreg’
test_winsound
No module named ‘winsound’
test_zipfile64
test requires loads of disk-space bytes and a long time to run