# dmenv goodies

`dmenv` also comes with a few commands for carrying out boring tasks. You can
view the full list by running `dmenv help`, here are a few more details:


## dmenv run

You can use:`dmenv run` to run any binary from the virtual environment. If the program you want to run
needs command-line options, use a `--` separator, like so:

```console
dmenv run -- pytest --collect-only
```

## dmenv upgrade-pip

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



## dmenv show:venv_path

`dmenv show:venv_path` shows the path of the current virtual environment. Nothing more, nothing less.


## dmenv show:bin_path

`dmenv show:bin_path` shows the path of the virtual environment's binaries.

You can use it in CI scripts like this:

```yaml
script:
  - dmenv install
  - export PATH=$(dmenv show:bin_path):$PATH
```


## dmenv show:deps

Just a wrapper for `pip list`:

```bash
$ dmenv show:deps
Package            Version
------------------ -------
atomicwrites       1.2.1
attrs              18.2.0
importlib-metadata 0.6
...
```

## dmenv bump-in-lock

You can use `bump-in-lock` to bump versions directly in the `requirements.lock` file:

```text
# contents of requirements.lock:
bar==0.3
foo==1.2

$ dmenv bump-in-lock bar 0.4

# new contents:
bar==0.4
foo==1.2
```

If you used a git URL in the `requirements.lock` file, you can also bump the git reference:

```text
# contents of requirements.lock:
bar==0.3
foo==git@gitlab.com/foo/foo@master#egg=foo

$ dmenv bump-in-lock --git foo deadbeef
bar==0.3
foo==git@gitlab.com/foo/foo@deadbeef#egg=foo
```

## dmenv process-scripts

If you set the `DMENV_SCRIPTS_PATH` environment variable to a writeable directory in your $PATH,
you can run `dmenv process-scripts` in any project, and it will create a script there for all the "console" entry points defined in `setup.cfg`:

```bash
$ export DMENV_SCRIPTS_PATH=$HOME/.local/bin
$ cd foo-project
$ cat foo/main.py
def main():
    print("Hello, this is foo")
$ cat setup.cfg

[options.entry_points]
console_scripts = foo=foo:main

$ dmenv process-scripts
$ There is now a file named `foo` in `~/.local/bin`, so this works:
$ foo
Hello, this is foo
```