Add --shared to pipx install and pipx runpip.

[Darsstar]

Hi,

Is this something you folks would be willing to maintain?

Alternative aproaches to make pipx more suitable for private registries you might prefer which I am willing to implement:

• make keyring special and always share it
• support PIPX_PYTHONPATH

If there is interest in maintaining anything like this I will add tests, if not I will maintain this as my private fork without going through the effort of adding tests.

• I have added an entry to docs/changelog.md
• I have written documentation
• I have written tests

Summary of changes

Add --shared to pipx install and pipx runpip.

The main use case for it is as explained in the help text: providing keyring backends while creating virtual environments while pip is looking at private repositories which require authentication.
PYTHONPATH is not an option since pipx explicitly removes it from the dict of environment variables to be passed to the subprocess.
Injecting it after it is created would ia a chicken and the egg problem.

It still won't work out of the box. But now it should no longer be a deal-breaker and instead be, assuming PyPI is reachable, a slight hassle after installing pipx. Documentation should be able to alleviate this further.

Test plan

Tested by running

# command(s) to exercise these changes
pipx install -i https://pypi.org/simple/ --shared keyring-subprocess
pipx install -i https://pypi.org/simple/ keyring
pipx inject -i https://pypi.org/simple/ --include-apps keyring keyring-subprocess-landmark
pipx inject -i https://pypi.org/simple/ keyring artifacts-keyring

# now we are good to go! This should list pip, wheel, setup-tools and keyring-subprocess 
pipx runpip --shared list

pipx install black
pipx install ...

While the following would achieve the same thing, I hope we can all agree the above is better in the sense that we don't use pipx runpip and are thus able to use pipx upgrade. (Also

pipx runpip --shared install keyring-subprocess

[cs01]

Thanks for putting this together, and apologies for such a long wait time on the review (we are all volunteers so I hope you can understand).

I haven't used private pypi indexes before so I had to do a little reading to come up to speed on this, but I think I'm there now. For anyone else not familiar, keyring integrates with your OS's password manager, and pip will automatically load credentials for urls in saved in keyring (reference).

I see there is also a netrc, which should be automatically used by pip. Is there a reason you aren't using this instead? (I'm guessing because storing your password in plaintext isn't desirable, but wanted to confirm this was considered as an option).

[Darsstar]

Plaintext is one reason, yes. The other is that Azure DevOps Personal Access Tokens expire.

Microsoft's artifacts-keyring keyring backend handles that expiration problem.

Pipx solves weird dependecy conflicts I have been asked to help with. Artifacts-keyring reduces authentication related issues for me to help colleagues with by a lot.

Having these two (pipx & keyring) work together better would be nice for me, since I get to clean up our powershell script. (See the keyring-subprocess package's Readme if you are interested)
For other companies it might be the difference in whether they choose to use this excellent tool or not because they gave up sooner then I did.

Until I hear otherwise I'll assume I provided enough motivation for the feature and start working my way through the checklist.

[Darsstar]

Tests, documentation and changelog enties are now all ready for review as well.

I'm also mention my related PR for Pip pypa/pip#11029 in the hope that someone ends up there via this PR. As mentioned there I hope to create a PR that passes--no-input unless --verbose is passed as you mentioned in #219 (comment), but only once I have a way to make sure keyring is still used.

Edit: Tests failed on Windows. That is fixed now as well.

[pfmoore]

Note that in the next release, pip will include a --python option and will be supported when run from a zipapp. Those two changes will open up opportunities for changing the current shared-libs approach (which has a negative effect of making the shared libraries visible in every application venv, which might be an issue for apps that, for example, depend on a specific version of pip, which is unlikely but possible).

As a result, making the existence of the shared libraries visible in the user interface may be something we want to avoid, as it will make it harder to change.

[Darsstar]

I should probably repeat here what I said about this PR in my "vendor keyring & keyring-subprocess" PR: if that one gets merged this one would no longer be of any value to me. (And presumably potential Pipx users that want to retrieve credentials for private repositories with the keyring library.)

That is because it is more general: pyprojectx, something a colleague pointed out as something we should take a look at, would become viable as soon as we updated Pip.

[Darsstar]

Pip 23.1 included the --keyring-provider flag I contributed. Which makes this PR obsolete.