Skip to content

Commit

Permalink
Update platform tags based on default/supported set for 1.11
Browse files Browse the repository at this point in the history
See #113
  • Loading branch information
rdb committed Dec 22, 2021
1 parent 3219c30 commit bfb1fc7
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 29 deletions.
34 changes: 9 additions & 25 deletions distribution/building-binaries.rst
Original file line number Diff line number Diff line change
Expand Up @@ -194,24 +194,21 @@ By default, Panda3D will build for 64-bit versions of Windows, macOS and Linux.
More specifically, *platform tags* are used to specify the minimum version and
architecture of the operating system supported by a Python package. You can
specify these platforms explicitly to customize the targeted platforms and their
versions. The default set, as of Python 3.7, is as follows:
versions. The default set is as follows:

.. code-block:: python
'platforms': ['manylinux1_x86_64', 'macosx_10_6_x86_64', 'win_amd64'],
On more recent versions of Python, newer defaults are used. See the list below
for details.
'platforms': ['manylinux2010_x86_64', 'macosx_10_9_x86_64', 'win_amd64'],
Sometimes, it is desirable to use third-party packages that do not provide
wheels for a given platform. For example, the latest version of numpy no longer
publishes wheels for ``manylinux1_x86_64`` or ``macosx_10_6_x86_64``. If you
wish to use the latest version of numpy, then you need to therefore set the
platform tags to increase these versions:
wheels for a given platform. For example, a package may no longer publish wheels
for a ``manylinux2010_x86_64``, but only for ``manylinux2014_x86_64``. If you
wish to use this package, then you need to therefore set the platform tags to
increase these versions:

.. code-block:: python
'platforms': ['manylinux2010_x86_64', 'macosx_10_9_x86_64', 'win_amd64'],
'platforms': ['manylinux2014_x86_64', 'macosx_10_9_x86_64', 'win_amd64'],
.. list-table:: List of Platforms
:widths: 20, 80
Expand All @@ -220,24 +217,12 @@ platform tags to increase these versions:
- 64-bit Windows systems (including Intel x64 processors).
* - win32
- 32-bit Windows systems, rarely used nowadays.
* - manylinux1_x86_64
- Set this to target the oldest 64-bit Linux distributions. No longer
supported as of Python 3.10, where manylinux2010_x86_64 is silently used
as default.
* - manylinux1_i686
- Set this to target the oldest 32-bit Linux distributions.
* - manylinux2010_x86_64
- Target 64-bit Linux distributions more recent than (more or less) 2010.
* - manylinux2010_i686
- Target 32-bit Linux distributions more recent than (more or less) 2010.
* - macosx_10_9_x86_64
- Target Intel Macs running OS X Mavericks or higher. Recommended.
* - macosx_10_6_x86_64
- Target 64-bit Intel Macs running Mac OS X Snow Leopard or above.
No longer supported as of Python 3.8.
* - macosx_10_6_i386
- Target 32-bit Intel Macs running Mac OS X Snow Leopard or above.
No longer supported as of Python 3.8.

.. note::

Expand All @@ -249,9 +234,8 @@ Icons
-----

On Windows and macOS, it is possible to change the icon that is shown in file
browsers or the dock for the compiled executable. This feature requires Panda3D
1.10.4 or later. To use this feature, modify the ``setup.py`` file to something
like the following:
browsers or the dock for the compiled executable. To use this feature, modify
the ``setup.py`` file to something like the following:

.. code-block:: python
Expand Down
2 changes: 1 addition & 1 deletion distribution/packaging-binaries.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The ``bdist_apps`` command will make use of ``build_apps.build_base`` and
installers
A dictionary of installers/packages to create for each platform (keys are
strings for the platform, values are strings representing installers,
defaults to gztar for manylinux1_x86_64/manylinux1_i386 and zip for
defaults to gztar for manylinux2010_x86_64/manylinux2010_i386 and zip for
everything else)

Installers
Expand Down
6 changes: 3 additions & 3 deletions distribution/setuptools-examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Then, we can build the binaries using ``python setup.py build_apps``.

A ``build`` directory will be created and contain a directory for each platform
that binaries were built for. Since no platforms were specified, the defaults
were used (manylinux1_x86_64, macosx_10_6_x86_64, win_amd64).
were used (manylinux2010_x86_64, macosx_10_9_x86_64, win_amd64).

Note, win32 is missing from the defaults. If a win32 build is desired, then
platforms must be defined in ``setup.py`` and ``win_amd64`` added to the list:
Expand All @@ -54,8 +54,8 @@ platforms must be defined in ``setup.py`` and ``win_amd64`` added to the list:
'build_apps': {
'console_apps': {'hello_world': 'main.py'},
'platforms': [
'manylinux1_x86_64',
'macosx_10_6_x86_64',
'manylinux2010_x86_64',
'macosx_10_9_x86_64',
'win_amd64',
'win32',
],
Expand Down

0 comments on commit bfb1fc7

Please sign in to comment.