use pipenv for development dependencies and running tests

[belm0]

e.g. see Pipfile and Makefile in https://github.com/requests/requests

[belm0]

https://chriswarrick.com/blog/2018/07/17/pipenv-promises-a-lot-delivers-very-little/

virtualenvwrapper and pip-tools may be a better approach

[mehaase]

I am enjoying pipenv on the other project where I'm trying it out. The only gripe I have right now is that it can be pretty slow to lock packages.

On the other hand, Read The Docs can only install from setup.py or requirements.txt. It's not aware of Pipfile, so pipenv would be a bit annoying. It has a feature to generate requirements.txt but we'd have to remember to run it every time anybody updates a pinned dependency.

I don't know pip-tools yet, but that looks like a promising way forward.

[belm0]

Re. Sphinx, how about keeping extras in requirements-extra.txt instead of setup.py? read docs must support it, e.g. trio does this.

[belm0]

the sphinx issue is increasing our product dependencies by about 25%, I'd like to see that resolved

[mehaase]

I'm trying out pip-tools this morning. I like it, but its author recommends Pipenv instead:

Note: While the principles outlined in this blog post still very much apply, your tool of choice these days should be Pipenv.

But PyPA still recommends pip-tools as an alternative to Pipenv:

If you find this particular approach to managing application dependencies isn’t working well for you or your use case, you may want to explore … pip-tools to build your own custom workflow from lower level pieces like pip-compile and pip-sync

Anyway… I have a working setup that I will commit in a few minutes.

[mehaase]

Closed via #78.