{"id":15174093,"url":"https://github.com/cucumber/changelog","last_synced_at":"2025-10-01T10:31:58.641Z","repository":{"id":46131367,"uuid":"388222896","full_name":"cucumber/changelog","owner":"cucumber","description":"Read, validate and manipulate CHANGELOG.md files that follow keepachangelog.com specification","archived":false,"fork":true,"pushed_at":"2024-04-07T08:50:50.000Z","size":257,"stargazers_count":3,"open_issues_count":9,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-30T00:55:11.251Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"rcmachado/changelog","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cucumber.png","metadata":{"funding":{"open_collective":"cucumber"},"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-07-21T19:20:38.000Z","updated_at":"2024-10-04T08:37:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cucumber/changelog","commit_stats":{"total_commits":247,"total_committers":8,"mean_commits":30.875,"dds":0.5465587044534412,"last_synced_commit":"e4ae55815c36e0208adf2e34fc452353df88c0a9"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Fchangelog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Fchangelog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Fchangelog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Fchangelog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cucumber","download_url":"https://codeload.github.com/cucumber/changelog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234826078,"owners_count":18892740,"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-09-27T11:24:20.394Z","updated_at":"2025-10-01T10:31:53.352Z","avatar_url":"https://github.com/cucumber.png","language":"Go","funding_links":["https://opencollective.com/cucumber"],"categories":[],"sub_categories":[],"readme":"# changelog\n\n![Tests](https://github.com/cucumber/changelog/workflows/Tests/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/cucumber/changelog/badge.svg?branch=master)](https://coveralls.io/github/cucumber/changelog?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/cucumber/changelog)](https://goreportcard.com/report/github.com/cucumber/changelog)\n\n(This is a fork of https://github.com/rcmachado/changelog)\n\n`changelog` is a command-line application to read and manipulate\n`CHANGELOG.md` files that follows the [keepachangelog.com][] spec.\n\nIt can normalize the file (`fmt`), create a release (`release`) and\nshow a specific version (`show`). See [Usage](#usage) for details.\n\n## Table of Contents\n\n- [Usage](#usage)\n- [Installation](#installation)\n  - [Linux and macOS](#linux-and-macos)\n  - [Source](#source)\n- [Commands](#commands)\n  - [init](#init)\n  - [fmt](#fmt)\n  - [show](#show)\n  - [release](#release)\n- [Formatting](#formatting)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Usage\n\n```bash\n# Initialize a new CHANGELOG.md file\n$ changelog init --compare-url=https://github.com/myorg/myrepo/compare/abcdef...1234\n# Add a first message under \"Added\" section\n$ changelog added \"Initial commit\"\n# Create release\n$ changelog release 0.1.0\n# Show latest release number\n$ changelog latest\n=\u003e 0.1.0\n```\n\n## Installation\n\n### Linux and macOS\n\nThe easiest way to install it is to download the [latest version][]\nfrom GitHub releases.\n\nThere are precompiled binaries for macOS and Linux.\n\n### Source\n\nClone the repository and build the executable:\n\n```bash\nmake build\n```\n\nThis will generate a `changelog` binary that can be copied to `/usr/local/bin`:\n\n```bash\ncp changelog /usr/local/bin\n```\n\n## Commands\n\n```text\nchangelog manipulate and validate markdown changelog files following the keepachangelog.com specification.\n\nUsage:\n  changelog [command]\n\nAvailable Commands:\n  added       Add item under 'Added' section\n  bundle      Bundles files containing unrelased changelog entries\n  changed     Add item under 'Changed' section\n  deprecated  Add item under 'Deprecated' section\n  fixed       Add item under 'Fixed' section\n  fmt         Reformat the change log file\n  help        Help about any command\n  init        Initializes a new changelog\n  latest      Show latest released version number\n  release     Change Unreleased to [version]\n  removed     Add item under 'Removed' section\n  security    Add item under 'Security' section\n  show        Show changelog for [version]\n\nFlags:\n  -f, --filename string   Changelog file or '-' for stdin (default \"CHANGELOG.md\")\n  -h, --help              help for changelog\n  -o, --output string     Output file or '-' for stdout (default \"-\")\n\nUse \"changelog [command] --help\" for more information about a command.\n```\n\n### init\n\nOutputs a changelog with only preamble and Unreleased version to standard output. You can specify a filename using `--output/-o` flag:\n\n```bash\n$ touch CHANGELOG.md\n$ changelog init -o CHANGELOG.md --compare-url https://github.com/cucumber/changelog/compare/abcdef...HEAD\nChangelog file 'CHANGELOG.md' created.\n```\n\n### fmt\n\nNormalize file format (see [Formatting](#formatting) for the specific\ntransformation applied):\n\n```bash\nchangelog fmt\n```\n\n### show\n\nShow what will be in the next release:\n\n```bash\nchangelog show Unreleased\n```\n\nShow the change log for a specific version:\n\n```bash\nchangelog show 1.2.3\n```\n\n### release\n\nCreate a new release:\n\n```bash\nchangelog release 1.2.4\n```\n\nIf you use a prefix for git tags, specify a tag format:\n\n```bash\nchangelog release --tag-format \"v%s\" 1.2.4\n```\n\n### Formatting\n\n`fmt` command normalizes the changelog file. The idea is to always have\nthe same output, no matter how messy the file is. Right now it doesn't\ndo much, but the plan is to evolve it as a kind of `go fmt` for\nchangelogs.\n\nCurrently, the following transformations are applied:\n\n- Sections are sorted (eg. Added, Changed, etc)\n- Version links are put at the bottom of the file\n- List bullet is always `-`\n\n## Contributing\n\nFeel free to fork and submit a PR. You can also take a look, at the [Issues][] tab to see some ideas.\n\n## License\n\nLicensed under MIT. See [LICENSE][] file for details.\n\n[keepachangelog.com]: https://keepachangelog.com/\n[LICENSE]: ./LICENSE\n[Issues]: https://github.com/cucumber/changelog\n[latest version]: https://github.com/cucumber/changelog/releases/latest\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcucumber%2Fchangelog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcucumber%2Fchangelog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcucumber%2Fchangelog/lists"}