EZIssue

What does it do?

The ezissue cli is an application with command line interface which it's main objective is to help you in the issue creation process in your projects.

It takes a file with a markdown table with your issues, formats them and send them to your repo's API. Therefore you will no longer spend hours creating issues manually.

Why should I use this?

If you find that the issue creation process is painfull and it breaks your full-loko mood while developing something, this is for you.

But if you want to spend hours creating issues on Github or Gitlab and find it fun (I sincerely doubt it), who am I to tell you what to do!

Usage and configuration

CLI interface

This program has a CLI that you can take advantage of. Running ezissue --help will show you the usage and options for the CLI.

$ ezissue --help

  Usage: ezissue [OPTIONS] FILENAME [github|gitlab]

  Options:
    --subid TEXT
    --numerate BOOLEAN
    --prefix [US|TS||BUG]
    --help                 Show this message and exit.

Markdown file and configuration

The EZIssue program takes a .md file as argument. That file must have a markdown table for it to parse to issues. That table is a common md table and can have the following headers: (Note that headers with * are mandatory, and with ** are not yet implemented)

Examples:

The issue output format is the following:

 <!-- issue-table.md -->
 | title | description | acceptance criteria |
 | ----- | ----------- | ------------------- |
 | issue title | brief description | condition a;condition b;condition c |

  <!--title-->
  <PREFIX><SUBID><NUMBER> issue title
  <!--body-->
  **Issue description:**
  ---
  brief description

  **Acceptance criteria:**
  ---
  - [ ] condition a
  - [ ] condition b
  - [ ] condition c

Updating your current version

If you already have one of our pip releases installed in your machine and want to update to the latest version, use the command:

$ pip3 install --upgrade ezissue

Want to make a contribuition? Here are some quick stuff you can work on!

I want to thank you beforehand for your contribuition. Here you can find some quick fixes that you can look into. And be free to ask for new features, solve or add issues in our issue board. :)