{"id":16237923,"url":"https://github.com/codegoalie/goutrack","last_synced_at":"2025-04-08T08:48:44.108Z","repository":{"id":36811716,"uuid":"41118586","full_name":"codegoalie/goutrack","owner":"codegoalie","description":"YouTrack command line app written in Go","archived":false,"fork":false,"pushed_at":"2017-04-10T18:40:29.000Z","size":20,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T05:43:46.027Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/codegoalie.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-20T20:57:42.000Z","updated_at":"2021-04-16T20:40:29.000Z","dependencies_parsed_at":"2022-07-20T10:32:03.821Z","dependency_job_id":null,"html_url":"https://github.com/codegoalie/goutrack","commit_stats":null,"previous_names":["chrismar035/goutrack"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgoutrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgoutrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgoutrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codegoalie%2Fgoutrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codegoalie","download_url":"https://codeload.github.com/codegoalie/goutrack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247809287,"owners_count":20999806,"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":[],"created_at":"2024-10-10T13:37:58.025Z","updated_at":"2025-04-08T08:48:44.088Z","avatar_url":"https://github.com/codegoalie.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GouTrack\n\n[![baby-gopher](https://raw.githubusercontent.com/drnic/babygopher-site/gh-pages/images/babygopher-badge.png)](http://www.babygopher.org)\n\nGouTrack (pronounced _goo-trak_) is a command line interface for the YouTrack\nproject management system.\n\n## Install\n\nDownload one of the [pre-built\nbinaries](https://github.com/chrismar035/goutrack/releases/latest) for your\noperating system and place it in your PATH. If your OS does not have a\npre-built binary, please open an issue and I will make a binary for you, or\nfollow the steps below to install from source.\n\nAlternatively to the pre-built binaries, you can install from source by\ngo-getting:\n\n```\n$ go get github.com/chrismar035/goutrack\n```\n\n## Configuration\n\nGouTrack requires three pieces of information in order to locate your YouTrack\ninstallation and authenticate with your account. These are your YouTrack\ninstallation host, or URL, your username, and your password. There are two ways\nto specify this information.\n\nThe first and easiest way to specify your YouTrack information is with command\nline flags.\n\n```\n$ goutrack -h \u003cbase YouTrack URL\u003e -u \u003cYouTrack username\u003e -p \u003cYouTrack Password\u003e\n```\n\nThe second way to specify your login info is to add your information to a config\nfile. This file lives at `~/.goutrack` and is a YAML file. An example would be:\n\n```\n# ~/.goutrack\n\nhost: https://youtrack.com\nusername: best.youtrack.user\npassword: s00$up3rs3kr37\n```\n\nWhen you have a config file, you do not need to specify your credentials with\ncommand line flags. However, command line flags take prescedence over the\nconfig file.\n\n## Usage\n\nGouTrack uses a sub-command interface (think git). The basic format of commands\nare:\n\n```\n$ goutrack \u003ccommand\u003e \u003cstory ID\u003e [optional params]\n```\n\n### Get a story\n\nThe `g` sub-command fetches basic details about at story. There are no optional\nparams for this command.\n\n```\n$ goutrack g \u003cstory ID\u003e\n```\n\nThis command prints the raw response to the console.\n\n### Command a story\n\nThe `c` sub-command sends a YouTrack command string to be applied to the given\nstory. The `c` command takes a command string parameter and an optional comment\nstring second parameter\n\n```\n$ goutrack c \u003cstory\u003e \"\u003ccommand string\u003e\" [\"\u003ccomment string\u003e\"]\n```\n\nThe `c` command prints a verification string to the console and then the raw\nresponse from YouTrack. Successful commands return `\u003cnil\u003e`.\n\n#### Examples\n\n```\n$ goutrack c yt-1234 \"Assignee me\" \"I'll take this story.\"\n```\n\n```\n$ goutrack c yt-4321 \"Subsystem server-side\"\n```\n\n## Aliases\n\nGouTrack has aliases which can shorten frequently used commands. Simply define\na set of aliases in your config file and use the `a` sub-command to expand the\nalias.\n\n```\n# ~/.goutrack\n\n...\naliases:\n  complete: \"State: Complete\"\n  mine: \"Assigned to: me\"\n```\n\nThen, you can simply specify the alias as the command (with an optional comment\nstring).\n\n```\n$ goutrack a c-1234 complete\nApplying State: Complete to c-1234\n```\n\n## Contributing\n\nWhen contributing please\n\n1. [Fork](https://github.com/chrismar035/goutrack/fork) the repo\n1. Start a topic branch.\n1. Write awesome code!\n   1. Please break your commits into logical units.\n   1. Please add specs when necessary.\n1. Open a [Pull\n   Request](https://github.com/chrismar035/goutrack/pulls)\n1. See your awesomeness merged in!\n\n# Thanks and Happy GouTracking!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodegoalie%2Fgoutrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodegoalie%2Fgoutrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodegoalie%2Fgoutrack/lists"}