{"id":22724456,"url":"https://github.com/meinto/glow","last_synced_at":"2025-04-13T19:05:34.560Z","repository":{"id":45049407,"uuid":"171368070","full_name":"meinto/glow","owner":"meinto","description":" A cli tool to adapt git-flow","archived":false,"fork":false,"pushed_at":"2023-12-18T23:13:34.000Z","size":1379,"stargazers_count":6,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-06-21T03:20:38.870Z","etag":null,"topics":["cli","git-flow","gitflow","gitflow-workflow","github","gitlab"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meinto.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}},"created_at":"2019-02-18T22:54:08.000Z","updated_at":"2023-08-22T11:25:11.000Z","dependencies_parsed_at":"2024-02-03T23:44:42.754Z","dependency_job_id":null,"html_url":"https://github.com/meinto/glow","commit_stats":null,"previous_names":[],"tags_count":122,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meinto%2Fglow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meinto%2Fglow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meinto%2Fglow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meinto%2Fglow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meinto","download_url":"https://codeload.github.com/meinto/glow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229082312,"owners_count":18017251,"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":["cli","git-flow","gitflow","gitflow-workflow","github","gitlab"],"created_at":"2024-12-10T15:06:41.418Z","updated_at":"2025-04-13T19:05:34.554Z","avatar_url":"https://github.com/meinto.png","language":"Go","readme":"# Glow - A CLI Tool to adapt Git-Flow\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/glow-goopher.png\" width=\"300\"\u003e\n\u003c/div\u003e\n\n## Installation\n\n**Mac OS**\n\n```bash\nbrew tap meinto/glow https://github.com/meinto/glow\nbrew install meinto/glow/glow\n```\n\n**Linux**\n\n```bash\nGVERSION=$(curl https://api.github.com/repos/meinto/glow/releases/latest -s | jq .name -r | cut -c 2-)\n\n# download i386 architecture\ncurl -Lo glow.tar.gz https://github.com/meinto/glow/releases/download/v${GVERSION}/glow_${GVERSION}_linux_i386.tar.gz\n# or x86_64 architecture\ncurl -Lo glow.tar.gz https://github.com/meinto/glow/releases/download/v${GVERSION}/glow_${GVERSION}_linux_x86_64.tar.gz\n\ntar -xvzf glow.tar.gz glow\nmv glow /usr/local/bin/git-glow\nrm glow.tar.gz\n```\n\n**manually**\n\nHere you can find all [available Binaries](https://github.com/meinto/glow/releases). Download the binary and run the install command:\n\n```bash\n\u003cname-of-binary\u003e install\n```\n\n## Workflow\n\n\u003e Important!  \n\u003e Some commands need additional information like git author or Gitlab namespace and project name.  \n\u003e These informations can be stored in a config file or can be passed through flags.\n\u003e To configure the glow.json config file run the \"init\" command\n\n![glow workflow](./assets/glow.jpg?raw=true)\n\n### Feature Development\n\nThe following command will create a new feature branch in the following form: `features/dvader/death-star`. The name of the author (`dvader`) is grabbed from the config file.\n\n```bash\n# author grabbed from config\nglow feature death-star\n```\n\nAfter you created the feature branch it is automatically checked out.  \nWhen you finish your feature you can create a merge request in Gitlab:\n\n```bash\n# Gitlab information grabbed from config\nglow close\n```\n\n### Create a release\n\nI recommend to use [Semver](https://semver.org/) for versioning. The following command will create a release branch with the following format: `release/v1.2.3`.\n\n```bash\nglow release 1.2.3\n```\n\n### Publish a release\n\nWhen you decide that the release is stable and you want to publish it, the following command will create a merge request on the main branch in Gitlab. You can configure the main branch name in the `glow.config.json`. Default is `master`.\n\n```bash\nglow publish\n```\n\n### Close a release\n\nAfter publishing the release, you have to merge all changes made on the release branch back into the dev branch. The following command creates a merge request of the release branch into the dev branch.\n\n```bash\nglow close\n```\n\n## Config\n\nFor some commands you must provide information like the url of your Gitlab instance or your Gitlab ci token. These informations can be put in a `glow.json` file. Glow will lookup this json in the directory where its executed.\n\nYou can create this json with the `init` command. The json will be automatically added to the `.gitignore`:\n\n```bash\nglow init\n```\n\n**List of all config params**\n\n_glow.config.json_\n\n```json\n{\n  \"author\": \"dvadar\",\n  \"gitProviderDomain\": \"https://gitlab.com\",\n  \"gitProvider\": \"gitlab\",\n  \"projectNamespace\": \"my-namespace\",\n  \"projectName\": \"my-project\",\n  \"gitPath\": \"/usr/local/bin/git\",\n  \"squashCommits\": true,\n  \"versionFile\": \"VERSION\",\n  \"versionFileType\": \"raw\",\n  \"logLevel\": \"info\",\n  \"mainBranch\": \"master\",\n  \"devBranch\": \"develop\"\n}\n```\n\n_glow.private.json_\n\n```json\n{\n  \"token\": \"abc\"\n}\n```\n\n## Git bindings\n\nglow uses the native git installation per default. The default configured path to git is `/usr/local/bin/git`. You can change the path with the flag `--gitPath` or the property `gitPath` in the config file.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeinto%2Fglow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeinto%2Fglow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeinto%2Fglow/lists"}