-
-
Notifications
You must be signed in to change notification settings - Fork 12.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
python@3.12: tweak EXTERNALLY-MANAGED guidance #165681
python@3.12: tweak EXTERNALLY-MANAGED guidance #165681
Conversation
NB: I haven't marked a rebuild or anything else here, not sure if it's worth it. I figure the next patch/bugfix release can send this out as well. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Avoiding the multiple dash adjective lengthens the message but makes it clearer in a few places, plus some indicators of key text and commands would make it easier to read, methinks.
4422fe5
to
fd8237c
Compare
Formula/p/python@3.12.rb
Outdated
Expert users may restore the old behavior of pip by passing | ||
the '--break-system-packages' flag to pip, or by adding | ||
'break-system-packages = true' to their pip.conf file. The latter | ||
will permanently disable this warning. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe worth mentioning that it's strongly recommended to also pass/set --user
to avoid the risk of brew link
errors if you happen to install something brew ships.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah, good catch -- I think this should only mention the --user
case, since any other case is likely to break Homebrew + we strongly want to discourage anyways. I'll update today!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Updated, PTAL! Also fixed the use of second person to be consistent with the rest of the error.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me!
Co-authored-by: Colin Dean <colindean@users.noreply.github.com>
b78fa67
to
6e68ac8
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looking good 👍
HOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source <formula>
, where<formula>
is the name of the formula you're submitting?brew test <formula>
, where<formula>
is the name of the formula you're submitting?brew audit --strict <formula>
(after doingHOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source <formula>
)? If this is a new formula, does it passbrew audit --new <formula>
?Per https://github.com/orgs/Homebrew/discussions/3404#discussioncomment-8724311: this tweaks the
EXTERNALLY-MANAGED
marker on Python 3.12:--break-system-packages
escape hatch as something expert users can doWording feedback greatly appreciated 🙂