Metadata-Version: 2.4
Name: terka
Version: 2.9.2
Summary: CLI utility for creating and managing tasks in a terminal
Author-email: Andrei Markin <andrey.markin.ppc@gmail.com>
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sqlalchemy==1.4.0
Requires-Dist: pyaml
Requires-Dist: rich
Requires-Dist: textual==0.41.0
Requires-Dist: plotext==5.2.8
Requires-Dist: textual-plotext==0.2.1
Requires-Dist: pandas
Requires-Dist: matplotlib
Provides-Extra: asana
Requires-Dist: asana; extra == "asana"
Provides-Extra: all
Requires-Dist: terka[asana]; extra == "all"
Dynamic: license-file

# Terka - Ter[minal] Ka[nban]
[![PyPI](https://img.shields.io/pypi/v/terka?logo=pypi&logoColor=white&style=flat-square)](https://pypi.org/project/terka)
[![Downloads](https://static.pepy.tech/badge/terka)](https://pypi.org/project/terka)
[![GitHub Workflow CI](https://img.shields.io/github/actions/workflow/status/AndreyMarkinPPC/terka/pytest.yml?branch=main&label=pytest&logo=python&logoColor=white&style=flat-square)](https://github.com/AndreyMarkinPPC/terka/actions/workflows/pytest.yml?branch=main)
[![codecov](https://codecov.io/gh/AndreyMarkinPPC/terka/graph/badge.svg?token=UIL7GKUVHN)](https://codecov.io/gh/AndreyMarkinPPC/terka)


`terka` (pronounced *tyorka* or *Тёрка*) is a CLI tool that helps you manage your tasks
in the terminal. Create task, assign it to a project, update it status, write
comments and many more!

Key features:
* Manage tasks within projects with CLI and Text UI interface
* Support for sprints (with story points assignment and time tracker)
* Manage meta-tasks with epics and stories
* Tag tasks and specify collaborators

## Installation

To install `terka` run the following command:

`pip install terka[all]`
> install the latest development version with `pip install -e git+https://github.com/AndreyMarkinPPC/terka.git#egg=terka[all]`

It will make `terka` command available in your shell.

After `terka` is installed run `terka init` to initialize necessary DB and
config files.

## Usage

The general structure of `terka` command goes as follows:

`terka <command> <entity> [options]`

`terka` exposes several commands (`create`, `update`, `show`, `list`, etc)
and entities (`tasks`, `projects`, `users`, `sprints`, `epics`, `stories`).
Please refer to the [list of commands](docs/command_examples.md) available in terka.
