Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andre-filho/ezissue
A python CLI program to help the issue creation
https://github.com/andre-filho/ezissue
cli ez-issue ezissue github-api gitlab-api hacktoberfest hacktoberfest2020 issue issue-creation issue-management
Last synced: about 1 month ago
JSON representation
A python CLI program to help the issue creation
- Host: GitHub
- URL: https://github.com/andre-filho/ezissue
- Owner: andre-filho
- License: gpl-3.0
- Created: 2019-04-02T14:51:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-06-01T23:39:02.000Z (over 3 years ago)
- Last Synced: 2024-10-01T15:08:00.391Z (about 2 months ago)
- Topics: cli, ez-issue, ezissue, github-api, gitlab-api, hacktoberfest, hacktoberfest2020, issue, issue-creation, issue-management
- Language: Python
- Homepage: https://pypi.org/project/ezissue/
- Size: 82 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
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.
```bash
$ 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)
| **Header name** | Description | Github support | Gitlab support |
| ------------------- | :----------------------------------------------------------- | :-------------------------------: | :----------------------------------------------------------: |
| Title* | Issue’s title | Y | Y |
| Description | Issue’s body or description | Y | Y |
| Tasks | Will be a list of checkboxes. Items must be separated with commas. | Y (goes with description) | Y (goes with description) |
| Acceptance criteria | Will be a list of checkboxes. Items must be separated with commas. | Y (goes with description) | Y (goes with description) |
| Assignee** | User that is assigned to the issue | Y (assignee’s username) | N (see next row) |
| Assignees** | List of users assigned to the issue | Y (array of assignee’s usernames) | Y (is a array of user ids) |
| Labels** | List of labels that are to be applied to the issue | Y (array of strings) | Y ( string, separated by commas) |
| Confidential** | Toggles the confidentiality of the issue | N | Y (boolean value) |
| Milestone** | Adds a milestone to the issue | Y (number of milestone) | Y (milestone id) |
| Due** | Sets a due date for stressing out your team | N | Y (datetime string in format `YYYY-MM-DD`) |
| Discussion** | Links the issue to a discussion thread | N | Y (id of the discussion that it solves. Fills the description automatically) |
| Weight** | Sets the issue’s weight. Best used in XP | N | Y (integer with the issue’s weight, must be bigger than zero) |
**Examples:**
The issue output format is the following:
```markdown
| title | description | acceptance criteria |
| ----- | ----------- | ------------------- |
| issue title | brief description | condition a;condition b;condition c |
```
```markdown
issue title
**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:
```bash
$ 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](https://codebeat.co/projects/github-com-andre-filho-ezissue-development/quick_wins) that you can look into. And be free to ask for new features, solve or add issues in our issue board. :)