This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Figure out how to best leverage pip in devinabox
Type: Stage: needs patch
Components: Versions:
process
Status: closed Resolution: third party
Dependencies: Superseder:
Assigned To: Nosy List: brett.cannon, dstufft, ncoghlan, r.david.murray
Priority: low Keywords:

Created on 2014-03-21 16:59 by brett.cannon, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (3)
msg214390 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2014-03-21 16:59
Probably the most complicated bit now for using devinabox is building the various bits of docs in a way that doesn't require mucking with the system python:

* Having Python built
* Creating a venv
* Installing sphinx
* Running the requisite Makefile with the proper envvar overridden to point to the venv

I see a couple of ways of handling this:

* Assume people know how to do the above
* Verbally instruct people on how to do these steps
* Provide a requirements.txt file for sphinx and coverage -- two birds w/ one stone =) -- and instruct on how to install from that
* Provide a setup_venv script and then instruct on the doc building
* Provide a build.py script which takes named commands like 'docs', 'peps', etc. and then does the right thing automatically

There is also the question of whether any of this should make its way up into the devguide, etc.

My gut says that we should rename README to SPRINT_LEADERS and then provide a README for the sprint participants which lays out the commands along with comments on where to learn more about what's going on. We don't have to advertise that the doc is actually a shell script that we can use to verify the steps are all correct. =) This way they have to grasp the concept of how to build, make a venv, use pip, etc. We can also make sure that there are no documentation holes outside of devinabox for any one step.

Another way to utilize pip is to use it to download all the files necessary to build the docs and get coverage so that offline installations can occur. Not sure what's the easiest way to make pip just download projects and their deps in a way that allows for easily pointing pip at something and say "install from here", but I suspect there's a way (using just wheels is a little tricky as markupsafe has an accelerator and coverage has to be compiled).

IOW how do we get contributors using venv and pip effectively w/o training them only on how to do things in a devinabox instance?
msg214392 - (view) Author: Donald Stufft (dstufft) * (Python committer) Date: 2014-03-21 17:42
Right now you can do ``pip install --download some/path --no-use-wheel <stuff>`` and then ``pip install --no-index --find-links some/path <stuff>``

In the future that'll be ``pip download`` instead probably.
msg265163 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-05-08 20:11
Devinabox has moved to its own project at https://github.com/python/devinabox/issues/3
History
Date User Action Args
2022-04-11 14:58:00adminsetgithub: 65211
2016-05-08 20:11:22brett.cannonsetstatus: open -> closed
resolution: third party
messages: + msg265163
2014-03-21 17:42:42dstufftsetnosy: + dstufft
messages: + msg214392
2014-03-21 16:59:22brett.cannoncreate