# virtualenv - pydoc - phpman

> **TLDR:** Create virtual isolated Python environments.
>
- Create a new environment:
  `virtualenv {{path/to/venv}}`
- Customize the prompt prefix:
  `virtualenv --prompt {{prompt_prefix}} {{path/to/venv}}`
- Use a different version of Python with virtualenv:
  `virtualenv {{-p|--python}} {{path/to/pythonbin}} {{path/to/venv}}`
- Start (select) the environment:
  `source {{path/to/venv}}/bin/activate`
- Stop the environment:
  `deactivate`

*Source: tldr-pages*

---

Help on package virtualenv:

## NAME
    virtualenv

## PACKAGE CONTENTS
    __main__
    activation (package)
    app_data (package)
    config (package)
    create (package)
    discovery (package)
    info
    report
    run (package)
    seed (package)
    util (package)
    version

## FUNCTIONS
### cli_run
        Create a virtual environment given some command line interface arguments.

        :param args: the command line arguments
        :param options: passing in a ``VirtualEnvOptions`` object allows return of the parsed options
        :param setup_logging: ``True`` if setup logging handlers, ``False`` to use handlers already registered
        :param env: environment variables to use
        :return: the session object of the creation (its structure for now is experimental and might change on short notice)

### session_via_cli
        Create a virtualenv session (same as cli_run, but this does not perform the creation). Use this if you just want to
        query what the virtual environment would look like, but not actually create it.

        :param args: the command line arguments
        :param options: passing in a ``VirtualEnvOptions`` object allows return of the parsed options
        :param setup_logging: ``True`` if setup logging handlers, ``False`` to use handlers already registered
        :param env: environment variables to use
        :return: the session object of the creation (its structure for now is experimental and might change on short notice)

## DATA
    __all__ = ('__version__', 'cli_run', 'session_via_cli')

## VERSION
    20.13.0+ds

## FILE
    /usr/lib/python3/dist-packages/virtualenv/__init__.py