decidim-maintainers_toolbox 0.6.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35c9637b473aa216da01007794b00cd0e78e0b0da6a650459d2c43120a14b7f8
-  data.tar.gz: 97e639c0b23cb99625b0f433fb1d7251d379db3e1a7be6769830a2c66345112d
+  metadata.gz: 43c171108faecc38579f7d0854e502380744ea446074bc23c1e50a51dfc3fc1b
+  data.tar.gz: 9d58cc373d319f370cddc0091bd28c7f4ce0d834aa872982463eb04288946407
 SHA512:
-  metadata.gz: 943e69599eef14d70effed56fdce8cb33ecac56c220083f67a222e8dea21e995feefec027a386fec776098a3ab73836dbe53f4957d1a0f34bed44f10e4972ee7
-  data.tar.gz: 3b4825382099f593179ce14eb31379dd640ede7d8f7c82d2157bdf8167f33ecaadd4b59f8f0f6dbdd90875a2771388b50afda5247ec5d9bf7d3ba6c70e628b23
+  metadata.gz: e58090d00b14fa68575e707174f9b509ec3b608cfc15ac4e57c76b6118e7bf03a7709a0e800f3d58ec7d40d349ed19be10cf2f7236125de950bcd414253c7f6c
+  data.tar.gz: 56eb19a35080737611395e5ffa24401c0d6de18df612138ba73a85393f835d725462c3e8705e3358c815475fed3c54103d773c9c7fcaf52ebc0479f732c33c80

data/lib/decidim/maintainers_toolbox/action_backporter.rb

@@ -65,7 +65,7 @@ module Decidim
 
         pull_request_metadata[:labels].map do |item|
           item.match(/release: v(\d+\.\d+)/) { |m| m[1] }
-        end.compact
+        end.compact.reverse
       end
 
       # Asks the metadata for a given issue or pull request on GitHub API

data/lib/decidim/maintainers_toolbox/github_manager/querier/by_issue_id.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "base"
+require "active_support/core_ext/object/blank"
 
 module Decidim
   module MaintainersToolbox

data/lib/decidim/maintainers_toolbox/release_candidate_version.rb

@@ -0,0 +1,335 @@
+# frozen_string_literal: true
+
+require_relative "changelog_generator"
+require_relative "releaser_utils"
+require_relative "github_manager/poster"
+
+module Decidim
+  module MaintainersToolbox
+    # Creates a release candidate version for this branch
+    #
+    # If we are in develop (i.e. v0.30.0.dev) it will create the rc1 (i.e. v0.30.0.rc1)
+    # If we are in the stable release with an rc (i.e. v0.30.0.rc1) it will create the next rc (i.e. v0.30.0.rc2)
+    # If we are in the stable release with a patch (i.e. v0.30.0) it will bail out
+    class ReleaseCandidateVersion
+      include Decidim::MaintainersToolbox::ReleaserUtils
+
+      # @param token [String] token for GitHub authentication
+      # @param working_dir [String] current working directory. Useful for testing purposes
+      def initialize(token:, working_dir: Dir.pwd)
+        @token = token
+        @working_dir = working_dir
+        @old_version_number = old_version_number
+      end
+
+      def call
+        check_branch_and_version_sanity
+        check_tests
+
+        prepare_next_development_version
+        prepare_next_release_candidate_version
+      end
+
+      # The version number for the release that we are preparing
+      #
+      # @return [String] the version number
+      def version_number
+        @version_number ||= next_version_number_for_release_candidate(@old_version_number)
+      end
+
+      private
+
+      # Returns the next branch that needs to be created for the RC.
+      #
+      # @return [String]
+      def release_branch
+        @release_branch ||= begin
+          major, minor, _patch = parsed_version_number(version_number)
+
+          "release/#{major}.#{minor}-stable"
+        end
+      end
+
+      def check_branch_and_version_sanity
+        return if develop_branch? && dev_version_number?
+        return if release_branch? && rc_version_number?
+
+        error_message = <<-EOERROR
+        Check if the branch is valid for a release candidate. It should be: 
+        - develop with a dev version (i.e. develop branch with 0.30.0.dev decidim version)
+        - stable branch with a release candidate version (i.e. release/0.30-stable branch with 0.30.rc1 decidim version)
+        EOERROR
+        exit_with_errors(error_message)
+      end
+
+      def develop_branch?
+        branch == "develop"
+      end
+
+      def dev_version_number?
+        @old_version_number.match? /dev$/
+      end
+
+      def release_branch?
+        branch.start_with?("release/")
+      end
+
+      def rc_version_number?
+        @old_version_number.match? /rc.$/
+      end
+
+      def prepare_next_development_version
+        return unless develop_branch? || dev_version_number?
+
+        run("git pull origin develop")
+
+        run("git checkout -b #{release_branch}")
+        run("git push origin #{release_branch}")
+
+        puts "*" * 80
+        puts "Create the stable branch in Crowdin and exit this shell to continue the release process"
+        puts "https://docs.decidim.org/en/develop/develop/maintainers/releases.html#_create_the_stable_branch_in_crowdin"
+        puts "*" * 80
+        system ENV.fetch("SHELL")
+
+        run("git checkout develop")
+
+        next_dev_version = next_version_number_for_dev(@old_version_number)
+        prepare_branch = "chore/prepare/#{next_dev_version}"
+        run("git checkout -b #{prepare_branch}")
+
+        bump_decidim_version(next_version_number_for_dev(@old_version_number))
+
+        run("bin/rake update_versions")
+        run("bin/rake patch_generators")
+        run("bin/rake bundle")
+        run("npm install")
+        run("bin/rake webpack") if Dir.exist?("decidim_app-design")
+
+        generate_empty_changelog
+        generate_empty_release_notes
+
+        run("git add .") 
+        run("git commit -m 'Bump develop to next release version'")
+        run("git push origin #{prepare_branch}")
+
+        create_develop_pull_request(prepare_branch, next_dev_version)
+      end
+
+      def prepare_next_release_candidate_version
+        run("git checkout #{release_branch}")
+        run("git checkout -b chore/prepare/#{version_number}")
+
+        bump_decidim_version(version_number)
+
+        run("bin/rake update_versions")
+        run("bin/rake patch_generators")
+        run("bin/rake bundle")
+
+        run("npm install")
+        run("bin/rake webpack") if Dir.exist?("decidim_app-design")
+
+        generate_changelog
+
+        run("git add .") 
+        run("git commit -m 'Bump to #{version_number} version'")
+        run("git push origin chore/prepare/#{version_number}")
+
+        create_pull_request
+
+        finish_message = <<~EOMESSAGE
+        Finished the release process
+        Next steps:
+
+        1. Wait for the tests to finish and check that everything is passing before releasing the version.
+        NOTE: When you bump the version, the generator tests will fail because the gems and NPM packages
+        have not been actually published yet (as in sent to rubygems/npm). You may see errors such as
+        No matching version found for @decidim/browserslist-config@~0.xx.y in the CI logs. This should
+        be fine as long as you have ensured that the generators tests passed in the previous commit.
+        2. Review and merge this PR
+        3. Once that PR is merged, run the following commands to create the tags and push the gems to RubyGems and the packages to NPM:
+        > git pull
+        > bin/rake release_all
+        4. Usually, at this point, the release branch is deployed to Metadecidim during, at least, one week to validate the stability of the version.
+        EOMESSAGE
+
+        puts "*" * 80
+        puts finish_message
+      end
+
+      # Given a version number, returns the next release candidate
+      #
+      # If the current version number is `dev`, then we return the `rc1` version
+      # If the current version number is `rc`, then we return the next `rc` version
+      # Else, it means is a `minor` or `patch` version. On those cases we raise an Exception, as releases candidates should
+      # be only done from a `dev` or a `rc` version.
+      #
+      # @raise [InvalidVersionTypeError]
+      #
+      # @param current_version_number [String] - The version number of the current version
+      #
+      # @return [String] - the new version number
+      def next_version_number_for_release_candidate(current_version_number)
+        if current_version_number.include? "dev"
+          major, minor, patch = parsed_version_number(current_version_number)
+          new_version_number = "#{major}.#{minor}.#{patch}.rc1"
+        elsif current_version_number.include? "rc"
+          new_rc_number = current_version_number.match(/rc(\d)/)[1].to_i + 1
+          new_version_number = current_version_number.gsub(/rc\d/, "rc#{new_rc_number}")
+        else
+          error_message = <<-EOMESSAGE
+          Trying to do a release candidate version from patch release. Bailing out.
+          You need to do a release candidate from a `dev` or from another `rc` version
+          EOMESSAGE
+          raise InvalidVersionTypeError, error_message
+        end
+
+        new_version_number
+      end
+
+      def next_version_number_for_dev(current_version_number)
+        major, minor, patch = parsed_version_number(current_version_number)
+
+        "#{major}.#{minor.to_i + 1}.#{patch}.dev"
+      end
+
+      def generate_empty_changelog
+        major, minor, patch = parsed_version_number(@old_version_number)
+
+        changelog_contents = <<-EOCHANGELOG
+# Changelog
+
+## [Unreleased](https://github.com/decidim/decidim/tree/HEAD)
+
+Nothing.
+
+...
+
+## Previous versions
+
+Please check [#{major}.#{minor}-stable](https://github.com/decidim/decidim/blob/release/#{major}.#{minor}-stable/CHANGELOG.md) for previous changes.
+EOCHANGELOG
+
+        File.write("CHANGELOG.md", changelog_contents)
+      end
+
+      def generate_empty_release_notes
+        release_notes_contents = <<-EORELEASE
+# Release Notes
+
+## 1. Upgrade notes
+
+NOTE: This is the draft for the releases notes. If you are an implementer or someone that is upgrading a Decidim installation, we recommend
+checking out the last version of this document in the [GitHub page for the releases of this branch](https://github.com/decidim/decidim/releases/).
+
+As usual, we recommend that you have a full backup, of the database, application code and static files.
+
+To update, follow these steps:
+
+### 1.1. Update your ruby version
+
+If you're using rbenv, this is done with the following commands:
+
+```console
+rbenv install 3.x.x
+rbenv local 3.x.x
+```
+
+You may need to change your `.ruby-version` file too.
+
+If not, you need to adapt it to your environment, for instance by changing the decidim docker image to use ruby:3.x.x.
+
+### 1.2. Update your Gemfile
+
+```ruby
+gem "decidim", github: "decidim/decidim"
+gem "decidim-dev", github: "decidim/decidim"
+```
+
+### 1.3. Run these commands
+
+```console
+bundle update decidim
+bin/rails decidim:upgrade
+bin/rails db:migrate
+```
+
+### 1.4. Follow the steps and commands detailed in these notes
+
+## 2. General notes
+
+## 3. One time actions
+
+These are one time actions that need to be done after the code is updated in the production database.
+
+### 3.1. [[TITLE OF THE ACTION]]
+
+You can read more about this change on PR [#XXXX](https://github.com/decidim/decidim/pull/XXXX).
+
+## 4. Scheduled tasks
+
+Implementers need to configure these changes it in your scheduler task system in the production server. We give the examples
+with `crontab`, although alternatively you could use `whenever` gem or the scheduled jobs of your hosting provider.
+
+### 4.1. [[TITLE OF THE TASK]]
+
+```bash
+4 0 * * * cd /home/user/decidim_application && RAILS_ENV=production bundle exec rails decidim:TASK
+```
+
+You can read more about this change on PR [#XXXX](https://github.com/decidim/decidim/pull/XXXX).
+
+## 5. Changes in APIs
+
+### 5.1. [[TITLE OF THE CHANGE]]
+
+In order to [[REASONING (e.g. improve the maintenance of the code base)]] we have changed...
+
+If you have used code as such:
+
+```ruby
+# Explain the usage of the API as it was in the previous version
+result = 1 + 1 if before
+```
+
+You need to change it to:
+
+```ruby
+# Explain the usage of the API as it is in the new version
+result = 1 + 1 if after
+        ```
+EORELEASE
+
+        File.write("RELEASE_NOTES.md", release_notes_contents)
+      end
+
+      # Creates the pull request for bumping the develop version
+      #
+      # @param head_branch [String] the branch that we want to merge to develop
+      # @param next_dev_version [String] the name of the next dev version (for instance 0.99.0.dev)
+      #
+      # @return [void]
+      def create_develop_pull_request(head_branch, next_dev_version)
+        base_branch = "develop"
+
+        params = {
+          title: "Bump develop to next release version (#{next_dev_version})",
+          body: "#### :tophat: What? Why?
+
+This PR prepares the next develop version.
+
+#### Testing
+
+All the tests should pass
+
+:hearts: Thank you!
+          ",
+          labels: ["type: internal"],
+          head: head_branch,
+          base: base_branch
+        }
+        Decidim::MaintainersToolbox::GithubManager::Poster.new(token: @token, params: params).call
+      end
+    end
+  end
+end

data/lib/decidim/maintainers_toolbox/release_patch_version.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require_relative "releaser_utils"
+
+module Decidim
+  module MaintainersToolbox
+    class ReleasePatchVersion
+      include Decidim::MaintainersToolbox::ReleaserUtils
+
+      # @param token [String] token for GitHub authentication
+      # @param working_dir [String] current working directory. Useful for testing purposes
+      def initialize(token:, working_dir: Dir.pwd)
+        @token = token
+        @working_dir = working_dir
+      end
+
+      def call
+        exit_unless_release_branch
+
+        prepare_next_patch_version
+      end
+
+      # The version number for the release that we are preparing
+      #
+      # @return [String] the version number
+      def version_number
+        @version_number ||= next_version_number_for_patch_release(old_version_number)
+      end
+
+      private
+
+      # Raise an error if the branch does not start with the preffix "release/"
+      # or returns the branch name
+      #
+      # @raise [InvalidBranchError]
+      #
+      # @return [String]
+      def release_branch
+        @release_branch ||= branch
+      end
+
+      def exit_unless_release_branch
+        return if branch.start_with?("release/")
+
+        error_message = <<-EOERROR
+        This is not a release branch, change to the release branch branch to run this script.
+        EOERROR
+        exit_with_errors(error_message)
+      end
+
+      def prepare_next_patch_version
+        run("git checkout #{release_branch}")
+        run("git pull origin #{release_branch}")
+
+        bump_decidim_version(version_number)
+        run("bin/rake update_versions")
+
+        run("bin/rake patch_generators")
+
+        run("bin/rake bundle")
+        run("npm install")
+        run("bin/rake webpack") if Dir.exist?("decidim_app-design")
+
+        check_tests
+
+        generate_changelog
+
+        run("git checkout -b chore/prepare/#{version_number}")
+        run("git commit -a -m 'Prepare #{version_number} release'")
+        run("git push origin chore/prepare/#{version_number}")
+
+        create_pull_request
+      end
+
+      # Given a version number, returns the next patch release
+      #
+      # If the current version number is `dev`, then we raise an Exception, as you need to first do a release candidate.
+      # If the current version number is `rc`, then we return the `0` patch version
+      # Else, it means is a `patch` version, so we return the next patch version
+      #
+      # @raise [InvalidVersionTypeError]
+      #
+      # @param current_version_number [String] - The version number of the current version
+      #
+      # @return [String] - the new version number
+      def next_version_number_for_patch_release(current_version_number)
+        major, minor, patch = parsed_version_number(current_version_number)
+
+        if current_version_number.include? "dev"
+          error_message = <<-EOMESSAGE
+          Trying to do a patch version from dev release. Bailing out.
+          You need to do first a release candidate.
+          EOMESSAGE
+          raise InvalidVersionTypeError, error_message
+        elsif current_version_number.include? "rc"
+          new_version_number = "#{major}.#{minor}.0"
+        else
+          new_version_number = "#{major}.#{minor}.#{patch.to_i + 1}"
+        end
+
+        new_version_number
+      end
+    end
+  end
+end

data/lib/decidim/maintainers_toolbox/releaser.rb

@@ -1,20 +1,17 @@
 # frozen_string_literal: true
 
-require "open3"
-require_relative "github_manager/poster"
 require_relative "github_manager/querier/by_query"
-require_relative "changelog_generator"
+
+require_relative "releaser_utils"
+require_relative "release_candidate_version"
+require_relative "release_patch_version"
 
 module Decidim
   module MaintainersToolbox
     class Releaser
       class InvalidMetadataError < StandardError; end
 
-      class InvalidBranchError < StandardError; end
-
-      class InvalidVersionTypeError < StandardError; end
-
-      DECIDIM_VERSION_FILE = ".decidim-version"
+      include Decidim::MaintainersToolbox::ReleaserUtils
 
       # @param token [String] token for GitHub authentication
       # @param version_type [String] The kind of release that you want to prepare. Supported values: rc, minor, patch
@@ -32,223 +29,35 @@ module Decidim
           exit_if_unstaged_changes if @exit_with_unstaged_changes
           exit_if_pending_crowdin_pull_request
 
-          puts "Starting the release process for #{version_number} in 10 seconds"
+          case @version_type
+          when "rc"
+            release = ReleaseCandidateVersion.new(token: @token, working_dir: @working_dir)
+          # Minor release process is the same as the Patch release process
+          when "minor"
+            release = ReleasePatchVersion.new(token: @token, working_dir: @working_dir)
+          when "patch"
+            release = ReleasePatchVersion.new(token: @token, working_dir: @working_dir)
+          else
+            raise InvalidVersionTypeError, "This is not a valid version type"
+          end
+
+          puts "Starting the release process for #{release.version_number} in 10 seconds"
           sleep 10
 
-          run("git checkout #{release_branch}")
-          run("git pull origin #{release_branch}")
-
-          bump_decidim_version
-          run("bin/rake update_versions")
-
-          run("bin/rake patch_generators")
-
-          run("bin/rake bundle")
-          run("npm install")
-          run("bin/rake webpack") if Dir.exist?("decidim_app-design")
-
-          check_tests
-
-          generate_changelog
-
-          run("git checkout -b chore/prepare/#{version_number}")
-          run("git commit -a -m 'Prepare #{version_number} release'")
-          run("git push origin chore/prepare/#{version_number}")
-
-          create_pull_request
+          release.call
         end
       end
 
       private
 
-      # The git branch
-      #
-      # @return [String]
-      def branch
-        @branch ||= capture("git rev-parse --abbrev-ref HEAD")[0].strip
-      end
-
-      # Raise an error if the branch does not start with the preffix "release/"
-      # or returns the branch name
-      #
-      # @raise [InvalidBranchError]
-      #
-      # @return [String]
-      def release_branch
-        raise InvalidBranchError, "This is not a release branch, aborting" unless branch.start_with?("release/")
-
-        branch
-      end
-
-      # Changes the decidim version in the file
-      #
-      # @return [void]
-      def bump_decidim_version
-        File.write(DECIDIM_VERSION_FILE, version_number)
-      end
-
-      # The version number for the release that we are preparing
-      #
-      # @todo support the "minor" type version
-      #
-      # @return [String] the version number
-      def version_number
-        @version_number ||= case @version_type
-                            when "rc"
-                              next_version_number_for_release_candidate(old_version_number)
-                            when "patch"
-                              next_version_number_for_patch_release(old_version_number)
-                            else
-                              raise InvalidVersionTypeError, "This is not a supported version type"
-                            end
-      end
-
-      def parsed_version_number(version_number)
-        /(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/ =~ version_number
-
-        [major.to_i, minor.to_i, patch.to_i]
-      end
-
-      # Given a version number, returns the next release candidate
-      #
-      # If the current version number is `dev`, then we return the `rc1` version
-      # If the current version number is `rc`, then we return the next `rc` version
-      # Else, it means is a `minor` or `patch` version. On those cases we raise an Exception, as releases candidates should
-      # be only done from a `dev` or a `rc` version.
-      #
-      # @raise [InvalidVersionTypeError]
-      #
-      # @param current_version_number [String] - The version number of the current version
-      #
-      # @return [String] - the new version number
-      def next_version_number_for_release_candidate(current_version_number)
-        if current_version_number.include? "dev"
-          major, minor, patch = parsed_version_number(current_version_number)
-          new_version_number = "#{major}.#{minor}.#{patch}.rc1"
-        elsif current_version_number.include? "rc"
-          new_rc_number = current_version_number.match(/rc(\d)/)[1].to_i + 1
-          new_version_number = current_version_number.gsub(/rc\d/, "rc#{new_rc_number}")
-        else
-          error_message = <<-EOMESSAGE
-          Trying to do a release candidate version from patch release. Bailing out.
-          You need to do a release candidate from a `dev` or from another `rc` version
-          EOMESSAGE
-          raise InvalidVersionTypeError, error_message
-        end
-
-        new_version_number
-      end
-
-      # Given a version number, returns the next patch release
-      #
-      # If the current version number is `dev`, then we raise an Exception, as you need to first do a release candidate.
-      # If the current version number is `rc`, then we return the `0` patch version
-      # Else, it means is a `patch` version, so we return the next patch version
-      #
-      # @raise [InvalidVersionTypeError]
-      #
-      # @param current_version_number [String] - The version number of the current version
-      #
-      # @return [String] - the new version number
-      def next_version_number_for_patch_release(current_version_number)
-        major, minor, patch = parsed_version_number(current_version_number)
-
-        if current_version_number.include? "dev"
-          error_message = <<-EOMESSAGE
-          Trying to do a patch version from dev release. Bailing out.
-          You need to do first a release candidate.
-          EOMESSAGE
-          raise InvalidVersionTypeError, error_message
-        elsif current_version_number.include? "rc"
-          new_version_number = "#{major}.#{minor}.0"
-        else
-          new_version_number = "#{major}.#{minor}.#{patch.to_i + 1}"
-        end
-
-        new_version_number
-      end
-
-      # The version number from the file
-      #
-      # @return [String] the version number
-      def old_version_number
-        File.read(DECIDIM_VERSION_FILE).strip
-      end
-
-      # Run the tests and if fails restore the changes using git and exit with an error
-      #
-      # @return [void]
-      def check_tests
-        puts "Running specs"
-        output, status = capture("bundle exec rspec", env: { "ENFORCED_LOCALES" => "en,ca,es", "SKIP_NORMALIZATION" => "true" })
-
-        unless status.success?
-          run("git restore .")
-          puts output
-          exit_with_errors("Tests execution failed. Fix the errors and run again.")
-        end
-      end
-
-      # Generates the changelog taking into account the last time the version changed
-      #
-      # @return [void]
-      def generate_changelog
-        sha_version = capture("git log -n 1 --pretty=format:%h -- .decidim-version")[0]
-        ChangeLogGenerator.new(token: @token, since_sha: sha_version).call
-        temporary_changelog = File.read("./temporary_changelog.md")
-        legacy_changelog = File.read("./CHANGELOG.md")
-        version_changelog = "## [#{version_number}](https://github.com/decidim/decidim/tree/#{version_number})\n\n#{temporary_changelog}\n"
-        changelog = legacy_changelog.gsub("# Changelog\n\n", "# Changelog\n\n#{version_changelog}")
-        File.write("./CHANGELOG.md", changelog)
-      end
-
-      # Creates the pull request for bumping the version
-      #
-      # @return [void]
-      def create_pull_request
-        base_branch = release_branch
-        head_branch = "chore/prepare/#{version_number}"
-
-        params = {
-          title: "Bump to v#{version_number} version",
-          body: "#### :tophat: What? Why?
-
-This PR changes the version of the #{release_branch} branch, so we can publish the release once this is approved and merged.
-
-#### Testing
-
-All the tests should pass, except for some generators tests, that will fail because the gems and NPM packages have not
-been actually published yet (as in sent to rubygems/npm).
-You will see errors such as `No matching version found for @decidim/browserslist-config@~0.xx.y` in the CI logs.
-
-:hearts: Thank you!
-        ",
-          labels: ["type: internal"],
-          head: head_branch,
-          base: base_branch
-        }
-        Decidim::MaintainersToolbox::GithubManager::Poster.new(token: @token, params: params).call
-      end
-
-      # Captures to output of a command
-      #
-      # @return [Array<String, Process::Status>] The stdout and stderr of the command and its status (aka error code)
-      def capture(cmd, env: {})
-        Open3.capture2e(env, cmd)
-      end
-
-      # Runs a command
-      #
-      # @return [void]
-      def run(cmd, out: $stdout)
-        system(cmd, out: out)
-      end
-
       # Check if there is any open pull request from Crowdin in GitHub
       #
       # @return [Boolean] - true if there is any open PR
       def pending_crowdin_pull_requests?
-        pull_requests = Decidim::MaintainersToolbox::GithubManager::Querier::ByQuery.new(token: @token, query: { title: "New Crowdin updates", creator: "decidim-bot" }).call
+        pull_requests = Decidim::MaintainersToolbox::GithubManager::Querier::ByQuery.new(
+          token: @token,
+          query: { title: "New Crowdin updates", creator: "decidim-bot" }
+        ).call
         pull_requests.any?
       end
 
@@ -278,14 +87,6 @@ You will see errors such as `No matching version found for @decidim/browserslist
         EOERROR
         exit_with_errors(error_message)
       end
-
-      # Exit the script execution with a message
-      #
-      # @return [void]
-      def exit_with_errors(message)
-        puts message
-        exit 1
-      end
     end
   end
 end

data/lib/decidim/maintainers_toolbox/releaser_utils.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require "open3"
+require_relative "changelog_generator"
+require_relative "github_manager/poster"
+
+module Decidim
+  module MaintainersToolbox
+    module ReleaserUtils
+      class InvalidVersionTypeError < StandardError; end
+
+      DECIDIM_VERSION_FILE = ".decidim-version".freeze
+
+      # Exit the script execution with a message
+      #
+      # @return [void]
+      def exit_with_errors(message)
+        puts message
+        exit 1
+      end
+
+      # Captures to output of a command
+      #
+      # @return [Array<String, Process::Status>] The stdout and stderr of the command and its status (aka error code)
+      def capture(cmd, env: {})
+        Open3.capture2e(env, cmd)
+      end
+
+      # Runs a command
+      #
+      # @return [void]
+      def run(cmd, out: $stdout)
+        system(cmd, out: out, exception: true)
+      end
+
+      # The git branch
+      #
+      # @return [String]
+      def branch
+        @branch ||= capture("git rev-parse --abbrev-ref HEAD")[0].strip
+      end
+
+      # The version number from the file
+      #
+      # @return [String] the version number
+      def old_version_number
+        File.read(DECIDIM_VERSION_FILE).strip
+      end
+
+      def parsed_version_number(version_number)
+        /(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/ =~ version_number
+
+        [major.to_i, minor.to_i, patch.to_i]
+      end
+
+      # Run the tests and if fails restore the changes using git and exit with an error
+      #
+      # @return [void]
+      def check_tests
+        puts "Running specs"
+        output, status = capture("bin/rspec", env: { "ENFORCED_LOCALES" => "en,ca,es", "SKIP_NORMALIZATION" => "true" })
+
+        unless status.success?
+          run("git restore .")
+          puts output
+          exit_with_errors("Tests execution failed. Fix the errors and run again.")
+        end
+      end
+
+      # Generates the changelog taking into account the last time the version changed
+      #
+      # @return [void]
+      def generate_changelog
+        sha_version = capture("git log -n 1 --pretty=format:%h -- .decidim-version")[0]
+        ChangeLogGenerator.new(token: @token, since_sha: sha_version).call
+        temporary_changelog = File.read("./temporary_changelog.md")
+        legacy_changelog = File.read("./CHANGELOG.md")
+        version_changelog = "## [#{version_number}](https://github.com/decidim/decidim/tree/#{version_number})\n\n#{temporary_changelog}\n"
+        changelog = legacy_changelog.gsub("# Changelog\n\n", "# Changelog\n\n#{version_changelog}")
+        File.write("./CHANGELOG.md", changelog)
+      end
+
+      # Creates the pull request for bumping the version
+      #
+      # @return [void]
+      def create_pull_request
+        base_branch = release_branch
+        head_branch = "chore/prepare/#{version_number}"
+
+        params = {
+          title: "Bump to v#{version_number} version",
+          body: "#### :tophat: What? Why?
+
+This PR prepares version of the #{release_branch} branch, so we can publish the release once this is approved and merged.
+
+#### Testing
+
+All the tests should pass, except for some generators tests, that will fail because the gems and NPM packages have not
+been actually published yet (as in sent to rubygems/npm).
+You will see errors such as `No matching version found for @decidim/browserslist-config@~0.xx.y` in the CI logs.
+
+:hearts: Thank you!
+          ",
+          labels: ["type: internal"],
+          head: head_branch,
+          base: base_branch
+        }
+        Decidim::MaintainersToolbox::GithubManager::Poster.new(token: @token, params: params).call
+      end
+
+      # Changes the decidim version in the file
+      #
+      # @return [void]
+      def bump_decidim_version(new_version_number)
+        File.write(DECIDIM_VERSION_FILE, new_version_number)
+      end
+    end
+  end
+end
+

data/lib/decidim/maintainers_toolbox/version.rb

@@ -2,6 +2,6 @@
 
 module Decidim
   module MaintainersToolbox
-    VERSION = "0.6.0"
+    VERSION = "0.7.1"
   end
 end

metadata

@@ -1,11 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: decidim-maintainers_toolbox
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Andrés Pereira de Lucena
-autorequire:
 bindir: exe
 cert_chain: []
 date: 1980-01-01 00:00:00.000000000 Z
@@ -130,7 +129,10 @@ files:
 - lib/decidim/maintainers_toolbox/github_manager/querier/by_label.rb
 - lib/decidim/maintainers_toolbox/github_manager/querier/by_query.rb
 - lib/decidim/maintainers_toolbox/github_manager/querier/related_issues.rb
+- lib/decidim/maintainers_toolbox/release_candidate_version.rb
+- lib/decidim/maintainers_toolbox/release_patch_version.rb
 - lib/decidim/maintainers_toolbox/releaser.rb
+- lib/decidim/maintainers_toolbox/releaser_utils.rb
 - lib/decidim/maintainers_toolbox/version.rb
 homepage: https://decidim.org
 licenses:
@@ -141,7 +143,6 @@ metadata:
   funding_uri: https://opencollective.com/decidim
   homepage_uri: https://decidim.org
   source_code_uri: https://github.com/decidim/decidim
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -156,8 +157,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key:
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Release related tools for the Decidim project
 test_files: []