ó
@ū^Yc           @   sž   d  Z  d d l m Z m Z e d  Z e d  Z e d    Z e d    Z e d e  d    Z	 e d e  d    Z
 e d e  d	    Z e d
    Z e d    Z d S(   s    Hook specifications for tox.

iĸĸĸĸ(   t   HookspecMarkert   HookimplMarkert   toxc         C   s   d S(   s>    add command line options to the argparse-style parser object.N(    (   t   parser(    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_addoption   s    c         C   s   d S(   s   called after command line options have been parsed and the ini-file has
    been read.  Please be aware that the config object layout may change as its
    API was not designed yet wrt to providing stability (it was an internal
    thing purely before tox-2.0). N(    (   t   config(    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_configure   s    t   firstresultc         C   s   d S(   s&   return a python executable for the given python base name.
    The first plugin/hook which returns an executable path will determine it.

    ``envconfig`` is the testenv configuration which contains
    per-testenv configuration, notably the ``.envname`` and ``.basepython``
    setting.
    N(    (   t	   envconfig(    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_get_python_executable   s    c         C   s   d S(   są   [experimental] perform creation action for this venv.

    Some example usage:

    - To *add* behavior but still use tox's implementation to set up a
      virtualenv, implement this hook but do not return a value (or explicitly
      return ``None``).
    - To *override* tox's virtualenv creation, implement this hook and return
      a non-``None`` value.

    .. note:: This api is experimental due to the unstable api of
        :class:`tox.venv.VirtualEnv`.

    .. note:: This hook uses ``firstresult=True`` (see pluggy_) -- hooks
        implementing this will be run until one returns non-``None``.

    .. _pluggy: http://pluggy.readthedocs.io/en/latest/#first-result-only
    N(    (   t   venvt   action(    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_testenv_create#   s    c         C   s   d S(   s
   [experimental] perform install dependencies action for this venv.

    Some example usage:

    - To *add* behavior but still use tox's implementation to install
      dependencies, implement this hook but do not return a value (or
      explicitly return ``None``).  One use-case may be to install (or ensure)
      non-python dependencies such as debian packages.
    - To *override* tox's installation of dependencies, implement this hook
      and return a non-``None`` value.  One use-case may be to install via
      a different installation tool such as `pip-accel`_ or `pip-faster`_.

    .. note:: This api is experimental due to the unstable api of
        :class:`tox.venv.VirtualEnv`.

    .. note:: This hook uses ``firstresult=True`` (see pluggy_) -- hooks
        implementing this will be run until one returns non-``None``.

    .. _pip-accel: https://github.com/paylogic/pip-accel
    .. _pip-faster: https://github.com/Yelp/venv-update
    .. _pluggy: http://pluggy.readthedocs.io/en/latest/#first-result-only
    N(    (   R
   R   (    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_testenv_install_deps9   s    c         C   s   d S(   s­    [experimental] perform arbitrary action before running tests for this venv.

    This could be used to indicate that tests for a given venv have started, for instance.
    N(    (   R
   (    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_runtest_preS   s    c         C   s   d S(   s    [experimental] perform arbitrary action after running tests for this venv.

    This could be used to have per-venv test reporting of pass/fail status.
    N(    (   R
   (    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   tox_runtest_post[   s    N(   t   __doc__t   pluggyR    R   t   hookspect   hookimplR   R   t   TrueR	   R   R   R   R   (    (    (    s*   /tmp/pip-build-UnxK1c/tox/tox/hookspecs.pyt   <module>   s   