Metadata-Version: 2.1
Name: quickci
Version: 0.2.4
Summary: Have a quick look at the status of CI projects from the command line.
Home-page: https://github.com/robertopreste/quickci
Author: Roberto Preste
Author-email: robertopreste@gmail.com
License: MIT license
Keywords: quickci
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/x-rst
Requires-Dist: Click (>=7.0)
Requires-Dist: requests (>=2.21.0)
Requires-Dist: asyncio (>=3.4.3)
Requires-Dist: aiohttp (>=3.5.4)

=======
quickCI
=======


.. image:: https://img.shields.io/pypi/v/quickci.svg
        :target: https://pypi.python.org/pypi/quickci

.. image:: https://www.repostatus.org/badges/latest/wip.svg
    :alt: Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.
    :target: https://www.repostatus.org/#wip

.. image:: https://travis-ci.com/robertopreste/quickCI.svg?branch=master
    :target: https://travis-ci.com/robertopreste/quickCI

.. image:: https://readthedocs.org/projects/quickci/badge/?version=latest
        :target: https://quickci.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg
   :target: https://saythanks.io/to/robertopreste


Have a quick look at the status of CI projects from the command line.


* Free software: MIT license
* Documentation: https://quickci.readthedocs.io
* GitHub repo: https://github.com/robertopreste/quickci


Features
========

Currently, quickCI supports checking build status for the following CI services:

* `Travis CI`_
* CircleCI_
* AppVeyor_
* Buddy_
* Drone_

More services to come!

Usage
=====

Configuration
-------------

1. Create a config file (it will be located in ``~/.config/quickci/tokens.json``::

    $ quickci config create

2. Replace placeholders with your own authentication tokens::

    $ quickci config update <service> <token>

Available services are:
    * Travis CI: ``travis``
    * CircleCI: ``circle``
    * AppVeyor: ``appveyor``
    * Buddy: ``buddy``
    * Drone: ``drone``

3. Check that everything is correct::

    $ quickci config show

Check build status
------------------

Check the build status of your projects::

    $ quickci status

The build status of your Travis CI, CircleCI, AppVeyor, Buddy and Drone projects will be returned (currently only master branch).

It is also possible to check a specific service using subcommands of ``quickci status``::

    $ quickci status travis
    $ quickci status circle
    $ quickci status appveyor
    $ quickci status buddy
    $ quickci status drone

If the token for a specific service is not listed in ``~/.config/quickci/tokens.json``, it is possible to provide it using the ``--token <service_token>`` option::

    $ quickci status travis --token <TravisCI token>

Please refer to the Usage_ section of the documentation for further information.

Installation
============

quickCI can be installed using pip (**Python>=3.6 only**)::

    $ pip install quickci

Please refer to the Installation_ section of the documentation for further information.

Credits
=======

This package was created with Cookiecutter_ and the `cc-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`cc-pypackage`: https://github.com/robertopreste/cc-pypackage
.. _`Travis CI`: https://travis-ci.com/
.. _CircleCI: https://circleci.com/
.. _AppVeyor: https://www.appveyor.com/
.. _Buddy: https://buddy.works
.. _Drone: https://drone.io
.. _Usage: https://quickci.readthedocs.io/en/latest/usage.html
.. _Installation: https://quickci.readthedocs.io/en/latest/installation.html


=======
History
=======

0.1.0 (2019-04-20)
==================

* First release.

0.1.1 (2019-04-29)
------------------

* Update Config methods and attributes for better handling of tokens;
* Update CLI commands.

0.1.2 (2019-06-03)
------------------

* Minor code fix;
* Update requirements and documentation;
* Fix AppVeyor request class and add GitLab draft.

0.1.3 (2019-06-06)
------------------

* Add Buddy class.

0.1.4 (2019-06-07)
------------------

* Change fetching functions to asyncio.

0.2.0 (2019-07-02)
==================

* Change ``config`` and ``status`` commands to group commands and add related subcommands;
* Change classes to use concurrent functions when possible;
* Clean code.

0.2.1 (2019-07-03)
------------------

* Fix imports and tox test config.

0.2.2 (2019-07-03)
------------------

* Fix setup.py installation process;
* Update documentation.

0.2.3 (2019-07-13)
------------------

* Add Drone CI class and CLI commands;
* Update tests;
* Update documentation.


