{"id":13552320,"url":"https://github.com/f3ath/cider","last_synced_at":"2026-02-13T05:13:02.737Z","repository":{"id":45240120,"uuid":"279144819","full_name":"f3ath/cider","owner":"f3ath","description":"Tools for Dart package maintainers","archived":false,"fork":false,"pushed_at":"2024-12-24T18:44:43.000Z","size":166,"stargazers_count":108,"open_issues_count":9,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T15:08:07.945Z","etag":null,"topics":["changelog","dart","hacktoberfest"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/cider","language":"Dart","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/f3ath.png","metadata":{"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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-12T20:43:21.000Z","updated_at":"2025-03-25T04:39:00.000Z","dependencies_parsed_at":"2024-05-13T10:46:15.837Z","dependency_job_id":"4fd4290c-6946-4545-9b34-511115035e35","html_url":"https://github.com/f3ath/cider","commit_stats":{"total_commits":50,"total_committers":8,"mean_commits":6.25,"dds":"0.43999999999999995","last_synced_commit":"9fee3ffa0cd6f269a2946564e1d48696b19df6b3"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f3ath%2Fcider","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f3ath%2Fcider/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f3ath%2Fcider/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/f3ath%2Fcider/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/f3ath","download_url":"https://codeload.github.com/f3ath/cider/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208150,"owners_count":20901570,"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":["changelog","dart","hacktoberfest"],"created_at":"2024-08-01T12:02:02.202Z","updated_at":"2026-02-13T05:13:02.732Z","avatar_url":"https://github.com/f3ath.png","language":"Dart","funding_links":[],"categories":["Dart"],"sub_categories":[],"readme":"![logo]\n\n# Cider (CI for Dart: Efficient Release)\n\nCider is a CLI tool for Dart package maintenance. It updates `CHANGELOG.md` and `pubspec.yaml` to help automate releases.\n\n## Assumptions\n\nCider expects:\n\n- a `CHANGELOG.md` file in the project root\n- changelog format compatible with [Keep a Changelog][Changelog]\n- simple Markdown in changelog entries (no HTML or complex formatting)\n- project versions that follow [Semantic Versioning 2.0.0][semver]\n\n## Installation\n\n```bash\ndart pub global activate cider\n```\n\n## Configuration\n\nConfigure Cider in `pubspec.yaml` under `cider`:\n\n```yaml\ncider:\n  link_template:\n    tag: https://github.com/example/project/releases/tag/%tag%\n    diff: https://github.com/example/project/compare/%from%...%to%\n    version: v%version% # default: %version%\n```\n\nPlaceholders:\n\n- `%from%` - previous version tag\n- `%to%` - current version tag\n- `%tag%` - release tag\n\n## Project root detection\n\nYou can run Cider from any subdirectory. It searches upward for `pubspec.yaml`.\n\nTo override auto-detection:\n\n```bash\ncider --project-root=/path/to/project version\n```\n\n## Changelog commands\n\nThese commands modify `CHANGELOG.md` unless stated otherwise.\n\n### Add an entry\n\n```bash\ncider log \u003ctype\u003e \u003cdescription\u003e\n```\n\n- `\u003ctype\u003e`: `added`, `changed`, `deprecated`, `removed`, `fixed`, `security`\n- `\u003cdescription\u003e`: one Markdown line\n\nExamples:\n\n```bash\ncider log changed 'Improve parser performance'\ncider log added 'Support workspace mode'\ncider log fixed 'Null pointer in changelog parser'\n```\n\n### Release `Unreleased` entries\n\n```bash\ncider release [options]\n```\n\nOptions:\n\n- `--date` - release date (default: today)\n\nIf `link_template.diff` is configured, Cider generates changelog diff links automatically.\n\n### Print changes for a version (read-only)\n\n```bash\ncider describe [\u003cversion\u003e] [options]\n```\n\n- `\u003cversion\u003e` defaults to `Unreleased` if omitted\n\nOptions:\n\n- `--only-body` - omit section header and link footer\n\n### List versions\n\n```bash\ncider list [options]\n```\n\nOptions:\n\n- `--include-yanked`, `-y`\n- `--include-unreleased`, `-u`\n\n## Version commands\n\nThese commands operate on `version` in `pubspec.yaml`.\n\n### Print current version (read-only)\n\n```bash\ncider version\n```\n\n### Set version\n\n```bash\ncider version \u003cnew_version\u003e\n```\n\n`\u003cnew_version\u003e` must be [SemVer][semver]-compatible.\n\nExamples:\n\n| Before   | Command                           | After          |\n|----------|-----------------------------------|----------------|\n| 1.2.3+1  | `cider version 3.2.1`             | 3.2.1          |\n| 0.2.1-dev| `cider version 0.0.1-alpha+42`    | 0.0.1-alpha+42 |\n\n### Yank / unyank a release in changelog\n\n```bash\ncider yank \u003cversion\u003e\ncider unyank \u003cversion\u003e\n```\n\nYanked versions are marked as `[YANKED]` in `CHANGELOG.md`.\n\n### Bump version\n\n```bash\ncider bump \u003cpart\u003e [options]\n```\n\n`\u003cpart\u003e` can be:\n\n- `breaking` (`y` for `0.y.z`, otherwise `x` for `x.y.z`)\n- `major`\n- `minor`\n- `patch`\n- `build`\n- `pre` (pre-release)\n- `release` (remove pre-release suffix)\n\nOptions:\n\n- `--keep-build` - keep existing build metadata\n- `--bump-build` - increment build metadata\n- `--build=\u003cvalue\u003e` - set build metadata explicitly\n- `--pre=\u003cprefix\u003e` - set pre-release prefix\n\nNotes:\n\n- For `pre` and `build`, Cider increments the rightmost dot-separated numeric identifier.\n- If no numeric identifier exists, Cider appends `.1`.\n- Per SemVer, build metadata does not affect version precedence.\n\nExamples:\n\n| Before           | Command                                     | After            |\n|------------------|---------------------------------------------|------------------|\n| 1.2.1-alpha+42   | `cider bump breaking`                       | 2.0.0            |\n| 0.2.1-alpha+42   | `cider bump breaking`                       | 0.3.0            |\n| 0.2.1-alpha+42   | `cider bump major`                          | 1.0.0            |\n| 0.2.1-alpha+42   | `cider bump minor`                          | 0.3.0            |\n| 0.2.1-alpha+42   | `cider bump patch`                          | 0.2.1            |\n| 0.2.1            | `cider bump patch`                          | 0.2.2            |\n| 0.2.1-alpha+42   | `cider bump pre`                            | 0.2.1-alpha.1    |\n| 1.2.1-alpha+42   | `cider bump breaking --keep-build`          | 2.0.0+42         |\n| 0.2.1-alpha+42   | `cider bump breaking --bump-build`          | 0.3.0+43         |\n| 0.2.1-alpha+42   | `cider bump major --build=2020-02-02`       | 1.0.0+2020-02-02 |\n| 0.2.1-alpha+42   | `cider bump minor --pre=alpha --bump-build` | 0.3.0-alpha+43   |\n| 0.2.1-alpha+42   | `cider bump release`                        | 0.2.1            |\n| 0.2.1-alpha+42   | `cider bump release --keep-build`           | 0.2.1+42         |\n\n## Exit codes\n\n| Code | Meaning |\n|------|---------|\n| 0    | Success |\n| 64   | Usage error (invalid arguments) |\n| 65   | Data error (missing/invalid project files) |\n| 70   | Internal software error (consider opening an issue) |\n\n[logo]: https://raw.githubusercontent.com/f3ath/cider/master/cider.png\n[semver]: https://semver.org\n[Changelog]: https://keepachangelog.com/en/1.1.0/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff3ath%2Fcider","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff3ath%2Fcider","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff3ath%2Fcider/lists"}