busser-behave 0.1.3

data/vendor/behave/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2012-2014 Benno Rice, Richard Jones, Jens Engel and others, except where noted.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/vendor/behave/MANIFEST.in

@@ -0,0 +1,37 @@
+include README.rst
+include CHANGES.rst
+include MANIFEST.in
+include LICENSE
+include .coveragerc
+include .editorconfig
+include .pycheckrc
+include .pylintrc
+include *.cfg
+include *.ini
+include *.py
+include *.rst
+include *.txt
+include *.yml
+include *.yaml
+include bin/behave*
+include bin/invoke*
+recursive-include .ci           *.yml
+recursive-include bin           *.py *.cmd *.sh *.zip *.yml
+recursive-include behave4cmd0   *.py
+recursive-include etc           *.xsd *.txt *.json-schema
+recursive-include examples      *.py *.feature *.txt *.rst *.ini
+recursive-include docs          *.rst *.txt *.css *.py *.html *.rst-* *.png Makefile
+recursive-include docs/_themes  *.html *.conf *.css *.css_t LICENSE*
+recursive-include test          *.py
+recursive-include tests         *.py *.txt
+recursive-include tasks         *.py *.zip *.txt *.rst
+recursive-include tools         *.feature *.py *.yml *.sh
+recursive-include features      *.feature *.py *.txt
+recursive-include issue.features  *.feature *.py *.txt
+recursive-include more.features *.feature *.py *.txt
+recursive-include py.requirements  *.txt
+
+prune .tox
+prune .venv*
+prune paver_ext
+exclude pavement.py

data/vendor/behave/PROJECT_INFO.rst

@@ -0,0 +1,21 @@
+Project Info
+===============================================================================
+
+=============== ===============================================================
+Category        Hyperlink
+=============== ===============================================================
+Documentation:  http://pythonhosted.org/behave/
+                (or: http://behave.readthedocs.org/ for latest and stable)
+Download:       http://pypi.python.org/pypi/behave (or: `github archive`_)
+Development:    https://github.com/behave/behave
+Issue Tracker:  https://github.com/behave/behave/issues
+Changelog:      `CHANGES.rst <CHANGES.rst>`_
+Newsgroup:      https://groups.google.com/forum/#!forum/behave-users
+=============== ===============================================================
+
+.. hint::
+
+    The PyPI version is the latest stable version.
+    Otherwise, use the latest stable tag or the "bleeding edge" from Github.
+
+.. _`github archive`: https://github.com/behave/behave/tags

data/vendor/behave/README.rst

@@ -0,0 +1,112 @@
+======
+Behave
+======
+
+.. image:: https://badges.gitter.im/Join%20Chat.svg
+   :alt: Join the chat at https://gitter.im/behave/behave
+   :target: https://gitter.im/behave/behave?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
+
+.. image:: https://img.shields.io/travis/behave/behave/master.svg
+    :target: https://travis-ci.org/behave/behave
+    :alt: Travis CI Build Status
+
+.. image:: https://img.shields.io/pypi/v/behave.svg
+    :target: https://pypi.python.org/pypi/behave
+    :alt: Latest Version
+
+.. image:: https://img.shields.io/pypi/dm/behave.svg
+    :target: https://pypi.python.org/pypi/behave
+    :alt: Downloads
+
+.. image:: https://img.shields.io/pypi/l/behave.svg
+    :target: https://pypi.python.org/pypi/behave/
+    :alt: License
+
+.. |logo| image:: https://raw.github.com/behave/behave/master/docs/_static/behave_logo1.png
+
+behave is behavior-driven development, Python style.
+
+|logo|
+
+Behavior-driven development (or BDD) is an agile software development
+technique that encourages collaboration between developers, QA and
+non-technical or business participants in a software project.
+
+*behave* uses tests written in a natural language style, backed up by Python
+code.
+
+First, `install *behave*.`_
+
+
+Now make a directory called "features/".
+In that directory create a file called "example.feature" containing:
+
+.. code-block:: gherkin
+
+    # -- FILE: features/example.feature
+    Feature: Showing off behave
+
+      Scenario: Run a simple test
+        Given we have behave installed
+         When we implement 5 tests
+         Then behave will test them for us!
+
+Make a new directory called "features/steps/".
+In that directory create a file called "example_steps.py" containing:
+
+.. code-block:: python
+
+    # -- FILE: features/steps/example_steps.py
+    from behave import given, when, then, step
+
+    @given('we have behave installed')
+    def step_impl(context):
+        pass
+
+    @when('we implement {number:d} tests')
+    def step_impl(context, number):  # -- NOTE: number is converted into integer
+        assert number > 1 or number == 0
+        context.tests_count = number
+
+    @then('behave will test them for us!')
+    def step_impl(context):
+        assert context.failed is False
+        assert context.tests_count >= 0
+
+Run behave:
+
+.. code-block:: bash
+
+    $ behave
+    Feature: Showing off behave # features/example.feature:2
+
+      Scenario: Run a simple test          # features/example.feature:4
+        Given we have behave installed     # features/steps/example_steps.py:4
+        When we implement 5 tests          # features/steps/example_steps.py:8
+        Then behave will test them for us! # features/steps/example_steps.py:13
+
+    1 feature passed, 0 failed, 0 skipped
+    1 scenario passed, 0 failed, 0 skipped
+    3 steps passed, 0 failed, 0 skipped, 0 undefined
+
+Now, continue reading to learn how to get the most out of *behave*. To get started,
+we recommend the `tutorial`_ and then the `feature testing language`_ and
+`api`_ references.
+
+
+.. _`Install *behave*.`: http://pythonhosted.org/behave/install.html
+.. _`tutorial`: http://pythonhosted.org/behave/tutorial.html#features
+.. _`feature testing language`: http://pythonhosted.org/behave/gherkin.html
+.. _`api`: http://pythonhosted.org/behave/api.html
+
+
+More Information
+-------------------------------------------------------------------------------
+
+* `behave documentation`_ (`latest changes`_)
+* `behave.example`_: Behave Examples and Tutorials (docs, executable examples).
+
+.. _behave documentation: http://pythonhosted.org/behave/
+.. _latest changes: https://github.com/behave/behave/blob/master/CHANGES.rst
+.. _behave.example: https://github.com/behave/behave.example
+

data/vendor/behave/VERSION.txt

@@ -0,0 +1 @@
+1.2.6.dev0

data/vendor/behave/behave.ini

@@ -0,0 +1,22 @@
+# =============================================================================
+# BEHAVE CONFIGURATION
+# =============================================================================
+# FILE: .behaverc, behave.ini, setup.cfg, tox.ini
+#
+# SEE ALSO:
+#  * http://packages.python.org/behave/behave.html#configuration-files
+#  * https://github.com/behave/behave
+#  * http://pypi.python.org/pypi/behave/
+# =============================================================================
+
+[behave]
+default_tags = -@xfail -@not_implemented
+show_skipped = false
+format   = rerun
+    progress3
+outfiles = rerun.txt
+    reports/report_progress3.txt
+junit = true
+logging_level = INFO
+# logging_format = LOG.%(levelname)-8s  %(name)-10s: %(message)s
+# logging_format = LOG.%(levelname)-8s  %(asctime)s  %(name)-10s: %(message)s

data/vendor/behave/behave/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: UTF-8 -*-
+"""behave is behaviour-driven development, Python style
+
+Behavior-driven development (or BDD) is an agile software development
+technique that encourages collaboration between developers, QA and
+non-technical or business participants in a software project.
+
+*behave* uses tests written in a natural language style, backed up by Python
+code.
+
+To get started, we recommend the `tutorial`_ and then the `test language`_ and
+`api`_ references.
+
+.. _`tutorial`: tutorial.html
+.. _`test language`: gherkin.html
+.. _`api`: api.html
+"""
+
+from __future__ import absolute_import
+from behave.step_registry import *      # pylint: disable=wildcard-import
+from behave.matchers import use_step_matcher, step_matcher, register_type
+
+# pylint: disable=undefined-all-variable
+__all__ = [
+    "given", "when", "then", "step", "use_step_matcher", "register_type",
+    "Given", "When", "Then", "Step",
+    # -- DEPRECATING:
+    "step_matcher"
+]
+__version__ = '1.2.6.dev0'

data/vendor/behave/behave/__main__.py

@@ -0,0 +1,187 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import absolute_import, print_function
+import codecs
+import sys
+import six
+from behave import __version__
+from behave.configuration import Configuration, ConfigError
+from behave.parser import ParserError
+from behave.runner import Runner
+from behave.runner_util import print_undefined_step_snippets, reset_runtime, \
+    InvalidFileLocationError, InvalidFilenameError, FileNotFoundError
+from behave.textutil import compute_words_maxsize, text as _text
+
+
+TAG_HELP = """
+Scenarios inherit tags declared on the Feature level. The simplest
+TAG_EXPRESSION is simply a tag::
+
+    --tags @dev
+
+You may even leave off the "@" - behave doesn't mind.
+
+When a tag in a tag expression starts with a ~, this represents boolean NOT::
+
+    --tags ~@dev
+
+A tag expression can have several tags separated by a comma, which represents
+logical OR::
+
+    --tags @dev,@wip
+
+The --tags option can be specified several times, and this represents logical
+AND, for instance this represents the boolean expression
+"(@foo or not @bar) and @zap"::
+
+    --tags @foo,~@bar --tags @zap.
+
+Beware that if you want to use several negative tags to exclude several tags
+you have to use logical AND::
+
+    --tags ~@fixme --tags ~@buggy.
+""".strip()
+
+# TODO
+# Positive tags can be given a threshold to limit the number of occurrences.
+# Which can be practical if you are practicing Kanban or CONWIP. This will fail
+# if there are more than 3 occurrences of the @qa tag:
+#
+# --tags @qa:3
+# """.strip()
+
+
+def run_behave(config, runner_class=None):
+    """Run behave with configuration.
+
+    :param config:          Configuration object for behave.
+    :param runner_class:    Runner class to use or none (use Runner class).
+    :return:    0, if successful. Non-zero on failure.
+
+    .. note:: BEST EFFORT, not intended for multi-threaded usage.
+    """
+    # pylint: disable=too-many-branches, too-many-statements, too-many-return-statements
+    if runner_class is None:
+        runner_class = Runner
+
+    if config.version:
+        print("behave " + __version__)
+        return 0
+
+    if config.tags_help:
+        print(TAG_HELP)
+        return 0
+
+    if config.lang_list:
+        from behave.i18n import languages
+        stdout = sys.stdout
+        if six.PY2:
+            # -- PYTHON2: Overcome implicit encode problems (encoding=ASCII).
+            stdout = codecs.getwriter("UTF-8")(sys.stdout)
+        iso_codes = languages.keys()
+        print("Languages available:")
+        for iso_code in sorted(iso_codes):
+            native = languages[iso_code]["native"][0]
+            name = languages[iso_code]["name"][0]
+            print(u"%s: %s / %s" % (iso_code, native, name), file=stdout)
+        return 0
+
+    if config.lang_help:
+        from behave.i18n import languages
+        if config.lang_help not in languages:
+            print("%s is not a recognised language: try --lang-list" % \
+                    config.lang_help)
+            return 1
+        trans = languages[config.lang_help]
+        print(u"Translations for %s / %s" % (trans["name"][0],
+                                             trans["native"][0]))
+        for kw in trans:
+            if kw in "name native".split():
+                continue
+            print(u"%16s: %s" % (kw.title().replace("_", " "),
+                                 u", ".join(w for w in trans[kw] if w != "*")))
+        return 0
+
+    if not config.format:
+        config.format = [config.default_format]
+    elif config.format and "format" in config.defaults:
+        # -- CASE: Formatter are specified in behave configuration file.
+        #    Check if formatter are provided on command-line, too.
+        if len(config.format) == len(config.defaults["format"]):
+            # -- NO FORMATTER on command-line: Add default formatter.
+            config.format.append(config.default_format)
+    if "help" in config.format:
+        print_formatters("Available formatters:")
+        return 0
+
+    if len(config.outputs) > len(config.format):
+        print("CONFIG-ERROR: More outfiles (%d) than formatters (%d)." % \
+              (len(config.outputs), len(config.format)))
+        return 1
+
+    # -- MAIN PART:
+    failed = True
+    try:
+        reset_runtime()
+        runner = runner_class(config)
+        failed = runner.run()
+    except ParserError as e:
+        print(u"ParserError: %s" % e)
+    except ConfigError as e:
+        print(u"ConfigError: %s" % e)
+    except FileNotFoundError as e:
+        print(u"FileNotFoundError: %s" % e)
+    except InvalidFileLocationError as e:
+        print(u"InvalidFileLocationError: %s" % e)
+    except InvalidFilenameError as e:
+        print(u"InvalidFilenameError: %s" % e)
+    except Exception as e:
+        # -- DIAGNOSTICS:
+        text = _text(e)
+        print(u"Exception %s: %s" % (e.__class__.__name__, text))
+        raise
+
+    if config.show_snippets and runner.undefined_steps:
+        print_undefined_step_snippets(runner.undefined_steps,
+                                      colored=config.color)
+
+    return_code = 0
+    if failed:
+        return_code = 1
+    return return_code
+
+def print_formatters(title=None, stream=None):
+    """Prints the list of available formatters and their description.
+
+    :param title:   Optional title (as string).
+    :param stream:  Optional, output stream to use (default: sys.stdout).
+    """
+    from behave.formatter._registry  import format_items
+    from operator import itemgetter
+
+    if stream is None:
+        stream = sys.stdout
+    if title:
+        stream.write(u"%s\n" % title)
+
+    format_items = sorted(format_items(resolved=True), key=itemgetter(0))
+    format_names = [item[0]  for item in format_items]
+    column_size = compute_words_maxsize(format_names)
+    schema = u"  %-"+ _text(column_size) +"s  %s\n"
+    for name, formatter_class in format_items:
+        formatter_description = getattr(formatter_class, "description", "")
+        stream.write(schema % (name, formatter_description))
+
+
+def main(args=None):
+    """Main function to run behave (as program).
+
+    :param args:    Command-line args (or string) to use.
+    :return: 0, if successful. Non-zero, in case of errors/failures.
+    """
+    config = Configuration(args)
+    return run_behave(config)
+
+if __name__ == "__main__":
+    # -- EXAMPLE: main("--version")
+    sys.exit(main())

data/vendor/behave/behave/_stepimport.py

@@ -0,0 +1,185 @@
+# -*- coding: UTF-8 -*-
+"""
+This module provides low-level helper functionality during step imports.
+
+.. warn:: Do not use directly
+
+    It should not be used directly except in behave Runner classes
+    that need to provide the correct context (step_registry, matchers, etc.)
+    instead of using the global module specific variables.
+"""
+
+from __future__ import absolute_import
+from contextlib import contextmanager
+from threading import Lock
+from types import ModuleType
+import os.path
+import sys
+from behave import step_registry as _step_registry
+# from behave import matchers as _matchers
+import six
+
+
+# -----------------------------------------------------------------------------
+# UTILITY FUNCTIONS:
+# -----------------------------------------------------------------------------
+def setup_api_with_step_decorators(module, step_registry):
+    _step_registry.setup_step_decorators(module, step_registry)
+
+def setup_api_with_matcher_functions(module, matcher_factory):
+    module.use_step_matcher = matcher_factory.use_step_matcher
+    module.step_matcher = matcher_factory.use_step_matcher
+    module.register_type = matcher_factory.register_type
+
+# -----------------------------------------------------------------------------
+# FAKE MODULE CLASSES: For step imports
+# -----------------------------------------------------------------------------
+# class FakeModule(object):
+class FakeModule(ModuleType):
+    ensure_fake = True
+
+    # -- SUPPORT FOR: behave.step_registry.setup_step_decorators()
+    def __setitem__(self, name, value):
+        assert "." not in name
+        setattr(self, name, value)
+
+
+class StepRegistryModule(FakeModule):
+    """Provides a fake :mod:`behave.step_registry` module
+    that can be used during step imports.
+    """
+    __all__ = [
+        "given", "when", "then", "step",
+        "Given", "When", "Then", "Step",
+    ]
+
+    def __init__(self, step_registry):
+        super(StepRegistryModule, self).__init__("behave.step_registry")
+        self.registry = step_registry
+        setup_api_with_step_decorators(self, step_registry)
+
+
+class StepMatchersModule(FakeModule):
+    __all__ = ["use_step_matcher", "register_type", "step_matcher"]
+
+    def __init__(self, matcher_factory):
+        super(StepMatchersModule, self).__init__("behave.matchers")
+        self.matcher_factory = matcher_factory
+        setup_api_with_matcher_functions(self, matcher_factory)
+        self.use_default_step_matcher = matcher_factory.use_default_step_matcher
+        self.get_matcher = matcher_factory.make_matcher
+        # self.matcher_mapping = matcher_mapping or _matchers.matcher_mapping.copy()
+        # self.current_matcher = current_matcher or _matchers.current_matcher
+
+        # -- INJECT PYTHON PACKAGE META-DATA:
+        # REQUIRED-FOR: Non-fake submodule imports (__path__).
+        here = os.path.dirname(__file__)
+        self.__file__ = os.path.abspath(os.path.join(here, "matchers.py"))
+        self.__name__ = "behave.matchers"
+        # self.__path__ = [os.path.abspath(here)]
+
+    # def use_step_matcher(self, name):
+    #     self.matcher_factory.use_step_matcher(name)
+    #     # self.current_matcher = self.matcher_mapping[name]
+    #
+    # def use_default_step_matcher(self, name=None):
+    #     self.matcher_factory.use_default_step_matcher(name=None)
+    #
+    # def get_matcher(self, func, string):
+    #     # return self.current_matcher
+    #     return self.matcher_factory.make_matcher(func, string)
+    #
+    # def register_type(self, **kwargs):
+    #     # _matchers.register_type(**kwargs)
+    #     self.matcher_factory.register_type(**kwargs)
+    #
+    # step_matcher = use_step_matcher
+
+
+class BehaveModule(FakeModule):
+    __all__ = StepRegistryModule.__all__ + StepMatchersModule.__all__
+
+    def __init__(self, step_registry, matcher_factory=None):
+        if matcher_factory is None:
+            matcher_factory = step_registry.step_matcher_factory
+        assert matcher_factory is not None
+        super(BehaveModule, self).__init__("behave")
+        setup_api_with_step_decorators(self, step_registry)
+        setup_api_with_matcher_functions(self, matcher_factory)
+        self.use_default_step_matcher = matcher_factory.use_default_step_matcher
+        assert step_registry.matcher_factory == matcher_factory
+
+        # -- INJECT PYTHON PACKAGE META-DATA:
+        # REQUIRED-FOR: Non-fake submodule imports (__path__).
+        here = os.path.dirname(__file__)
+        self.__file__ = os.path.abspath(os.path.join(here, "__init__.py"))
+        self.__name__ = "behave"
+        self.__path__ = [os.path.abspath(here)]
+        self.__package__ = None
+
+
+class StepImportModuleContext(object):
+
+    def __init__(self, step_container):
+        self.step_registry = step_container.step_registry
+        self.matcher_factory = step_container.matcher_factory
+        assert self.step_registry.matcher_factory == self.matcher_factory
+        self.step_registry.matcher_factory = self.matcher_factory
+
+        step_registry_module = StepRegistryModule(self.step_registry)
+        step_matchers_module = StepMatchersModule(self.matcher_factory)
+        behave_module = BehaveModule(self.step_registry, self.matcher_factory)
+        self.modules = {
+            "behave": behave_module,
+            "behave.matchers": step_matchers_module,
+            "behave.step_registry": step_registry_module,
+        }
+        # self.default_matcher = self.step_matchers_module.current_matcher
+
+    def reset_current_matcher(self):
+        self.matcher_factory.use_default_step_matcher()
+
+_step_import_lock = Lock()
+unknown = object()
+
+@contextmanager
+def use_step_import_modules(step_container):
+    """Redirect any step/type registration to the runner's step-context object
+    during step imports by using fake modules (instead of using module-globals).
+
+    This allows that multiple runners can be used without polluting the
+    global variables in problematic modules
+    (:mod:`behave.step_registry`, mod:`behave.matchers`).
+
+    .. sourcecode:: python
+
+        # -- RUNNER-IMPLEMENTATION:
+        def load_step_definitions(self, ...):
+            step_container = self.step_container
+            with use_step_import_modules(step_container) as import_context:
+                # -- USE: Fake modules during step imports
+                ...
+                import_context.reset_current_matcher()
+
+    :param step_container:  Step context object with step_registry, matcher_factory.
+    """
+    orig_modules = {}
+    import_context = StepImportModuleContext(step_container)
+    with _step_import_lock:
+        # -- CRITICAL-SECTION (multi-threading protected)
+        try:
+            # -- SCOPE-GUARD SETUP: Replace original modules with fake ones.
+            for module_name, fake_module in six.iteritems(import_context.modules):
+                orig_module = sys.modules.get(module_name, unknown)
+                orig_modules[module_name] = orig_module
+                sys.modules[module_name] = fake_module
+
+            # -- USE: Fake modules for step imports.
+            yield import_context
+        finally:
+            # -- SCOPE-GUARD CLEANUP: Restore original modules.
+            for module_name, orig_module in six.iteritems(orig_modules):
+                if orig_module is unknown:
+                    del sys.modules[module_name]
+                else:
+                    sys.modules[module_name] = orig_module