realpython / realpython/python-guide
Proposal: suggest python.org packages for macOS
Nobody has claimed this yet.
- Dominant language
- Batchfile
- Stars
- 29.8k
- Forks
- 5.9k
- PR merge metrics
- No merged PRs in 30d
Description
As @glyph pointed out in #359 and on twitter[0] using homebrew to install Python has its own issues. Also, brew install'ed versions of Python also mess with packaging[1][2] in ways that alter pip's behavior in odd ways (not even all documented). Is there any reason not to recomend installing the packages on python.org?
[0] https://twitter.com/glyph/status/950587032102780928
[1] https://docs.brew.sh/Homebrew-and-Python.html#note-on-pip-install---user
[2] https://github.com/Homebrew/brew/pull/821
[3] https://github.com/UnitedIncome/serverless-python-requirements#applebeersnake-mac-brew-installed-python-notes
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the macOS installation guidance in the guide and review the linked python.org and Homebrew references. Update the relevant recommendation to address Python.org packages, then verify that the cited links and explanation accurately reflect current installation and pip behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100