create_github_release 0.2.0

data/lib/create_github_release/tasks/commit_release.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Commit the files added for the release
+    #
+    # @api public
+    #
+    class CommitRelease < TaskBase
+      # Commit the files added for the release
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::CommitRelease.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        print 'Making release commit...'
+        `git commit -s -m 'Release #{options.tag}'`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error 'Could not make release commit'
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/create_github_release.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+require 'tempfile'
+
+module CreateGithubRelease
+  module Tasks
+    # Create the release in Github
+    #
+    # @api public
+    #
+    class CreateGithubRelease < TaskBase
+      # Create the release in Github
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::CreateGithubRelease.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        path = write_changelog_to_temp_file(generate_changelog)
+        begin
+          create_github_release(path)
+        ensure
+          File.unlink(path)
+        end
+      end
+
+      private
+
+      # Create the gh command to create the Github release
+      # @return [String] the command to run
+      # @api private
+      def gh_command(default_branch, tag, changelog_path)
+        "gh release create '#{tag}' " \
+          "--title 'Release #{tag}' " \
+          "--notes-file '#{changelog_path}' " \
+          "--target '#{default_branch}'"
+      end
+
+      # Create the Github release using the gh command
+      # @return [void]
+      # @raise [SystemExit] if the gh command fails
+      # @api private
+      def create_github_release(changelog_path)
+        print "Creating GitHub release '#{options.tag}'..."
+        `#{gh_command(options.default_branch, options.tag, changelog_path)}`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error 'Could not create release'
+        end
+      end
+
+      # Writes the changelog to a temporary file
+      # @return [void]
+      # @raise [SystemExit] if a temp file could not be created
+      # @api private
+      def write_changelog_to_temp_file(changelog)
+        begin
+          f = Tempfile.create
+        rescue StandardError => e
+          error "Could not create a temporary file: #{e.message}"
+        end
+        f.write(changelog)
+        f.close
+        f.path
+      end
+
+      # Build the command that generates the description of the new release
+      # @return [String] the command to run
+      # @api private
+      def docker_command(git_dir, from_tag, to_tag)
+        "docker run --rm --volume '#{git_dir}:/worktree' changelog-rs '#{from_tag}' '#{to_tag}'"
+      end
+
+      # Generate the description of the new release using docker
+      # @return [void]
+      # @raise [SystemExit] if the docker command fails
+      # @api private
+      def generate_changelog
+        print 'Generating changelog...'
+        command = docker_command(FileUtils.pwd, options.current_tag, options.next_tag)
+        `#{command}`.rstrip.lines[1..].join.tap do
+          if $CHILD_STATUS.success?
+            puts 'OK'
+          else
+            error 'Could not generate the changelog'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/create_release_branch.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Create the release branch in git
+    #
+    # @api public
+    #
+    class CreateReleaseBranch < TaskBase
+      # Create the release branch in git
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::CreateReleaseBranch.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        print "Creating branch '#{options.branch}'..."
+        `git checkout -b '#{options.branch}' > /dev/null 2>&1`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error "Could not create branch '#{options.branch}'" unless $CHILD_STATUS.success?
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/create_release_pull_request.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Create a pull request in Github with a list of changes
+    #
+    # @api public
+    #
+    class CreateReleasePullRequest < TaskBase
+      # Create a pull request in Github with a list of changes
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::CreateReleasePullRequest.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        path = write_pr_body_to_temp_file(generate_changelog)
+        begin
+          create_release_pr(path)
+        ensure
+          File.unlink(path)
+        end
+      end
+
+      private
+
+      # Create the Github pull request using the gh command
+      # @return [void]
+      # @raise [SystemExit] if the gh command fails
+      # @api private
+      def create_release_pr(path)
+        print 'Creating GitHub pull request...'
+        tag = options.tag
+        default_branch = options.default_branch
+        `gh pr create --title 'Release #{tag}' --body-file '#{path}' --base '#{default_branch}'`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error 'Could not create release pull request'
+        end
+      end
+
+      # The body of the pull request
+      # @return [String] the body of the pull request
+      # @api private
+      def pr_body(changelog)
+        <<~BODY.chomp
+          ## Change Log
+          #{changelog}
+        BODY
+      end
+
+      # Write the changelog to a new temporary file
+      # @return [String] the path to the temporary file
+      # @raise [SystemExit] if the temp could not be created
+      # @api private
+      def write_pr_body_to_temp_file(changelog)
+        begin
+          f = Tempfile.create
+        rescue StandardError => e
+          error "Could not create a temporary file: #{e.message}"
+        end
+        f.write(pr_body(changelog))
+        f.close
+        f.path
+      end
+
+      # The command to list the changes in the relese
+      # @return [String] the command to run
+      # @api private
+      def docker_command(git_dir, from_tag, to_tag)
+        "docker run --rm --volume '#{git_dir}:/worktree' changelog-rs '#{from_tag}' '#{to_tag}'"
+      end
+
+      # Generate the list of changes in the release using docker
+      # @return [String] the list of changes
+      # @raise [SystemExit] if the docker command fails
+      # @api private
+      def generate_changelog
+        print 'Generating changelog...'
+        command = docker_command(FileUtils.pwd, options.current_tag, options.next_tag)
+        `#{command}`.rstrip.lines[1..].join.tap do
+          if $CHILD_STATUS.success?
+            puts 'OK'
+          else
+            error 'Could not generate the changelog'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/create_release_tag.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Create a release tag in git
+    #
+    # @api public
+    #
+    class CreateReleaseTag < TaskBase
+      # Create a release tag in git
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::CreateReleaseTag.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        print "Creating tag '#{options.tag}'..."
+        `git tag '#{options.tag}'`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error "Could not create tag '#{options.tag}'"
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/push_release.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Push the release branch and tag to Github
+    #
+    # @api public
+    #
+    class PushRelease < TaskBase
+      # Push the release branch and tag to Github
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::PushRelease.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        print "Pushing branch '#{options.branch}' to remote..."
+        `git push --tags --set-upstream '#{options.remote}' '#{options.branch}' > /dev/null 2>&1`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error 'Could not push release commit'
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/update_changelog.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Update the changelog file with changes made since the last release
+    #
+    # @api public
+    #
+    class UpdateChangelog < TaskBase
+      # Update the changelog file with changes made since the last release
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::UpdateChangelog.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        current_tag = options.current_tag
+        next_tag = options.next_tag
+        next_tag_date = next_tag_date(next_tag)
+        new_release = new_release(current_tag, next_tag, next_tag_date)
+        update_changelog(existing_changelog, new_release)
+        stage_updated_changelog
+      end
+
+      private
+
+      # Add the updated changelog to the git staging area
+      # @return [void]
+      # @raise [SystemExit] if the git command fails
+      # @api private
+      def stage_updated_changelog
+        print 'Staging CHANGLOG.md...'
+
+        `git add CHANGELOG.md`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error 'Could not stage changes to CHANGELOG.md'
+        end
+      end
+
+      # Read the existing changelog file
+      # @return [String] the contents of the changelog file
+      # @raise [SystemExit] if the file cannot be read
+      # @api private
+      def existing_changelog
+        @existing_changelog ||= begin
+          File.read('CHANGELOG.md')
+        rescue Errno::ENOENT
+          ''
+        end
+      end
+
+      # Find the date the release tag was created using git
+      # @return [Date] the date the release tag was created
+      # @raise [SystemExit] if the git command fails
+      # @api private
+      def next_tag_date(next_tag)
+        @next_tag_date ||= begin
+          print "Determining date #{next_tag} was created..."
+          date = `git show --format=format:%aI --quiet "#{next_tag}"`
+          if $CHILD_STATUS.success?
+            puts 'OK'
+            Date.parse(date)
+          else
+            error 'Could not stage changes to CHANGELOG.md'
+          end
+        end
+      end
+
+      # Build the command to list the changes since the last release
+      # @return [String] the command to list the changes since the last release
+      # @api private
+      def docker_command(git_dir, from_tag, to_tag)
+        "docker run --rm --volume '#{git_dir}:/worktree' changelog-rs '#{from_tag}' '#{to_tag}'"
+      end
+
+      # Generate the new release section of the changelog
+      # @return [CreateGithubRelease::Release] the new release section of the changelog
+      # @raise [SystemExit] if the docker command fails
+      # @api private
+      def new_release(current_tag, next_tag, next_tag_date)
+        print 'Generating release notes...'
+        command = docker_command(FileUtils.pwd, current_tag, next_tag)
+        release_description = `#{command}`.rstrip.lines[1..].join
+        if $CHILD_STATUS.success?
+          puts 'OK'
+          ::CreateGithubRelease::Release.new(next_tag, next_tag_date, release_description)
+        else
+          error 'Could not generate the release notes'
+        end
+      end
+
+      # Update the changelog file with the changes since the last release
+      # @return [void]
+      # @raise [SystemExit] if the file cannot be written
+      # @api private
+      def update_changelog(existing_changelog, new_release)
+        print 'Updating CHANGELOG.md...'
+        changelog = ::CreateGithubRelease::Changelog.new(existing_changelog, new_release)
+        begin
+          File.write('CHANGELOG.md', changelog.to_s)
+        rescue StandardError => e
+          error "Could not write to CHANGELOG.md: #{e.message}"
+        end
+        puts 'OK'
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks/update_version.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'English'
+require 'create_github_release/task_base'
+
+module CreateGithubRelease
+  module Tasks
+    # Update the gem version using Bump
+    #
+    # @api public
+    #
+    class UpdateVersion < TaskBase
+      # Update the gem version using Bump
+      #
+      # @example
+      #   require 'create_github_release'
+      #
+      #   options = CreateGithubRelease::Options.new { |o| o.release_type = 'major' }
+      #   task = CreateGithubRelease::Tasks::UpdateVersion.new(options)
+      #   begin
+      #     task.run
+      #     puts 'Task completed successfully'
+      #   rescue SystemExit
+      #     puts 'Task failed'
+      #   end
+      #
+      # @return [void]
+      #
+      # @raise [SystemExit] if the task fails
+      #
+      def run
+        print 'Updating version...'
+        message, result = Bump::Bump.run(options.release_type, commit: false)
+        error "Could not bump version: #{message}" unless result.zero?
+
+        version_file = Bump::Bump.file
+        `git add "#{version_file}"`
+        if $CHILD_STATUS.success?
+          puts 'OK'
+        else
+          error "Could not stage changes to #{version_file}"
+        end
+      end
+    end
+  end
+end

data/lib/create_github_release/tasks.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CreateGithubRelease
+  # Tasks/commands used to creat the Github release
+  #
+  # @api public
+  #
+  module Tasks; end
+end
+
+require_relative 'tasks/commit_release'
+require_relative 'tasks/create_github_release'
+require_relative 'tasks/create_release_branch'
+require_relative 'tasks/create_release_pull_request'
+require_relative 'tasks/create_release_tag'
+require_relative 'tasks/push_release'
+require_relative 'tasks/update_changelog'
+require_relative 'tasks/update_version'

data/lib/create_github_release/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module CreateGithubRelease
+  # The version of this gem
+  VERSION = '0.2.0'
+end

data/lib/create_github_release.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'create_github_release/command_line_parser'
+
+require 'create_github_release/changelog'
+require 'create_github_release/options'
+require 'create_github_release/release'
+
+require 'create_github_release/assertion_base'
+require 'create_github_release/assertions'
+require 'create_github_release/release_assertions'
+
+require 'create_github_release/task_base'
+require 'create_github_release/tasks'
+require 'create_github_release/release_tasks'
+
+require 'create_github_release/version'
+
+# Main module for this gem
+module CreateGithubRelease
+end