Takes a JIRA issue and creates a git branch
Project description
JIRA 2 Branch
Takes a JIRA issue and creates a git branch
Usage: jira2branch [OPTIONS] ISSUE_ID_OR_URL SOURCE_BRANCH
Simple program that takes a JIRA issue ID and creates a new local and
tracking remote branch
Options:
-n, --name-only Generates the branch name and prints it, no actual
branch will be created (default is False)
-p, --push Push newly created branch to remote (default is False)
-t, --target PATH Target repository (default is current directory)
-r, --merge-request Create merge request. Requires --push. (default is
False)
--help Show this message and exit.
- Branch naming format is as follows:
- {CONVENTIONAL_COMMIT_PREFIX}/{ISSUE_ID}_{ISSUE_TITLE}
Requirements
Requires Python 3.8
Dev env
pip install poetry
poetry install
pip install dist/jira2branch-[VERSION]-py3-none-any.whl
Afterwards, your command should be available:
$ jira2branch WT3-227 develop
fix/WT3-227_some-jira-issue
Credentials
JIRA credentials will be fetched from [USER HOME]/.j2b/secrets.ini
with the following format:
[JIRA CREDENTIALS]
# url =
# email =
# username =
# password =
# token =
WIP: GitLab credentials will also be required for automatic MR creation
Required fields
url
and email
are required.
Use either username
+ password
or token
depending on how access is configured
Usage
python main.py [JIRA_ISSUE_ID|JIRA_ISSUE_URL]
Examples
python main.py WT3-227 develop
python main.py https://company.atlassian.net/browse/WT3-227 develop
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
jira2branch-0.2.0.tar.gz
(8.6 kB
view hashes)
Built Distribution
Close
Hashes for jira2branch-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | daccc8a7e4dd0aade24c6365fddda72de51c3b24e356eb346be42443c79efed5 |
|
MD5 | 1f4305842a6283515da7ad054249b5a4 |
|
BLAKE2b-256 | 7c10808bcbf3086e3c84d98ca79c2a5529eb3410b7183a02e1ecdb3a58f80683 |