tisu 2.0

your project's issue tracker, in a text file

Tisú

Tisú [tiˈsu, tissue in spanish] allows to manage your (github) project's issue tracker, using a single text file

Note: this is a work in progress. Pull requests and feedback are welcome.

Install

$ pip3 install --user -U tisu

Usage

Tisú can import and export your issues using a simple markdown file, where each section is a different issue.

# issue title

issue body

If an issue already exists in your tracker, the number is a prefix in the title, wrapped by square brackets:

# [#1] issue title

In this case, Tisú will update that issue instead to create a new one.

This is the current command line help::

Tisú: your issue tracker, in a text file

Usage:
  tisu push <markdown_file> [--repo=<repo>] [(--username=<username> [--pass=<pass>]|--token=<token>)]
  tisu pull <markdown_file> [--repo=<repo>] [--state=<state>] [(--username=<username> [--pass=<pass>]|--token=<token>)]

Options:
  -h --help                 Show this screen.
  --version                 Show version.
  --repo=<repo>             Github repo (as: user/name). [default: inferred from git remote]
  --state=<state>           Filter by issue state [default: open].
  --username=<username>     Github username to send issues. Repo's username if no given.
  --pass=<pass>             Github password. Prompt if user is given and it is not.
  --token=<token>           Personal app token. Get one at https://github.com/settings/tokens

To access private repositories you need a personal access token.

Example

Suppose you want to push a couple of issues like in this TODO.md file.

$ tisu push TODO.md mgaitan/tisu
Github password:
Created #11: support metadata
Created #12: setup travis CI

Result in:

Then, I can pull and overwrite the file.

$ tisu pull TODO.md mgaitan/tisu

This is the result. As in this case I didn't change anything online, the content is (almost) the same, but note that each title has its ID number.

Working with metadata

Tisú can also synchronize the issue's metadata with ease.

The format is :<meta_var>: <value/s>, where <meta_var> is one assignee, labels or milestone. These metadata lines can be in any position under the title (and not neccesarily all, in this order nor all together) and if present, they are removed from the issue's description sent.

For example, create a new issue with some metadata

# Make a video

:assignee: mgaitan
:labels: docs, idea
:milestone: sprint 1

Make an screencast showing how to use Tisú.

If later you want to close this issue, you can add this metadata and push.

# [#13] Make a video

:assignee: mgaitan
:labels: docs, idea
:milestone: sprint 1

Make an screencast showing how to use Tisú.

:state: closed

Changelog

2.0 (2021-05-31)

• Adds support for personal app tokens. This allow to access private repos.

1.1 (2019-04-22)

• Bugfix: Assignee not set.
• Inferred repo.

0.2 (aka 1.0 )(2016-03-19)

• Bump 0.2.
• State support throught metadata.
• Sync metadata with github.
• Better test.
• Clean metadata from body.
• Parse metadata.
• Better readme.
• Todo file as example.

0.1 (2016-03-15)

• Touches in readme.
• Rename package.
• Basic functional push command. can create or update issues.
• Basic command line. can pull from github.
• Basic github fetcher.
• Parser receive path.
• Basic parser based on docutils.
• Create README.md.