Metadata-Version: 2.1
Name: tempocli
Version: 0.1.2.dev3
Summary: Command line interface for interacting with Tempo.
Home-page: https://github.com/awiddersheim/tempocli
Author: Andrew Widdersheim
Author-email: amwiddersheim@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Requires-Python: !=2.*, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Provides-Extra: dev
Requires-Dist: arrow
Requires-Dist: click
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: requests-futures
Provides-Extra: dev
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: flake8-bandit; extra == 'dev'
Requires-Dist: flake8-commas; extra == 'dev'
Requires-Dist: flake8-import-order; extra == 'dev'
Requires-Dist: flake8-import-single; extra == 'dev'
Requires-Dist: flake8-print; extra == 'dev'
Requires-Dist: flake8-quotes; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-click; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: pytest-freezegun; extra == 'dev'
Requires-Dist: requests-mock; extra == 'dev'

TempoCLI
========

Command line interface for interacting with Tempo.

|Status| |PackageVersion| |PythonVersions|

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

Ease repetitive Tempo tasks by using templates to fill in recurring
items without having to use web interface. Templates are yaml formatted
files that are semi-flexible in allowing what can be created.

::

    ----
    author: foo

    issues:
      # Will use current date if one can't be determined.
      - issue: INT-8
        time_spent: 30m
        start_time: "9:30AM"

      # Can specify day of week easily.
      - issue: INT-10
        time_spent: 1h
        start_time: Monday at 9AM

      # Full on datetime with author override.
      - issue: INT-11
        time_spent: 90s
        start_time: "2018-08-05 11:00:00"
        author: bar

      # Pass in extras that aren't exposed in DSL.
      # https://tempo-io.github.io/tempo-api-docs/#worklogs
      - issue: INT-11
        time_spent: 1h
        start_time: 8am
        extras:
          remainingEstimateSeconds: 300


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

::

    $ pip install tempocli
    $ pip install --upgrade tempocli

Running
-------

::

    tempocli --config <config> create --template <template>

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

By default, ``~/.tempocli.yml`` is the path used for configuration file but
that is configurable. The configuration should look like this::

    ---
    url: https://api.tempo.io/2/
    token: <token>

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

::

    $ pip install -e .
    $ tempocli --help


Testing
-------

::

    # Install development packages (preferably in a virtualenv)
    $ pip install -e .[dev]

    # Run tests
    $ pytest

    # Run tests for available Python interpreters
    $ tox

    # Linting
    $ tox -e flake8


.. |PackageVersion| image:: https://img.shields.io/pypi/v/tempocli.svg?style=flat
    :alt: PyPI version
    :target: https://pypi.org/project/tempocli

.. |PythonVersions| image:: https://img.shields.io/pypi/pyversions/tempocli.svg
    :alt: Supported Python versions
    :target: https://pypi.org/project/tempocli

.. |Status| image:: https://img.shields.io/circleci/project/github/awiddersheim/tempocli/master.svg
    :alt: Build
    :target: https://circleci.com/gh/awiddersheim/tempocli


