changelog.md

Changelog

v1.10.0 | 2025-07-23

• Added support for Python 3.13.
• Switched from pip-licenses to pip-licenses-cli since the former doesn't seem to be maintained anymore and is falling behind on compatibility. See raimon49/pip-licenses#227. The matching pip_licenses_version option has been renamed to pip_licenses_cli_version.
• Updated default recipe options to pip v25.1.1, setuptools v80.9.0, and wheel v0.45.1.
• Dropped support for Conan v1.

v1.9.1 | 2024-06-17

• Fixed an issue where calling CMake with -DPython_EXECUTABLE=<system_python> created conflicts with the embedded Python (either a loud version error, or silently passing the wrong library paths). Some IDEs would pass this flag implicitly and it would hijack the find_package(Python) call used internally by this recipe. Now, we specifically protect against this since there should be no traces of system Python in a project that wishes to embed it.
• Provided an alternative to embedded_python_tools.symlink_import(). For dev builds, it's now possible to point PyConfig::home to the contents of bin/.embedded_python(-core).home to avoid needing to copy the entire Python environment into the build tree every time the project is reconfigured.

v1.9.0 | 2024-05-03

• Added support for Conan v2.
• Added support for Python 3.12.
• Updated default recipe options to pip v24.0, setuptools v69.5.1, wheel v0.43.0, and pip-licenses v4.4.0 for compatibility with Python 3.12.
• Dropped support for Python versions older than 3.11.5 in order to avoid maintaining both openssl v1 and v3.
• Removed the obsolete openssl_variant option.
• Removed redundant embedded_python:version option. Use embedded_python-core:version.

v1.8.2 | 2023-11-17

• Fixed a packaging error on Linux in case the bin directory was not created during build.
• Fixed openssl and zlib version compatibility by requiring version ranges instead of exact versions.

v1.8.1 | 2023-10-02

• Fixed packaging and runtime errors caused by conflicts with an incompatible system Python installation or pip packages installed in the user's home directory. The embedded Python now always run in isolated mode regardless of command line flags.
• Fixed packaging error on Windows when the Conan cache path contains spaces.
• Fixed Python include dirs being added twice (didn't cause any issues, just noise on the command line).
• Fixed openssl v3 mistakenly being enabled for Python 3.10. While 3.10 has preliminary support for openssl v3, Python 3.11 is the real minimum requirement for full support.
• Bumped default openssl to 1.1.1w for Python < 3.11 and v3.1.2 for Python >= 3.11.

v1.8.0 | 2023-07-12

• Added support for building with openssl v3 for Python 3.10 and newer.
• openssl v3.0.8 is now the default for Python >= 3.10 and openssl v1.1.1u is the default for Python 3.9.
• The openssl_variant is now obsolete. The flag is still there for backwards compatibility but it no longer does anything.
• The EmbeddedPython_EXECUTABLE CMake variable is now defined and points to the executable that's aware of the full embedded Python environment with pip packages. Python_EXECUTABLE points to the core executable that's only aware of the standard library. This split ensures that we compile and link against core in order to avoid rebuilding the world when only the Python environment packages change but the version/headers/libs stay the same.

v1.7.0 | 2023-06-22

• Recipe build performance and Conan cache usage have been improved further (on top of the improvements in v1.6.0) by optimizing the way licenses are gathered. The recipe now takes advantage of a new feature in pip-license v4.2.0 to gather licenses from an external environment. This way, we don't need to re-install packages just to gather licenses, thus cutting both build time and Conan cache usage in half.
• Reduced package size for Python >= 3.10 on macOS and Linux by removing the libpython*.a static library. This brings these platforms in line with the existing package for Windows. Only shared libraries are included.

v1.6.0 | 2023-06-07

• Added tests for Python 3.11 and set minimum supported Python version to 3.9.8.
• Recipe build performance has been improved significantly and Conan cache usage has been reduced:
  • In cases where only the packages option changes, the recipe no longer requires CPython to be re-compiled (Linux, macOS) or re-downloaded (Windows) every single time. Instead, we take advantage of the Conan cache: the new embedded_python-core package contains all baseline binaries (without any pip packages). embedded_python builds on top of -core by adding the pip packages and can reuse any compatible -core package from the cache.
  • The Python packages are now installed directly into the package folder instead of going via the build folder. This speeds up the packaging and reduces space usage since there's no more file duplication.
  • With Python >= 3.11, the recipe now makes use of the new ./configure --disable-test-modules option to avoid building and packaging CPython's internal tests.
  • On macOS and Linux, the Python standard library is now stored in a .zip file to reduce package size (as was already the case on Windows). This is controlled by the embedded_python-core:zip_stdlib option which can have the values of no, stored, or delflated.
• Updated default recipe options to pip v23.1.2, setuptools v67.8.0, and wheel v0.40.0 to improve compatibility with the latest PyPI packages.
• Updated default pip_licenses_version to v4.3.2 for compatibility with Python 3.11.
• Fixed a bug where deleting the recipe build folder would make the package unusable because the package folder accidentally contained symlinks to files in the build folder.
• Fixed a bug on Windows where pip install would fail for packages that needed to build a wheel from source (e.g git requirements).
• Fixed a bug on Windows where embedded_python_tools would fail when the source and destination were on different network drives. It will now fall back to files.copy() in case CreateJunction() is not possible.

v1.5.4 | 2023-05-02

• Removed the only usage of deprecated attribute deps_cpp_info of Conanfile from embedded_python_tools.py.

v1.5.3 | 2023-04-25

• Fixed a bug where the python version would be incorrectly cached between builds as the conan source method is only called once.

v1.5.2 | 2023-04-18

• Added a list of all installed packages to licenses/packages.txt.
• Fixed executable's hardcoded search path for libpython on macOS.

v1.5.1 | 2023-03-13

• Fixed bug where embedded_python will only use local zlib instead of the tool_requires one.

v1.5.0 | 2023-02-28

• Fixed symlink re-creation, in case already existing symlink was invalid
• Updated to conan v2 methods

v1.4.5 | 2022-07-15

• Fixed license collection failing with some packages on Windows (bumped default pip-licenses to v3.5.4 with the bug fix)
• Updated default recipe options to pip v22.1.2, setuptools v63.2.0, and wheel v0.37.1 to improve compatibility with the latest PyPI packages

v1.4.4 | 2022-03-30

• Fixed build with Python >= 3.9.11 and >= 3.10.3 on Windows (the installer changed)
• Fixed configuration with the Conan cmake_find_package generator
• Fixed Conan's .run(..., run_environment=True) not setting binary/library paths

v1.4.3 | 2022-01-28

• Worked around a CPython issue that prevented compilation of Python < 3.9.8 with clang 13: https://bugs.python.org/issue45405
• The recipe no longer depends on compiler.cppstd and compiler.libcxx so C++ settings changes will not cause a package rebuild

v1.4.2 | 2021-11-22

• Fixed missing zlib module on some Linux systems (added zlib to the list of build requirements)

v1.4.1 | 2021-11-05

• The versions of setuptools and wheel used to build the embedded environment are now user-configurable via the setuptools_version and wheel_version recipe options

v1.4.0 | 2021-10-12

• The versions of pip and pip-licenses used to build the embedded environment are now user-configurable via the pip_version and pip_licenses_version recipe options. If not given, they default to pip==21.2.4 and pip-licenses==3.5.3.
• Fixed issue with pip-licenses being incompatible with the newest pip version
• Fixed libffi segfault on macOS: use CPython built-in libffi instead of the Conan version

v1.3.4 | 2021-10-11

• Fixed portability issues on Linux: use more dependencies from Conan instead of the host system

v1.3.3 | 2021-09-30

• Fixed missing lzma module on some Linux systems (added xz_utils to the list of build requirements)

v1.3.2 | 2021-06-15

• Fixed packages option breaking if comments are present in the requirements.txt file

v1.3.1 | 2021-06-04

• Fixed very slow find_package(Python) on Windows

v1.3.0 | 2021-06-03

• Added support for Linux and macOS with a couple of caveats to be resolved later:
  • The standard library is not pre-compiled and zipped so it takes up more space than the Windows variant
  • The environment is not as locked down as the Windows variant: pip is still accessible in the final package
• The packages option now accepts the full contents of a requirements.txt file. Previously, the contents needed to be converted into a space-separated list (.replace("\n", " ")) and stripped of comments and markers.
• CMake will now automatically call find_package(Python) and ensure that the embedded distribution is found instead of a system-installed Python. Previously, consumer projects needed to do this manually.

v1.2.1 | 2021-02-15

• Fixed data and scripts not being installed with certain packages (e.g. nbconvert>=6.0)
• Updated the embedded setuptools to v53.0.0

v1.2.0 | 2020-06-08

• It's now possible to package any version of the embedded Python, independent of the version on the host system.
• Updated to pip-licenses v2.2.0: --with-license-file now finds British-style LICENCE files.

v1.1.0 | 2020-04-14

• Python's LICENSE.txt is now placed into the licenses directory.
• The licenses of all installed packages are now gathered using pip-licenses and written to licenses/package_licenses.txt.

v1.0.0 | 2020-02-17

Initial release