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

Py​Test

by kaste ST3

pytest runner and view annotator for sublime text 3

Labels python, pytest, testing

Details

  • 0.7.1
  • github.​com
  • github.​com
  • 1 month ago
  • 43 minutes ago
  • 11 months ago

Installs

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

Readme

Source
raw.​githubusercontent.​com

py.test plugin for the sublime text editor

The plugin basically runs your tests, and annotates your files using the tracebacks.

Common workflow

The defaults: it will run your tests on save; it will not show an output panel but annotate your views on failures instead. Like so:

annotated view showing phantom

Which test it will run depends on the red/green status of the previous run, and if you're currently editing a test file or an implementation file. It should work really okay. Set "mode": "manual" and just use your own key bindings if you think that's stupid. See Default.sublime-commands for some examples.

Config

At least look at the global settings. You usually have to edit the pytest setting to point at your py.test from your current virtualenv (the default is to run your global py.test which is usually not what you want). E.g.

"pytest": "~/venvs/{project_base_name}/bin/py.test"
OR:
"pytest": ".env\\Scripts\\py.test"
OR even:
"pytest": "venv/path/to/python -m pytest"

The plugin will expand ${project_path}, ${project_base_name}, ${file}, etc. as usual. It will respect your project-settings like:

{
  "folders":
  [
    {
      "path": "."
    }
  ],
  "settings": {
    "PyTest": {
      "mode": "auto",
      "options": "--tb=short -l -ff",
    },
  }
}

You probably should add a keybinding to show/hide the output panel quickly. You could use TogglePanel as well, but this one also brings the keyboard focus to the panel.

{ "keys": ["ctrl+'"], "command": "pytest_toggle_panel" },

Maybe a keybinding to run only the test under the cursor(s) as well:

{ "keys": ["ctrl+shift+'"], "command": "pytest_run_test_under_cursor"},

But that command is also available via the context menu.

The third most useful keybinding could be

{ "keys": ["ctrl+alt+'"], "command": "pytest_toggle_phantoms"},

to quickly show/hide the annotations (in sublime parlance 'phantoms') b/c they can get quite annoying and in your way if you have a lot of failures or generally large tracebacks.

You can disable this plugin via a command (ctrl+shift+p and start typing pytest deactivate). This setting will then be persisted in your project settings (if any).

Install

End-users should just do the normal install using Package Control searching for PyTest.

Hackers can manually download/clone from github and put it in your Packages directory. You have to run Package Control: Satisfy Dependencies after that to pull in lxml.

You can go fancy of course, and add this repo to Package Control.

  1. Open up the command palette (ctrl+shift+p), and find Package Control: Add Repository. Then enter the URL of this repo: https://github.com/kaste/PyTest in the input field.
  2. Open up the command palette again and find Package Control: Install Package, and just search for PyTest. (just a normal install)

Manual Theme Tweaking

The plugin tries to tweak your theme, so that you get a green/red notification after each test run. (You can disable this via the settings.) If this doesn't work out, consider a manual tweak: you really should add

{
    "class": "status_bar",
    "settings": ["pytest_is_red"],
    "layer0.tint": [155, 7, 8], // -RED
},

to your .sublime-theme to flash the status bar early if there are failures.

Likewise add

{
    "class": "status_bar",
    "settings": ["pytest_is_green"],
    "layer0.tint": [8, 131, 8], // -GREEN
},
{
    "class": "label_control",
    "settings": ["pytest_is_green"],
    "parents": [{"class": "status_bar"}],
    "color": [19, 21, 32],
},

to get a status bar notification if we're green. Add these styles at the end of your theme file, at least they must come after the default status_bar styles because these styles are generally applied top-down. Read more about how to customize a theme here.

Mandatory GIF

common workflow