Metadata-Version: 2.0
Name: lancet
Version: 0.2
Summary: Lancet
Home-page: https://github.com/GaretJax/lancet
Author: Jonathan Stoppani
Author-email: jonathan@stoppani.name
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: cffi (==0.8.6)
Requires-Dist: click (==3.3)
Requires-Dist: gnureadline (==6.3.3)
Requires-Dist: ipython (==2.3.1)
Requires-Dist: jira (==0.32)
Requires-Dist: keyring (==4.0)
Requires-Dist: oauthlib (==0.7.2)
Requires-Dist: pycparser (==2.10)
Requires-Dist: pygit2 (==0.21.4)
Requires-Dist: python-slugify (==0.1.0)
Requires-Dist: requests-oauthlib (==0.4.2)
Requires-Dist: requests (==2.4.3)
Requires-Dist: six (==1.8.0)
Requires-Dist: tlslite (==0.4.8)
Requires-Dist: Unidecode (==0.04.16)

======
LANCET
======

.. image:: https://badge.fury.io/py/lancet.png
   :target: http://badge.fury.io/py/lancet

.. image:: https://travis-ci.org/GaretJax/lancet.png?branch=master
   :target: https://travis-ci.org/GaretJax/lancet

.. image:: https://pypip.in/d/lancet/badge.png
   :target: https://crate.io/packages/lancet?version=latest


>From http://en.wikipedia.org/wiki/Scalpel:

    A scalpel, or lancet, is a small and extremely sharp bladed instrument used
    for surgery, anatomical dissection, and various arts and crafts (called a
    hobby knife).

Lancet is a command line utility to streamline the various activities related
to the development and maintenance of a software package.

* Free software: MIT license
* Documentation: http://lancet.rtfd.org (TODO).


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

You can install ``lancet`` from PyPI_. The suggested way to get it on your system
is by using pipsi_::

   brew install libgit2
   pipsi install --python=$(which python3) lancet

.. _PyPI: https://pypi.python.org/pypi/lancet
.. _pipsi: https://github.com/mitsuhiko/pipsi


Getting started
---------------

Once installed, set up the initial configuration by running::

   lancet setup

TODO: For each not-yet-configured project, you can then run::

   cd path/to/project
   lancet init

This creates a new project-level configuration file that can be shared across
different users (and thus commited to source control).

Features
--------

* Start tasks (create branch, set correct issue status/assignee, start
  linked harvest timer)
* Suspend tasks (pause harvest timer, set issue status)
* Resume tasks (resume timer, set issue status)
* Rapidly open issue tracker task page

See http://cl.ly/0u28140B1Y15 for a short visual demo and ``lancet --help``
for additional details::

   Usage: lancet [OPTIONS] COMMAND [ARGS]...

   Options:
    -h, --help  Show this message and exit.

   Commands:
    browse  Open the issue tracker page for the given...
    logout  Forget saved passwords for the web services.
    pause   Pause work on the current issue.
    resume  Resume work on the currently active issue.
    setup   Run a wizard to create the user-level...
    time    Start an Harvest timer for the given issue.
    workon  Start work on a given issue.

TODO
----

A lot of commands are still missing, as for example:

* ``init``: to setup the project-level configuration for any given project.
* ``pr``: to open a new pull-request and update the tracker accordingly.
* ``review``: to streamline the whole reviewing process (pulling, linting,\
  diffs,...).
* ``merge``: to help in getting a more strict merge process in place (and
  cleanup afterwards). Can include rebasing helpers.
* Other issue tracker/Harvest interaction utilities (``list``, ``search``,
  ``comment``, ...)




