Metadata-Version: 2.0
Name: scc
Version: 0.9.3
Summary: OME tools for managing the git(hub) workflow
Home-page: https://github.com/openmicroscopy/snoopycrimecop
Author: The Open Microscopy Team
Author-email: ome-devel@lists.openmicroscopy.org.uk
License: GPLv2
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Version Control
Requires-Dist: yaclifw (>=0.1.2)
Requires-Dist: PyGithub
Requires-Dist: argparse
Requires-Dist: PyYAML (==3.11)
Requires-Dist: six

Snoopy Crime Copy (SCC)
=======================

|Build Status|
|Pypi|

Introduction
------------

The scc command provides tools for simplifying the Git(Hub) workflow.

Dependencies
------------

Direct dependencies of scc are:

- `PyGithub`_
- `argparse`_

Installation
------------

To install ``scc``, run::

 $ python setup.py install

or using pip, run::

 $ pip install scc

To upgrade your pip installation, run::

 $ pip install -U scc

Usage
-----

The list of available commands can be listed with::

  $ scc -h

For each subcommand, additional help can be queried, e.g.::

  $ scc merge -h

Contributing
------------

PyGithub follows `PEP 8`_, the Style Guide for Python Code. Please check your
code with pep8_ or flake8_, the Python style guide checkers, by running
``flake8 -v .`` or ``pep8 -v .``.

.. _PEP 8: http://www.python.org/dev/peps/pep-0008/


Running tests
-------------

The tests are located under the `test` directory. To run all the tests, use
the `test` target of `setup.py`::

  python setup.py test

Unit tests
^^^^^^^^^^

Unit tests are stored under the `test/unit` folder and can be run by calling::

  python setup.py test -t test/unit

Unit tests are also run by the Travis_ build on every Pull Request opened
against the main repository.

Integration tests
^^^^^^^^^^^^^^^^^

Integration tests are stored under `test/integration`. Many integration tests
use snoopys-sandbox_ and snoopys-sandbox-2_ as sandbox repositories to test the
scc commands.

Running the integration test suite requires:

- a GitHub account
- a token-based GitHub connection, i.e. a global ``github.token`` stored under
  the global Git configuration file::

    $ git config --global github.token xxxx

- the user authenticated by the token defined above needs to own forks of
  snoopys-sandbox_ and snoopys-sandbox-2_

Once this is set up, the integration tests can be run by calling::

  python setupy.py test -s test/integration

Integration tests are run daily on the OME Continuous Integration
infrastructure under the SCC-self-merge_ job using the token-authenticated
`snoopycrimecop user <https://github.com/snoopycrimecop>`_

License
-------

snoopycrimecop is released under the GPL.

Copyright
---------

2012-2016, The Open Microscopy Environment

.. _SCC-self-merge: http://hudson.openmicroscopy.org.uk/view/Mgmt/job/SCC-self-merge/
.. _PyGithub: https://github.com/jacquev6/PyGithub
.. _argparse: http://pypi.python.org/pypi/argparse
.. _pep8: https://pypi.python.org/pypi/pep8
.. _flake8: https://pypi.python.org/pypi/flake8
.. _snoopys-sandbox: https://github.com/openmicroscopy/snoopys-sandbox
.. _snoopys-sandbox-2: https://github.com/openmicroscopy/snoopys-sandbox-2
.. _Travis: http://travis-ci.org/openmicroscopy/snoopycrimecop

.. |Build Status| image:: https://travis-ci.org/openmicroscopy/snoopycrimecop.png
   :target: http://travis-ci.org/openmicroscopy/snoopycrimecop

.. |Pypi| image:: https://badge.fury.io/py/scc.svg
    :target: https://badge.fury.io/py/scc


