{"id":22086202,"url":"https://github.com/imjaroiswebdev/jiraissue-cli","last_synced_at":"2025-03-23T22:18:29.282Z","repository":{"id":221091105,"uuid":"753385596","full_name":"imjaroiswebdev/jiraissue-cli","owner":"imjaroiswebdev","description":"CLI App for creating Jira Issue to streamline my own Jira Issues creation workflow. (Not general propose yet)","archived":false,"fork":false,"pushed_at":"2024-07-04T14:39:13.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T05:28:23.448Z","etag":null,"topics":["jira","jira-rest-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imjaroiswebdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-06T02:26:03.000Z","updated_at":"2024-07-04T14:39:15.000Z","dependencies_parsed_at":"2025-01-29T05:35:08.480Z","dependency_job_id":null,"html_url":"https://github.com/imjaroiswebdev/jiraissue-cli","commit_stats":null,"previous_names":["imjaroiswebdev/jiraissue-cli"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjaroiswebdev%2Fjiraissue-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjaroiswebdev%2Fjiraissue-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjaroiswebdev%2Fjiraissue-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjaroiswebdev%2Fjiraissue-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imjaroiswebdev","download_url":"https://codeload.github.com/imjaroiswebdev/jiraissue-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245175526,"owners_count":20572790,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jira","jira-rest-api"],"created_at":"2024-12-01T01:21:54.034Z","updated_at":"2025-03-23T22:18:29.260Z","avatar_url":"https://github.com/imjaroiswebdev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jira issue creator cli\n\n## Description\n\nThis tool is a CLI application for creating issues in Jira based on a specific workflow a follow to manage Jira issues, at this point it is not intended to be of general use for the majority of cases.\n\nSupports creation of single Jira Issues through direct use `jiraissue` command passing in each Issue field through command flags. In addition, also support bulk creation of Jira Issues utilizing a **csv** file, which its path can be passed in with the `csv` flag.\n\n## Installation\n1. Clone the repository.\n2. Build the application: `go build`\n\n## Configuration\nSet the following environment variables:\n- `JIRA_API_TOKEN`: Your Jira API token. [(How to get one)](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/)\n- `JIRA_PROJECT_KEY`: The key of your Jira project. (e.g., **PROJ**)\n- `JIRA_SUBDOMAIN`: (Optional) Your Jira sub domain. (e.g., `https://\u003csubdomain\u003e.atlassian.net`)\n- `JIRA_ASSIGNEE_ID`: Jira issue assignee id. (e.g., `62703a40ca1fae106ae98fed`)\n\n## Usage\nRun the application with the necessary parameters:\n\n```bash\n$ go run ./cmd --help\nJira CLI to create issues\n\nUsage:\n  jiraissue [flags]\n\nFlags:\n      --assignee string         Issue assignee id\n  -c, --component stringArray   Components names separated list\n      --csv string              CSV file path for bulk Jira issues creation (e.g., ./jira_issues.csv)\n      --debug                   Enable debug of API calls\n  -d, --description string      Description of the issue\n      --dry-run                 Dry run mode, no issue will be created, but the payload will be printed\n  -e, --epic string             Epic Key (e.g., PROJ-2948)\n      --fixversion string       Fix version name for the issue\n  -h, --help                    help for jiraissue\n  -l, --label stringArray       Labels names separated list\n  -s, --summary string          Summary of the issue (required for single Issue creation)\n  -t, --time string             Time estimation in hours (e.g., 2h)\n```\n\n## Single Jira Issue creation\n\n```sh\n# Using JIRA_ASSIGNEE_ID env var\n$ go run ./cmd \\\n  --summary \"New Awesome created through jiraissue cli\" \\\n  --time \"4h\" \\\n  --description 'Issue created while testing `jiraissue` cli App' \\\n  --epic \"PROJ-1758\" \\\n  --component \"BACKEND\" \\\n  --component \"MIDDLEWARE\" \\\n  --component \"FRONTEND\" \\\n  --label \"AWESOME_LABEL\" \\\n  --label \"GREAT_LABEL\"\n# output\nIssue created. Link to issue https://pagerduty.atlassian.net/browse/PROJ-2920\n```\n\n## Bulk creation of Jira issues using CSV file\n\n### Content of CSV file `jira_issues.csv` used in the example\n\n```csv\nsummary;description;time;epic;components;labels;fixVersionName\nFirst issue created with CSV;This is a safe to delete issue created while testing jiraissue cli App;2h;PROJ-2496;BACKEND, MIDDLEWARE;AWESOME_LABEL, GREAT_LABEL;August 2024\nSecond issue created with CSV;This is a safe to delete issue created while testing jiraissue cli App;2h;PROJ-2496;FRONTEND;GREAT_LABEL;August 2024\n```\n\n```sh\n# Using --assignee flag\n$ go run ./cmd \\\n  --assignee '62703a40ca1fef006ae18fed' \\\n  --csv ./jira_issues.csv\n# output\nIssue created. Link to issue https://pagerduty.atlassian.net/browse/PROJ-2926\nIssue created. Link to issue https://pagerduty.atlassian.net/browse/PROJ-2927\n```\n\n## Using a `.env` file\n\nCreate a `.env` file in the root of the project with the following content:\n\n```sh\nJIRA_API_TOKEN=\u003cyour_jira_api_token\u003e\nJIRA_PROJECT_KEY=\u003cyour_jira_project_key\u003e\nJIRA_SUBDOMAIN=\u003cyour_jira_subdomain\u003e\n```\n\nThen a way to source the `.env` file variables is to run the following command:\n\n```sh\n$ export $(cat .env | xargs)\n```\n\nYou should be ready to run the application with the necessary parameters.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimjaroiswebdev%2Fjiraissue-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimjaroiswebdev%2Fjiraissue-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimjaroiswebdev%2Fjiraissue-cli/lists"}