Metadata-Version: 2.1
Name: ttool
Version: 0.2.2
Summary: Tugys utils tools
License: MIT
Author: IamTugy
Author-email: tugmica@gmail.com
Requires-Python: >=3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: dacite (>=1.7.0,<2.0.0)
Requires-Dist: docopt (>=0.6.2,<0.7.0)
Requires-Dist: inquirer (>=3.1.2,<4.0.0)
Requires-Dist: jira (>=3.4.1,<4.0.0)
Requires-Dist: requests-toolbelt (>=0.10.1,<0.11.0)
Requires-Dist: typer (>=0.7.0,<0.8.0)
Description-Content-Type: text/markdown

# TTOOL (Tugy Tools)

This Repository is for utils that me, Tugy, thought that will be usefull.

Author: [Tugy](https://github.com/IamTugy) | Github Repo: [tugytools](https://github.com/IamTugy/tugytools)

## Installation:
    $ pip install ttool
## Packages:
### Jira:
To use the Jira utils you need to create 2 Global variables:
`JIRA_API_TOKEN` and `JIRA_MAIL`.
Get your `JIRA_API_TOKEN` [here](https://id.atlassian.com/manage-profile/security/api-tokens).

Your `JIRA_MAIL` should store your jira mail ofc..

I suggest that you store this values in `$HOME/.bashrc` or `$HOME/.aliases` if you have one.

    $ ttool jira --help

    Usage: ttool jira [OPTIONS] COMMAND [ARGS]...

    Options:
      --help  Show this message and exit.
    
    Commands:
      checkout  Checkout/Print your chosen jira issue with...
      setup     Set up your jira configurations.

#### The Setup Command
To setup a local config file to store your jira project and host.

    $ ttool jira setup --help

    Usage: ttool jira setup [OPTIONS]

      Set up your jira configurations.

    Options:
      --help  Show this message and exit.

#### The Checkout Command:
It really annoyed me every time to copy the key and description from the jira and create indicative branch names.
So this command let you pick a ticket of yours from the jira in the CLI, and then checkout to a branch with this syntax:
`ISSUE-123/My-issue-description`

    $ ttool jira checkout --help
    
    Usage: ttool jira checkout [OPTIONS]
    
      Checkout/Print your chosen jira issue with 'ISSUE-ID/the-issue-summery'
      format. use --print to print the branch name without checkout
    
    Options:
      --print / --no-print  [default: no-print]
      --help                Show this message and exit.

