openwrt / openwrt/packages

packages/lang/Python/README.md is out-of-date

Open
#22,372 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Makefile
Stars
4.6k
Forks
4k
Avg merge
3d 12h
Merged PRs (30d)
134

Description

Maintainer: @jefferyto

The "Host-side Python packages for build" section of packages/lang/Python/README.md contains the following language:

These can be installed via pip and ideally they should only be installed like this, because it's a bit simpler than running them through the OpenWrt build system.

According to these instructions, installing a host Python package relies upon on a file specifying the requirements for that package being present in host-pip-requirements directory; however, the contents of that directory were removed in 3ee4e7297cf07b644bac3dfafc508da5f31bf63d. The new python-setuptools-scm Makefile does not seem to use pip at all, but rather downloads source tarballs from Pypi.

I have two questions:

  1. Is the new approach to installing host Python packages to write a Makefile in the style of python-setuptools-scm?
  2. Assuming the answer to the question above is yes, if I attempt to write a Makefile for a new host Python package, will I also be required to write a Makefile for each Python package that package depends upon?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with packages/lang/Python/README.md, the host-pip-requirements history at commit 3ee4e7297cf07b644bac3dfafc508da5f31bf63d, and the lang/python/python-setuptools-scm/Makefile. Confirm the current host-package workflow and dependency expectations with the relevant package metadata. Done means the README accurately documents the supported approach and required dependency handling.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
build-system, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.