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

Plugin Unit​Test Harness

This is a unittest harness for sublime plugins. Deferred test fixtures are supported, such that you give back control to sublime text, and continue with your test few ms later.

Details

Installs

  • Total 247
  • Win 165
  • OS X 48
  • Linux 34
Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6
Windows 0 0 0 1 0 0 0 0 0 0 0 2 0 0 1 0 0 1 0 0 0 0 0 0 0 0 1 0 0 1 0 0 0 0 0 2 0 0 0 0 0 0 0 0 0
OS X 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
bitbucket.​org

Plugin UnitTest Harness

This plugin provides deferred testcases, such you are able to run sublime commands from your test cases and give control to sublime text and get it back later.

Usage

Create a folder for your tests. If you want to stay sublime text 2 compatible you should not call it "tests" in your main plugin folder, because of name clashes.

Following layout is recommended:

  • My Fancy Plugin - my_fancy_plugin

    • __init__.py
    • some_file.py
    • tests - __init__.py - test_first_collection.py - test_second_collection.py
    • My Fancy Plugin.py
    • My Fancy Plugin.sublime-commands
My Fancy Plugin.py
... is your major plugin file, which is automatically reloaded by Sublime Text on change. The other python files within subfolders are not. This contains your commands you export to sublime text or whatever.
My Fancy Plugin.sublime-commands
This has to contain a command to start your tests::
[
{ "caption": "My Fancy Plugin: Run Tests",
"command": "run_plugin_unittest", "args": {"module": "My Fancy Plugin.my_fancy_plugin.tests"} }

]

my_fancy_plugin/tests/__init__.py

On each test the module passed to run_plugin_unittest is reloaded. So this file is responsible to reload everything, which is needed for the test:

# this is the class, which is run by run_plugin_unittest

from imp import reload

# make sure we have got latest changes

from . import test_first_collection
reload(test_first_collection)

from . import test_second_collection
reload(test_second_collection)

from .. import some_file
reload(some_file)

# import all testcases
from .test_first_collection import *
from .test_second_collection import *
my_fancy_plugin/tests/test_first_collection.py

This contains testcases:

from sublime_unittest import TestCase
import sublime

class MyTest(TestCase):

    def test_first(self):
        view = sublime.active_window().open_file("some file")

        while view.is_loading():
            yield     # default is to continue in 10ms

        self.assertEquals(view.name(), "some file")

    def test_second(self):
        view = sublime.active_window().open_file("some file")

        while view.is_loading():
            yield 2   # I specify that sublime shall continue this code in 2ms

        self.assertEquals(view.file_name(), "some file")

and so on ...

Simple Buffer Tests

You can create simple buffer tests like this:

from sublime_unittest import *

class MyBufferTest(BufferTest):
    test_cursor = (
        "initial │content of buffer",
        v('move', {'by': 'characters', 'forward': False}),
        "initial│ content of buffer",
        )

    # here buffer is selected
    test_selection = (
        "initial content of ┤buffer├",
        v('insert', {'characters': "view"}),
        "initial content of view│",
    )

    # multiple cursors
    test_multiple_cursors = (
        "initial ┤content├ of bu│ffer",
        v('move', {'by': 'characters', 'forward': True}),
        "initial content │of buf│fer",
        v('insert', {'characters': 'f'}),
        "initial content f│of buff│fer",
    )

    # line assertions
    test_line_assertion = (
        unindent("""
        first ┤line
        second├ l│ine
        """),
        (2, "second├ l│ine")
    )
  • all test names have to start with 'test'

  • You specify a text command (or view command) with v and a window command with w.

  • Each string means an assertion.

  • You can mix commands and assertions however you like.

  • ┤ and ├ encloses a selection and │ is an empty selection, i.e. a cursor.

    Note

    Using Character Table Plugin you can shortcut these characters with ctrl+k,v,l, ctrl+k,v,r and ctrl+k,v,v

Todo

  • have some TestCase.sendkeys() method to send keys after opening a panel

Changes

2014-04-16
  • added BufferTest for convenient buffer tests
  • added opportunity to yield a method to wait for some condition before continuing test

Author

Kay-Uwe (Kiwi) Lorenz <kiwi@franka.dyndns.org> (http://quelltexter.org)

Support my work on Sublime Text Plugins: Donate via Paypal