aboutsummaryrefslogtreecommitdiff
path: root/lang/python/README.md
Commit message (Collapse)AuthorAge
* python3: Add Py3Build/InstallBuildDepends recipeJeffery To2022-03-17
| | | | | | | | | | | This adds a recipe, Py3Build/InstallBuildDepends, that installs the requirements listed in HOST_PYTHON3_PACKAGE_BUILD_DEPENDS. This allows other (non-Python) packages to install host Python packages by calling this recipe, without having to know the internals of python3-package.mk. This also updates apparmor to call this recipe. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Use locked for host pipJeffery To2020-08-31
| | | | | | | This also removes PKG_BUILD_PARALLEL:=0 that was added for packages that use HOST_PYTHON3_PACKAGE_BUILD_DEPENDS. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python3: Use hash-checking mode when installing host pip packagesJeffery To2020-08-17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | In hash-checking mode[1], pip will verify downloaded package archives (source tarballs in our case) against known SHA256 hashes before installing the packages. As a consequence, this requires the use of requirements files[2] and pinning packages to known versions. The syntax for package Makefiles has changed slightly; HOST_PYTHON3_PACKAGE_BUILD_DEPENDS no longer accepts requirement specifiers like "foo>=1.0", only requirements file names (which are the same as package names in the most common case). This also updates affected packages, in particular: * python-zipp: "setuptools_scm[toml]" has been split into "setuptools-scm toml" to reuse the requirements file for setuptools-scm (the extra depends installed by "setuptools_scm[toml]" is toml). * python-pycparser: This previously used ply 3.10, whereas the requirements file will now install 3.11. [1]: https://pip.pypa.io/en/stable/reference/pip_install/#hash-checking-mode [2]: https://pip.pypa.io/en/stable/user_guide/#requirements-files Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python-packages: Disable parallel build when host pip is neededJeffery To2020-06-30
| | | | | | | | | | | | | | | | | | This adds PKG_BUILD_PARALLEL:=0 to packages that depend on host Python packages (HOST_PYTHON3_PACKAGE_BUILD_DEPENDS), because installing packages with multiple concurrent pip processes can lead to errors or unexpected results[1]. This also: * Move HOST_PYTHON3_PACKAGE_BUILD_DEPENDS definitions to before python3-package.mk is included * Update Python folder readme to include PKG_BUILD_PARALLEL:=0 [1]: https://github.com/pypa/pip/issues/2361 Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Revise pypi.mk section of readmeJeffery To2020-06-11
| | | | Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Fix relative links in readmeJeffery To2020-06-11
| | | | | | | This also removes a link to pypi.org; the previous sentence already links to pypi.org, a second link in the same paragraph isn't necessary. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Remove references to variants in readmeJeffery To2020-06-11
| | | | | | Build variants are no longer necessary. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python3: Add script to help find standard library dependenciesJeffery To2020-05-14
| | | | | | | | | | | | | | | This adds a script that searches a Python package's source code to find imports for separately-packaged standard library modules. The script can be run by calling make with the configure target and "PY3=stdlib V=s" arguments, e.g. make package/python3-lxml/configure PY3=stdlib V=s This also updates the readme on how to call this script, as well as more information on Python package dependencies in general. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Update readmeJeffery To2020-04-04
| | | | | | | | | | * Replace the Python 2 pending removal notice/schedule with a brief message about the removal * Replace mentions of "Python & Python 3" with just "Python" (references to the version number are kept only in cases where it is necessary) * Update Makefile example code to use Python 3 conventions/names Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: readme: drop from table of contents removed sectionsJosef Schlehofer2020-01-27
| | | | | | | Fixes: 446bc30c527e8c6d24279f21e9e4f7562f98ab67 ("python: Remove PKG_BUILD_DIR/PKG_UNPACK sections from readme") Signed-off-by: Josef Schlehofer <pepe.schlehofer@gmail.com>
* python: Fix filespec example in readmeJeffery To2019-11-07
| | | | | | | | | | | While the filespec example is technically correct, the more likely scenario is that the files to be omitted would be inside of a package subdirectory. This adds an example_package directory into the example to illustrate this case. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Add pypi.mk usage to readmeJeffery To2019-11-05
| | | | | | | This adds documentation on including pypi.mk and its required/optional variables to the Python section readme. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Remove PKG_BUILD_DIR/PKG_UNPACK sections from readmeJeffery To2019-11-05
| | | | | | | | PKG_BUILD_DIR now takes variants into account (openwrt/openwrt@e545fac8d968864a965edb9e50c6f90940b0a6c9), so it should not be necessary for Python packages to set these variables anymore. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Clarify README for Python 2-only librariesJeffery To2019-06-19
| | | | | | | | This clarifies that Python 2-only libraries will have a Python 3 version added, instead of being replaced by a Python 3 version (before the 2020 mass removal). Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* lang: python: readme: document mechanism for corner-case ↵Alexandru Ardelean2019-05-28
| | | | | | | | | | | | | | | | python[3]-package.mk location After some thinking over this, documenting this behavior makes sense versus adding some functionst to handle this. There is some validity/use-cases where some users may want to reference a python[3]-package.mk from some other location as well as have the flexibility to change it (locally). One example can be when the local `packages` is renamed to something else. This does not fall on the responsibility of the Python maintainers, but it can be documented. Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
* python: README.md: adjust recursive dep text, miscEneas U de Queiroz2019-05-20
| | | | | | | | | | Adding the conditionals to DEPENDS should not cause circular dependencies any more. This adjusts the text to point out that it used to be a problem, and if it happens again, one should open an issue. Also, some spotted trivial errors were fixed. Signed-off-by: Eneas U de Queiroz <cote2004-github@yahoo.com>
* lang/python/README.md: add note about use in other packages feedsAlexandru Ardelean2019-05-08
| | | | | | | By popular demand, via: https://github.com/openwrt/packages/issues/8892#issuecomment-489992926 Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
* Merge pull request #8786 from commodo/readme-encodings-updateRosen Penev2019-05-03
|\ | | | | python/README.md: fix note about python[3]-codecs
| * python/README.md: fix note about python[3]-codecsAlexandru Ardelean2019-05-03
| | | | | | | | | | | | | | The note was note correct when mentioning encodings vs python[3]-codecs. This change fixes this confusion. Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
* | python/README: Add deprecation notice / scheduleJeffery To2019-05-04
|/ | | | | | | | | | | | | | | | This describes the proposal outlined in #8520, with a few additions/modifications: * Describes the handling of the Python 2 interpreter * Allows for normal updates of Python 2 libraries that share the same Makefile as their Python 3 version * Mass removal event has a name Supersedes #8788. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* python: Update readmeJeffery To2019-04-08
| | | | | | | This adds more details on the PYTHON[3]_PKG_SETUP_* variables, the filespec format, and the build/install processes in general. Signed-off-by: Jeffery To <jeffery.to@gmail.com>
* lang/python/README.md: add doc describing the lang/python subtreeAlexandru Ardelean2019-01-08
It was a semi-popular request a while back that I put off for a while. Here's a quick doc. I'll update it later as things change and I don't forget. It also lets other people update if something is wrong. Signed-off-by: Alexandru Ardelean <ardeleanalex@gmail.com>
Powered by cgit, Themed by Ted Yin.