From 3dd94f993d04fcc8f7f71626193243ca7bf4bb26 Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Wed, 3 Feb 2021 19:30:55 -0500 Subject: [PATCH] docs: add a note about the stability of python 3 formulae --- docs/Homebrew-and-Python.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/Homebrew-and-Python.md b/docs/Homebrew-and-Python.md index 0ebdde901d..6182b7b921 100644 --- a/docs/Homebrew-and-Python.md +++ b/docs/Homebrew-and-Python.md @@ -13,6 +13,12 @@ Homebrew provided a `python@2` formula until the end of 2019, at which point it ## Python 3.x Homebrew provides a formula for Python 3.x (`python@3.x`). +**Important:** Homebrew does not guarantee that Python 3, once installed, remains the same version. +In particular, Homebrew may choose to upgrade the minor or patch version of Python 3, which may in +turn break any custom virtual environments that use the Homebrewed Python. Python developers +who expect virtual environment stability should consider using a Python version manager rather than +the Homebrewed Python. + The executables are organised as follows: * `python3` points to Homebrew's Python 3.x (if installed)