Metadata-Version: 2.1
Name: quickci
Version: 0.2.2
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://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_

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``

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 and Buddy 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

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>

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

``quickci`` can be installed using pip::

    $ pip install quickci


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


=======
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.


