Doc Doc - 3 months ago 15
Python Question

Sublime text3 and virtualenvs

I'm totally new with sublime3, but i couldn't find anything helpful for my problem...

I've differents virtualenvs (made with virtualenwrapper) and I'd like to be able to specify which venv to use with each project

Since I'm using SublimeREPL plugin to have custom builds, how can i specify which python installation to build my project with?

for example, when i work on project A i want to run scripts with venvA's python, and when i work on project B i want to run things with venvB (using a different build script)

sorry my terrible english...


Hopefully this is along the lines you are imagining. I attempted to simplify my solution and remove some things you likely do not need.

The advantages of this method are:

  • Single button press to launch a SublimeREPL with correct interpreter and run a file in it if desired.
  • After setting the interpreter, no changes or extra steps are necessary when switching between projects.
  • Can be easily extended to automatically pick up project specific environment variables, desired working directories, run tests, open a Django shell, etc.

Let me know if you have any questions, or if I totally missed the mark on what you're looking to do.

Set Project's Python Interpreter

  1. Open our project file for editing:

    Project -> Edit Project
  2. Add a new key to the project's settings that points to the desired virtualenv:

    "settings": {
        "python_interpreter": "/home/user/.virtualenvs/example/bin/python"

A "python_interpreter" project settings key is also used by plugins like Anaconda.

Create plugin to grab this setting and launch a SublimeREPL

  1. Browse to Sublime Text's Packages directory:

    Preferences -> Browse Packages...
  2. Create a new python file for our plugin, something like:

  3. Copy the following python code into this new file:

    import sublime_plugin
    class ProjectVenvReplCommand(sublime_plugin.TextCommand):
        Starts a SublimeREPL, attempting to use project's specified
        python interpreter.
        def run(self, edit, open_file='$file'):
            """Called on project_venv_repl command"""
            cmd_list = [self.get_project_interpreter(), '-i', '-u']
            if open_file:
        def get_project_interpreter(self):
            """Return the project's specified python interpreter, if any"""
            settings = self.view.settings()
            return settings.get('python_interpreter', '/usr/bin/python')
        def repl_open(self, cmd_list):
            """Open a SublimeREPL using provided commands"""
                'repl_open', {
                    'encoding': 'utf8',
                    'type': 'subprocess',
                    'cmd': cmd_list,
                    'cwd': '$file_path',
                    'syntax': 'Packages/Python/Python.tmLanguage'

Set Hotkeys

  1. Open user keybind file:

    Preferences -> Key Bindings - User
  2. Add a few keybinds to make use of the plugin. Some examples:

    // Runs currently open file in repl
        "keys": ["f5"],
        "command": "project_venv_repl"
    // Runs repl without any file
        "keys": ["f6"],
        "command": "project_venv_repl",
        "args": {
            "open_file": null
    // Runs a specific file in repl, change to desired file
        "keys": ["f7"],
        "command": "project_venv_repl",
        "args": {
            "open_file": "/home/user/example/"