{"id":28433012,"url":"https://github.com/decidim/decidim-maintainers_toolbox","last_synced_at":"2026-03-07T20:03:14.265Z","repository":{"id":221359202,"uuid":"754018331","full_name":"decidim/decidim-maintainers_toolbox","owner":"decidim","description":"Release related tools for the Decidim project. Tools for releasing, backporting, changelog generating, and working with GitHub.","archived":false,"fork":false,"pushed_at":"2025-06-02T07:28:19.000Z","size":79,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-10-15T16:27:11.220Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/decidim.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-07T08:36:43.000Z","updated_at":"2025-04-30T13:16:00.000Z","dependencies_parsed_at":"2025-04-19T20:24:45.330Z","dependency_job_id":"3691d6aa-8d0f-4fa2-86a0-833454fe0282","html_url":"https://github.com/decidim/decidim-maintainers_toolbox","commit_stats":{"total_commits":11,"total_committers":3,"mean_commits":"3.6666666666666665","dds":0.6363636363636364,"last_synced_commit":"6c4285ec45fbdc991b680c6c7cda172658eca841"},"previous_names":["decidim/decidim-maintainers_toolbox"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/decidim/decidim-maintainers_toolbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decidim%2Fdecidim-maintainers_toolbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decidim%2Fdecidim-maintainers_toolbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decidim%2Fdecidim-maintainers_toolbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decidim%2Fdecidim-maintainers_toolbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/decidim","download_url":"https://codeload.github.com/decidim/decidim-maintainers_toolbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decidim%2Fdecidim-maintainers_toolbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30229589,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T19:01:10.287Z","status":"ssl_error","status_checked_at":"2026-03-07T18:59:58.103Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2025-06-05T17:36:40.169Z","updated_at":"2026-03-07T20:03:14.250Z","avatar_url":"https://github.com/decidim.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Decidim::MaintainersToolbox\n\nRelease related tools for the Decidim project.\n\nTools for releasing, backporting, changelog generating, and working with GitHub\n\n## Installation\n\nThis gem is meant to be used outside of bundler/Gemfile so we do not need to bump the version every time we release a new one to each of the releases branch.\n\n```console\ngem install decidim-maintainers_toolbox\n```\n\n## Usage\n\nThis gem allows preparing and working with Decidim releases. Is it meant to be used by maintainers of the project. In the near future most of these tools will be used by `decidim-bot`.\n\nThere are a couple differences with the rest of the gems of this repository:\n\n* About the versioning: as it has not decidim nor decidim-core as dependencies, and to keep it easy to work with, we will not have the same versioning as the others gems.\n* About the ruby version: to make it possible to work with older decidim versions, we will support the lowest supported ruby version.\n\nThis is the reason why its in a different repository and not in the decidim repository.\n\nThe main scripts are `decidim-backporter`, `decidim-backports-checker`, `decidim-changelog-generator` and `decidim-releaser`.\n\n### decidim-backporter\n\nSee [Backports documentation](https://docs.decidim.org/en/develop/develop/backports)\n\n### decidim-backports-checker\n\nSee [Backports documentation](https://docs.decidim.org/en/develop/develop/backports)\n\n### decidim-changelog-generator\n\nUsed for generating the changelog with all the Pull Requests that goes to the current release. To be used automatically by the `releaser` script.\n\n### decidim-releaser\n\nSee [Releasing new versions documentation](https://docs.decidim.org/en/develop/develop/maintainers/releases)\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Releases\n\nAs this gem is meant to be used outside of the main decidim gems, we will not follow the same versioning. We will release a new version of this gem every time we have a new feature or bugfix that we need to use. This also means that we will not follow the same release process.\n\nTo release this gem, follow these steps:\n\n1. Bump the version number in `lib/decidim/maintainers_toolbox/version.rb` following [Semantic Versioning](https://semver.org/).\n1. Update the `CHANGELOG.md` with the new version and the changes.\n1. Commit the changes: `git commit -m \"Prepare release v0.1.0\"`\n1. Create the new tag, push the changs, build and publish with `bundle exec rake release[origin]`\n\nMind that you will need to have the right permissions to push to the repository and publish the gem.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/decidim/decidim.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecidim%2Fdecidim-maintainers_toolbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecidim%2Fdecidim-maintainers_toolbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecidim%2Fdecidim-maintainers_toolbox/lists"}