Edit piwheels section of key projects#692
Conversation
| computers. Many Raspberry Pi users who use or develop Python tools to | ||
| run on Raspbian use Piwheels as their primary Python package index. | ||
| computers. pip in Raspbian is pre-configured to use piwheels.org as | ||
| an additional index to PyPI. |
There was a problem hiding this comment.
Is it additional? I have a feeling that it is the main one and PyPI is additional. It probably goes first because Pip seems to find things there if they exist, which only depends on the loading order...
There was a problem hiding this comment.
This is how it's configured:
[global]
extra-index-url=https://www.piwheels.org/simple
It's only generally "first" because pip prioritises bdist over sdist. If both provided bdist, it would go with PyPI.
There was a problem hiding this comment.
From my experience, if both have exactly the same wheel, piwheels one is selected. I think, I asked @pradyunsg about multiple indexes and he told me that whatever is found first wins, meaning that if indexes are randomly ordered internally, there's no guarantee that one will be prioritized over the other. Hence different people can get slightly different behavior...
There was a problem hiding this comment.
The behaviour is not random; index-url is always first, extra-index-url are selected based on the order of declaration. The above config would choose PyPI over piwheels (if the project publishes pi-compatible wheels).
There was a problem hiding this comment.
Well, then there's a bug. Because I hit the behavior I described a few times with Raspbian...
There was a problem hiding this comment.
If you could file a bug with a minimum repro in pip's issue tracker, that'd be great! ^>^
There was a problem hiding this comment.
I think it's more likely that was for another reason. If you can reproduce can you share with me? An issue on piwheels would be fine.
There was a problem hiding this comment.
@pradyunsg I think that the last time I faced it (cherrypy/cherrypy#1837 (comment)) is happening because of that scenario I sent you in Telegram. Not sure about the previous time which was about a year ago, I won't be able to reproduce the conditions now, I think. Maybe it was the same, maybe not.
@bennuttall looks like it's essentially because of piwheels/piwheels#208. So there's nothing else to file. Except maybe for an issue on the pip tracker with a proposal to improve warnings in this case.
| binary wheels that are optimized for installation onto Raspberry Pi | ||
| computers. Many Raspberry Pi users who use or develop Python tools to | ||
| run on Raspbian use Piwheels as their primary Python package index. | ||
| computers. pip in Raspbian is pre-configured to use piwheels.org as |
There was a problem hiding this comment.
If I'm not mistaken, Pip preferred spelling is capitalized:
| computers. pip in Raspbian is pre-configured to use piwheels.org as | |
| computers. Pip in Raspbian is pre-configured to use piwheels.org as |
There was a problem hiding this comment.
...or not. But it still seems weird that the first word in the sentence is lowercase
There was a problem hiding this comment.
"pip" is not capitalised anywhere else on that page. Yes it does seem weird at the start of a sentence. "conda" starts three sentences and two are capitalised...
There was a problem hiding this comment.
The preferred version seems to be “pip” since all occurrences on the documentation’s main page are lowercased.
There was a problem hiding this comment.
Yep -- the preferred capitalization for pip is indeed all lowercase. I want to note that explicitly somewhere in our documentation but haven't spent the time to figure out the right place to do so + do a push to fix incorrect occurrences in various visible places.
|
If I get a little time in the next few days I will review this PR. Thanks for making it.
Since the site and this page are already inconsistent in some matters of capitalization, I suggest that reviewers avoid bikeshedding over capitalization in this PR. If PyPUG has a style guide saying, for instance, how to deal with a lower-cased proper noun at the start of a sentence, then let's follow that. If there is no such style guide, let's either file an issue to fix up all of PyPUG to follow the English Wikipedia Manual of Style, or let's file an issue to make a similar document for PyPUG.
|
brainwane
left a comment
brainwane
left a comment
There was a problem hiding this comment.
Thanks for the update @bennuttall!
6 participants
Thanks to @brainwane for adding piwheels to key projects in #691. Just wanted to propose a couple of small changes: