ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Virtualenv

by AdrianLC ST3 Trending

Manage your virtualenvs directly from Sublime Text 3

Labels build system

Details

Installs

  • Total 7K
  • Win 2K
  • OS X 3K
  • Linux 2K
Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14 Apr 13 Apr 12 Apr 11 Apr 10 Apr 9 Apr 8 Apr 7 Apr 6 Apr 5 Apr 4 Apr 3 Apr 2 Apr 1 Mar 31 Mar 30 Mar 29 Mar 28 Mar 27 Mar 26 Mar 25 Mar 24 Mar 23 Mar 22 Mar 21 Mar 20 Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12 Mar 11
Windows 0 3 5 3 4 2 8 4 5 2 5 2 4 8 6 9 1 2 7 7 3 7 6 2 1 8 5 4 2 2 7 6 2 7 6 6 9 4 3 6 4 5 7 10 1 4
OS X 0 11 8 6 5 3 5 6 3 4 5 6 4 5 4 7 3 5 2 1 6 4 8 5 4 8 8 7 7 4 7 6 8 12 10 11 5 10 7 7 9 6 8 7 3 5
Linux 0 9 2 2 2 4 6 6 4 2 3 6 4 7 4 6 7 3 6 6 5 9 6 1 4 2 0 1 6 11 3 7 7 3 4 8 9 3 3 5 6 6 7 11 2 3

Readme

Source
raw.​githubusercontent.​com

Sublime Text - Virtualenv

Manage your virtualenvs directly from Sublime Text 3.

Features

  • Reusable build system. Execute code with a virtualenv without editing your paths manually.
  • Virtualenv search. Finds virtualenvs in the open folders or anywhere in your system.
  • Activation/Deactivation. Select or disable the current virtualenv easily.
  • Create and delete virtualenvs. With target python selection. Supports both the standard virtualenv package and the built-in venv module from Python 3.3.
  • Integration with other packages. SublimeREPL.

Support

Only Sublime Text 3. Tested in Linux and Windows but it should work in OS X as well.

Installation

Install through Package Control as usual:

  1. Open command palette through the menu or with Ctrl+Shift+P.
  2. Select Package Control: Install Package.
  3. Search Virtualenv and press enter.

Detailed instructions here.

Usage

Code Execution

Enable the Python + Virtualenv build system through the Tools -> Build System menu and execute with Ctrl+B. If you do not have any other custom Python builds defined, Automatic should work too.

The build system works with or without an activated virtualenv, so it can be used as default build for Python.

Activate

Search Virtualenv: Activate in the command palette and select the desired virtualenv.

Deactivate

The command Virtualenv: Deactivate is available when a virtualenv is activated.

Creating a virtualenv

Choose Virtualenv: New (or Virtualenv: New (venv) for built-in virtualenv), type a destination path and select a python binary. The new virtualenv will be activated automatically.

Deleting a virtualenv

Use the command Virtualenv: Remove, choose a virtualenv and confirm.

Integrations

Launch a Python REPL using the current virtualenv with the command Virtualenv: SublimeREPL - Python.

Settings

The list of default settings is available through Preferences -> Package Settings -> Virtualenv -> Default. Do not modify the default settings as you will lose all the changes if the package is updated. You should override the necessary settings in Package Settings -> Virtualenv -> User instead.

executable

The executable used for virtualenv creation. Defaults to python -m virtualenv, assuming that virtualenv is installed on the default python prefix. Depending on your setup you might want to change this to something like: virtualenv, virtualenv-3.3, python3 -m virtualenv, etc.

virtualenv_directories

A list of directory paths searched for virtualenvs. By default, includes virtualenvwrapper's WORKON_HOME. ~/.virtualenvs in Linux and OS X, and ~\Envs in Windows (virtualenvwrapper-win).

There is a shortcut command for quickly adding a virtualenv directory to your settings: Virtualenv: Add directory.

extra_paths

Additional paths searched for python binaries. It might be useful in case of portable python installations. Defaults to none.

Advanced

The current virtualenv path is stored in the project settings and can be edited manually if the project has been saved to a *.sublime-project file.

Extending or customizing the build system should be possible. Just set "target": "virtualenv_exec" in your build system definition, or import and inherit from Virtualenv.commands.VirtualenvExecCommand. More information on Sublime Text's build systems here.

Future plans

Just some ideas for possible improvements.

  • Integration with more packages. Paths for SublimeCodeIntel?
  • Brother package for pip commands.