Download the dmenv installer, then run
python installer.py, or python3 installer.py, depending on how your Python interpreter is called. Just make
sure it's Python3, not 2.
The script will fetch pre-compiled binaries from GitHub. If you don't like that, use cargo install dmenv to build
from the sources.
In order to run, dmenv needs to know the path to the Python3 interpreter you will be using.
To do so, run:
console
$ dmenv add default /path/to/python3
Then, dmenv needs a setup.py file. If you don't have one yet, run
dmenv init --name <project name> to generate one. Make sure to read the comments inside and edit it to fit your needs.
Now you are ready to use dmenv!
Here's what dmenv lock does:
python -m venv in .venv/default. (Make sure to add .venv to your .gitignore).pip intall --editable .[dev] so that your dev deps are installed, and the scripts listed in entry_points are
created.pip freeze to generate a requirements.lock file.Now you can add requirements.lock, to your version control system, which leads us to the next command.
Now that the complete list of dependencies and their versions is written in the
requirements.lock file, anyone can run dmenv install to install all the
dependencies and get exactly the same versions you got when you ran dmenv lock.
Hooray reproducible builds!
As a convenience, you can use:dmenv run to run any binary from the virtualenv
dmenv show will show you the path of the virtualenv. No more, no less.
On Linux, you might use something like source $(dmenv show)/bin/activate to activate the virtualenv in your shell.
Tired of pip telling you to upgrade itself? Run dmenv upgrade-pip :)
It's exactly the same as typing dmenv run -- python -m pip install --upgrade pip, but with less keystrokes :P
To use a different Python version, run dmenv env pythons add <version> <path>, when path is the full
path to the python binary.
Alternatively, you can also edit the dmenv.toml config file, which should be located in
~/.config/dmenv/dmenv.toml on Linux~/Library/Application Support/dmenv/dmenv.toml on macOS%HOME%/AppData/Local/dmenv/dmenv.toml on WindowsThen you can use Python 3.8 with all the dmenv commands by prefixing them with dmenv --env 3.8.
An other virtualenv will be used in .venv/3.8 so that you can keep your default virtualenv in .venv/default.
Cool, no?
You may get this error message when using dmenv with old Python:
```
-> running /mnt/data/dmerej/src/dmenv/demo/.venv/3.6/bin/python -m pip freeze --exclude-editable
Error pip freeze failed:
Usage:
/mnt/data/dmerej/src/dmenv/demo/.venv/3.6/bin/python -m pip freeze [options]
no such option: --exclude-editable ```
The clue to the error is located right above:
You are using pip version 9.0.3, however version 18.1 is available.
Run dmenv upgrade-pip and the problem should go away.
(And learn to read the whole output of the commands you run :)
Q: How do I add dependencies to build the documentation?
A: Stick them in the dev section.
Q: What if I don't want to install the dev dependencies?
A: Don't use dmenv. Run pip install without [dev] extras. If you insist, maybe a --no-dev option will be added.
Q: How do I upgrade a dependency?
A: Just run dmenv lock again. If something breaks, either fix your code or use more precise version specifiers
Q: How do I depend on a git specific repo/branch?
A: Edit the requirements.lock by hand like this:
foo==0.1
https://gitlab.com/foo/bar@my-branch
Q: But that sucks and it will disappear when I re-run dmenv lock!
A: Yes that sucks. Feel free to:
* Open a pull request if you've forked an upstream project
* Use a local pipy mirror and a little bit of CI to publish your sources there
apt install python3-venv. But that's Debian's problem, not minesetup.py!Too bad. Don't use dmenv, then. poetry is cool.