Metadata-Version: 2.1
Name: nose-launchable
Version: 0.4.1
Summary: A nose plugin to interact with Launchable API
Home-page: https://github.com/launchableinc/nose-launchable
Author: Launchable team
Author-email:  info@launchableinc.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
License-File: LICENSE

nose-launchable
===============

A nose plugin to interact with
`Launchable <https://www.launchableinc.com/>`__ API.

Install
-------

::

   $ pip install nose-launchable

Usage
-----

Subset
~~~~~~

::

   $ nosetests --launchable-subset --launchable-build-number <build number> --launchable-subset-options <Launchable CLI subset options>

You need to specify ``--launchable-subset-options`` flag and give it
Launchable CLI subset command options. For example, if you want to
create a fixed time-based subset it looks like
``--launchable-subset-options '--time 600'``.

For more information on the CLI options, please visit `the CLI
documentation
page <https://docs.launchableinc.com/resources/cli-reference#subset>`__.

Record only
~~~~~~~~~~~

::

   $ nosetests --launchable-record-only --launchable-build-number <build number>

In addition, you may need to set the following environment variables in
your environment. These values should be provided from Launchable.

+-----------------------------------+-----------------------------------+
| Key                               | Description                       |
+===================================+===================================+
| LAUNCHABLE_BASE_URL               | (Optional) A Launchable API URL.  |
|                                   | Default is                        |
|                                   | ``https:                          |
|                                   | //api.mercury.launchableinc.com`` |
+-----------------------------------+-----------------------------------+
| LAUNCHABLE_BUILD_NUMBER           | (Optional) A CI/CD build number   |
+-----------------------------------+-----------------------------------+
| LAUNCHABLE_DEBUG                  | (Optional) Prints out debug logs  |
+-----------------------------------+-----------------------------------+
| LAUNCHABLE_TOKEN                  | (Required) A token to access      |
|                                   | Launchable API                    |
+-----------------------------------+-----------------------------------+

Development
-----------

Pull requests are always appreciated. Below are some tips on developing
nose-launchable plugin.

Install nose-launchable locally
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you want to see whether your changes work as expected, run the
following command to install the plugin locally.

.. code:: bash

   $ python setup.py install

Release nose-launchable
~~~~~~~~~~~~~~~~~~~~~~~

1. (Optional) Run ``./scripts/update_readme.sh`` if you updated
   README.md
2. Run ``./scripts/bump_up.sh`` and update nose_launchable/version.py
3. Create a Pull Request and merge that
4. Create a new GitHub release then the new package will be
   automatically uploaded to
   `PyPI <https://pypi.org/project/nose-launchable/>`__


