fastlane-plugin-github_api 0.1.0

data/lib/fastlane/plugin/github_api/actions/github_create_pull_review_action.rb

@@ -0,0 +1,224 @@
+require 'fastlane/action'
+require_relative '../helper/github_api_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      GITHUB_CREATE_PULL_REVIEW_STATUS_CODE = :GITHUB_CREATE_PULL_REVIEW_STATUS_CODE
+      GITHUB_CREATE_PULL_REVIEW_RESPONSE = :GITHUB_CREATE_PULL_REVIEW_RESPONSE
+      GITHUB_CREATE_PULL_REVIEW_JSON = :GITHUB_CREATE_PULL_REVIEW_JSON
+    end
+
+    class GithubCreatePullReviewAction < Action
+      class << self
+        def run(params)
+          require 'json'
+          
+          # Prepare API call parameters
+          server_url = params[:server_url]
+          api_token = params[:api_token]
+          repo_owner = params[:repo_owner]
+          repo_name = params[:repo_name]
+          pull_number = params[:pull_number]
+          
+          # Build the path
+          path = "/repos/#{repo_owner}/#{repo_name}/pulls/#{pull_number}/reviews"
+          
+          # Build body parameters
+          body_params = {}
+          body_params[:commit_id] = params[:commit_id] if params[:commit_id]
+          body_params[:body] = params[:body] if params[:body]
+          body_params[:event] = params[:event] if params[:event]
+          
+          # Add comment review if comments parameter is provided
+          if params[:comments] && !params[:comments].empty?
+            body_params[:comments] = params[:comments]
+          end
+          
+          UI.message("Creating review for pull request ##{pull_number} in #{repo_owner}/#{repo_name}")
+          response = Helper::GithubApiHelper.github_api_request(
+            token: api_token,
+            path: path,
+            params: body_params,
+            method: :post,
+            server_url: server_url
+          )
+          
+          status_code = response[:status]
+          json_response = response[:json]
+          result = {
+            status: status_code,
+            body: response[:body],
+            json: json_response
+          }
+          
+          if status_code.between?(200, 299)
+            review_id = json_response['id']
+            UI.success("Successfully created review #{review_id} for pull request ##{pull_number}")
+          else
+            UI.error("Error creating pull request review: #{status_code}")
+            UI.error(response[:body])
+            UI.user_error!("GitHub API returned #{status_code}: #{response[:body]}")
+            return nil
+          end
+          
+          # Store the results in shared values
+          Actions.lane_context[SharedValues::GITHUB_CREATE_PULL_REVIEW_STATUS_CODE] = status_code
+          Actions.lane_context[SharedValues::GITHUB_CREATE_PULL_REVIEW_RESPONSE] = response[:body]
+          Actions.lane_context[SharedValues::GITHUB_CREATE_PULL_REVIEW_JSON] = json_response
+          
+          return result
+        end
+        
+        #####################################################
+        # @!group Documentation
+        #####################################################
+        
+        def description
+          "Creates a review for a pull request"
+        end
+        
+        def details
+          [
+            "Creates a new review for a specified pull request in a GitHub repository.",
+            "You must provide your GitHub Personal token (get one from https://github.com/settings/tokens/new).",
+            "API Documentation: https://docs.github.com/en/rest/pulls/reviews#create-a-review-for-a-pull-request"
+          ].join("\n")
+        end
+        
+        def available_options
+          [
+            FastlaneCore::ConfigItem.new(key: :api_token,
+                                 env_name: "GITHUB_API_TOKEN",
+                              description: "GitHub API token",
+                                 optional: false,
+                                sensitive: true,
+                       code_gen_sensitive: true,
+                            default_value: ENV["GITHUB_API_TOKEN"],
+                             verify_block: proc do |value|
+                               UI.user_error!("No GitHub API token given, pass using `api_token: 'token'`") if value.to_s.empty?
+                             end),
+            FastlaneCore::ConfigItem.new(key: :server_url,
+                                 env_name: "GITHUB_API_SERVER_URL",
+                              description: "GitHub API server URL",
+                                 optional: true,
+                            default_value: "https://api.github.com"),
+            FastlaneCore::ConfigItem.new(key: :repo_owner,
+                                 env_name: "GITHUB_API_REPO_OWNER",
+                              description: "Owner of the repository",
+                                 optional: false),
+            FastlaneCore::ConfigItem.new(key: :repo_name,
+                                 env_name: "GITHUB_API_REPO_NAME",
+                              description: "Name of the repository",
+                                 optional: false),
+            FastlaneCore::ConfigItem.new(key: :pull_number,
+                                 env_name: "GITHUB_API_PULL_NUMBER",
+                              description: "The number of the pull request",
+                                 optional: false,
+                                     type: Integer),
+            FastlaneCore::ConfigItem.new(key: :commit_id,
+                                 env_name: "GITHUB_API_COMMIT_ID",
+                              description: "The SHA of the commit that needs a review. Required when using REQUEST_CHANGES or COMMENT for events",
+                                 optional: true,
+                                     type: String),
+            FastlaneCore::ConfigItem.new(key: :body,
+                                 env_name: "GITHUB_API_REVIEW_BODY",
+                              description: "Text content of the review",
+                                 optional: true,
+                                     type: String),
+            FastlaneCore::ConfigItem.new(key: :event,
+                                 env_name: "GITHUB_API_REVIEW_EVENT",
+                              description: "The review action to perform: APPROVE, REQUEST_CHANGES, or COMMENT",
+                                 optional: true,
+                                     type: String,
+                             verify_block: proc do |value|
+                               UI.user_error!("Event must be one of: APPROVE, REQUEST_CHANGES, COMMENT") unless ["APPROVE", "REQUEST_CHANGES", "COMMENT"].include?(value)
+                             end),
+            FastlaneCore::ConfigItem.new(key: :comments,
+                                 env_name: "GITHUB_API_REVIEW_COMMENTS",
+                              description: "An array of comments to make during the review (for line-by-line commenting)",
+                                 optional: true,
+                                     type: Array)
+          ]
+        end
+
+        def output
+          [
+            ['GITHUB_CREATE_PULL_REVIEW_STATUS_CODE', 'The status code returned by the GitHub API'],
+            ['GITHUB_CREATE_PULL_REVIEW_RESPONSE', 'The full response body returned by the GitHub API'],
+            ['GITHUB_CREATE_PULL_REVIEW_JSON', 'The parsed JSON response returned by the GitHub API']
+          ]
+        end
+
+        def return_value
+          "Returns a hash containing the status code, response body, and parsed JSON response from the GitHub API."
+        end
+
+        def authors
+          ["crazymanish"]
+        end
+
+        def example_code
+          [
+            'github_create_pull_review(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              repo_owner: "fastlane",
+              repo_name: "fastlane",
+              pull_number: 123,
+              event: "APPROVE",
+              body: "LGTM! Great work."
+            )',
+            '# Create a review with comments on specific lines
+            github_create_pull_review(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              repo_owner: "fastlane",
+              repo_name: "fastlane",
+              pull_number: 123,
+              event: "COMMENT",
+              body: "Here are some comments on the pull request",
+              comments: [
+                {
+                  path: "file.rb",
+                  position: 10,
+                  body: "Consider using a more descriptive variable name here"
+                },
+                {
+                  path: "another_file.rb",
+                  position: 5,
+                  body: "This could be optimized"
+                }
+              ]
+            )',
+            '# Request changes in a review
+            github_create_pull_review(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              repo_owner: "fastlane",
+              repo_name: "fastlane",
+              pull_number: 123,
+              event: "REQUEST_CHANGES",
+              body: "Please make the following changes before this can be approved.",
+              commit_id: "abc123def456"
+            )',
+            '# Access the response data
+            result = github_create_pull_review(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              repo_owner: "fastlane",
+              repo_name: "fastlane",
+              pull_number: 123,
+              event: "COMMENT"
+            )
+            UI.message("Created review ID: #{result[:json]["id"]}")'
+          ]
+        end
+
+        def category
+          :source_control
+        end
+
+        def is_supported?(platform)
+          true
+        end
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/github_api/actions/github_create_repository_action.rb

@@ -0,0 +1,230 @@
+require 'fastlane/action'
+require_relative '../helper/github_api_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      GITHUB_CREATE_REPOSITORY_STATUS_CODE = :GITHUB_CREATE_REPOSITORY_STATUS_CODE
+      GITHUB_CREATE_REPOSITORY_RESPONSE = :GITHUB_CREATE_REPOSITORY_RESPONSE
+      GITHUB_CREATE_REPOSITORY_JSON = :GITHUB_CREATE_REPOSITORY_JSON
+    end
+
+    class GithubCreateRepositoryAction < Action
+      class << self
+        def run(params)
+          require 'json'
+          
+          # Prepare API call parameters
+          server_url = params[:server_url]
+          api_token = params[:api_token]
+          name = params[:name]
+          
+          # Validate parameters
+          UI.user_error!("No repository name given, pass using `name: 'repo-name'`") if name.to_s.empty?
+          
+          # Build the path
+          path = "/user/repos"
+          
+          # Build body parameters
+          body_params = {
+            name: name
+          }
+          
+          # Add optional parameters if provided
+          body_params[:description] = params[:description] if params[:description]
+          body_params[:homepage] = params[:homepage] if params[:homepage]
+          body_params[:private] = params[:private] unless params[:private].nil?
+          body_params[:has_issues] = params[:has_issues] unless params[:has_issues].nil?
+          body_params[:has_projects] = params[:has_projects] unless params[:has_projects].nil?
+          body_params[:has_wiki] = params[:has_wiki] unless params[:has_wiki].nil?
+          body_params[:auto_init] = params[:auto_init] unless params[:auto_init].nil?
+          body_params[:license_template] = params[:license_template] if params[:license_template]
+          body_params[:allow_squash_merge] = params[:allow_squash_merge] unless params[:allow_squash_merge].nil?
+          body_params[:allow_merge_commit] = params[:allow_merge_commit] unless params[:allow_merge_commit].nil?
+          body_params[:allow_rebase_merge] = params[:allow_rebase_merge] unless params[:allow_rebase_merge].nil?
+          
+          # If organization is provided, use the org repos endpoint
+          if params[:organization]
+            path = "/orgs/#{params[:organization]}/repos"
+          end
+          
+          UI.message("Creating repository: #{name}")
+          response = Helper::GithubApiHelper.github_api_request(
+            token: api_token,
+            path: path,
+            params: body_params,
+            method: :post,
+            server_url: server_url
+          )
+          
+          status_code = response[:status]
+          json_response = response[:json]
+          result = {
+            status: status_code,
+            body: response[:body],
+            json: json_response
+          }
+          
+          if status_code.between?(200, 299)
+            UI.success("Successfully created repository: #{json_response['full_name']}")
+          else
+            UI.error("Error creating repository: #{status_code}")
+            UI.error(response[:body])
+            UI.user_error!("GitHub API returned #{status_code}: #{response[:body]}")
+            return nil
+          end
+          
+          # Store the results in shared values
+          Actions.lane_context[SharedValues::GITHUB_CREATE_REPOSITORY_STATUS_CODE] = status_code
+          Actions.lane_context[SharedValues::GITHUB_CREATE_REPOSITORY_RESPONSE] = response[:body]
+          Actions.lane_context[SharedValues::GITHUB_CREATE_REPOSITORY_JSON] = json_response
+          
+          return result
+        end
+        
+        #####################################################
+        # @!group Documentation
+        #####################################################
+        
+        def description
+          "Creates a new GitHub repository"
+        end
+        
+        def details
+          [
+            "Creates a new repository on GitHub for the authenticated user or specified organization.",
+            "You must provide your GitHub Personal token (get one from https://github.com/settings/tokens/new).",
+            "API Documentation: https://docs.github.com/en/rest/repos/repos#create-a-repository-for-the-authenticated-user"
+          ].join("\n")
+        end
+        
+        def available_options
+          [
+            FastlaneCore::ConfigItem.new(key: :api_token,
+                                 env_name: "GITHUB_API_TOKEN",
+                              description: "GitHub API token",
+                                 optional: false,
+                                sensitive: true,
+                       code_gen_sensitive: true,
+                            default_value: ENV["GITHUB_API_TOKEN"],
+                             verify_block: proc do |value|
+                               UI.user_error!("No GitHub API token given, pass using `api_token: 'token'`") if value.to_s.empty?
+                             end),
+            FastlaneCore::ConfigItem.new(key: :server_url,
+                                 env_name: "GITHUB_API_SERVER_URL",
+                              description: "GitHub API server URL",
+                                 optional: true,
+                            default_value: "https://api.github.com"),
+            FastlaneCore::ConfigItem.new(key: :name,
+                              description: "The name of the new repository",
+                                 optional: false,
+                                     type: String,
+                              verify_block: proc do |value|
+                                UI.user_error!("No repository name provided, pass using `name: 'repo-name'`") if value.to_s.empty?
+                              end),
+            FastlaneCore::ConfigItem.new(key: :organization,
+                              description: "The organization name (if creating a repository for an organization)",
+                                 optional: true,
+                                     type: String),
+            FastlaneCore::ConfigItem.new(key: :description,
+                              description: "A short description of the repository",
+                                 optional: true,
+                                     type: String),
+            FastlaneCore::ConfigItem.new(key: :homepage,
+                              description: "A URL with more information about the repository",
+                                 optional: true,
+                                     type: String),
+            FastlaneCore::ConfigItem.new(key: :private,
+                              description: "Whether the repository is private (true) or public (false)",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :has_issues,
+                              description: "Whether to enable issues for this repository",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :has_projects,
+                              description: "Whether to enable projects for this repository",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :has_wiki,
+                              description: "Whether to enable the wiki for this repository",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :auto_init,
+                              description: "Whether to create an initial commit with README",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :license_template,
+                              description: "License template to include (e.g., 'mit', 'apache-2.0')",
+                                 optional: true,
+                                     type: String),
+            FastlaneCore::ConfigItem.new(key: :allow_squash_merge,
+                              description: "Whether to allow squash merges for pull requests",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :allow_merge_commit,
+                              description: "Whether to allow merge commits for pull requests",
+                                 optional: true,
+                               is_string: false),
+            FastlaneCore::ConfigItem.new(key: :allow_rebase_merge,
+                              description: "Whether to allow rebase merges for pull requests",
+                                 optional: true,
+                               is_string: false)
+          ]
+        end
+        
+        def output
+          [
+            ['GITHUB_CREATE_REPOSITORY_STATUS_CODE', 'The status code returned from the GitHub API'],
+            ['GITHUB_CREATE_REPOSITORY_RESPONSE', 'The full response body from the GitHub API'],
+            ['GITHUB_CREATE_REPOSITORY_JSON', 'The parsed JSON returned from the GitHub API']
+          ]
+        end
+        
+        def return_value
+          "A hash including the HTTP status code (:status), the response body (:body), and the parsed JSON (:json)."
+        end
+        
+        def authors
+          ["crazymanish"]
+        end
+        
+        def example_code
+          [
+            'github_create_repository(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              name: "my-new-repo",
+              description: "My awesome new repo",
+              private: true,
+              auto_init: true,
+              license_template: "mit"
+            )',
+            '# Create repository in an organization',
+            'github_create_repository(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              name: "org-repo",
+              organization: "my-org",
+              private: false,
+              has_issues: true,
+              has_wiki: false
+            )',
+            '# You can also access the response data',
+            'result = github_create_repository(
+              api_token: ENV["GITHUB_API_TOKEN"],
+              name: "my-new-repo"
+            )
+            UI.message("Created repository URL: #{result[:json]["html_url"]}")'
+          ]
+        end
+        
+        def category
+          :source_control
+        end
+        
+        def is_supported?(platform)
+          true
+        end
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/github_api/actions/github_delete_commit_comment_reaction_action.rb

@@ -0,0 +1,152 @@
+require 'fastlane/action'
+require_relative '../helper/github_api_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      GITHUB_DELETE_COMMIT_COMMENT_REACTION_STATUS_CODE = :GITHUB_DELETE_COMMIT_COMMENT_REACTION_STATUS_CODE
+      GITHUB_DELETE_COMMIT_COMMENT_REACTION_RESPONSE = :GITHUB_DELETE_COMMIT_COMMENT_REACTION_RESPONSE
+    end
+
+    class GithubDeleteCommitCommentReactionAction < Action
+      class << self
+        def run(params)
+          # Prepare API call parameters
+          server_url = params[:server_url]
+          api_token = params[:api_token]
+          repo_owner = params[:repo_owner]
+          repo_name = params[:repo_name]
+          comment_id = params[:comment_id]
+          reaction_id = params[:reaction_id]
+          
+          # Build the path
+          path = "/repos/#{repo_owner}/#{repo_name}/comments/#{comment_id}/reactions/#{reaction_id}"
+          
+          UI.message("Deleting reaction ##{reaction_id} for commit comment ##{comment_id} in #{repo_owner}/#{repo_name}")
+          response = Helper::GithubApiHelper.github_api_request(
+            token: api_token,
+            path: path,
+            method: :delete,
+            server_url: server_url,
+            headers: { 'Accept' => 'application/vnd.github.squirrel-girl-preview+json' }
+          )
+          
+          status_code = response[:status]
+          result = {
+            status: status_code,
+            body: response[:body]
+          }
+          
+          if status_code == 204
+            UI.success("Successfully deleted reaction ##{reaction_id} for commit comment ##{comment_id}")
+          else
+            UI.error("Error deleting reaction: #{status_code}")
+            UI.error(response[:body])
+            UI.user_error!("GitHub API returned #{status_code}: #{response[:body]}")
+            return nil
+          end
+          
+          # Store the results in shared values
+          Actions.lane_context[SharedValues::GITHUB_DELETE_COMMIT_COMMENT_REACTION_STATUS_CODE] = status_code
+          Actions.lane_context[SharedValues::GITHUB_DELETE_COMMIT_COMMENT_REACTION_RESPONSE] = response[:body]
+          
+          return result
+        end
+        
+        #####################################################
+        # @!group Documentation
+        #####################################################
+        
+        def description
+          "Delete a reaction from a commit comment"
+        end
+        
+        def details
+          [
+            "Deletes a reaction from a commit comment.",
+            "You must provide your GitHub Personal token (get one from https://github.com/settings/tokens/new).",
+            "API Documentation: https://docs.github.com/en/rest/reactions/reactions#delete-a-commit-comment-reaction"
+          ].join("\n")
+        end
+        
+        def available_options
+          [
+            FastlaneCore::ConfigItem.new(key: :api_token,
+                                 env_name: "GITHUB_API_TOKEN",
+                              description: "GitHub API token",
+                                 optional: false,
+                                sensitive: true,
+                       code_gen_sensitive: true,
+                            default_value: ENV["GITHUB_API_TOKEN"],
+                             verify_block: proc do |value|
+                               UI.user_error!("No GitHub API token given, pass using `api_token: 'token'`") if value.to_s.empty?
+                             end),
+            FastlaneCore::ConfigItem.new(key: :server_url,
+                                 env_name: "GITHUB_API_SERVER_URL",
+                              description: "GitHub server url",
+                                 optional: true,
+                            default_value: "https://api.github.com"),
+            FastlaneCore::ConfigItem.new(key: :repo_owner,
+                                 env_name: "GITHUB_API_REPO_OWNER",
+                              description: "Owner of the repository",
+                                 optional: false),
+            FastlaneCore::ConfigItem.new(key: :repo_name,
+                                 env_name: "GITHUB_API_REPO_NAME",
+                              description: "Name of the repository",
+                                 optional: false),
+            FastlaneCore::ConfigItem.new(key: :comment_id,
+                                 env_name: "GITHUB_API_COMMENT_ID",
+                              description: "The ID of the commit comment",
+                                 optional: false,
+                                     type: Integer),
+            FastlaneCore::ConfigItem.new(key: :reaction_id,
+                                 env_name: "GITHUB_API_REACTION_ID",
+                              description: "The ID of the reaction to delete",
+                                 optional: false,
+                                     type: Integer)
+          ]
+        end
+
+        def output
+          [
+            ['GITHUB_DELETE_COMMIT_COMMENT_REACTION_STATUS_CODE', 'The status code returned by the GitHub API'],
+            ['GITHUB_DELETE_COMMIT_COMMENT_REACTION_RESPONSE', 'The full response body returned by the GitHub API']
+          ]
+        end
+
+        def return_value
+          "Returns a hash containing the status code and response body from the GitHub API."
+        end
+
+        def authors
+          ["crazymanish"]
+        end
+
+        def is_supported?(platform)
+          true
+        end
+        
+        def example_code
+          [
+            'github_delete_commit_comment_reaction(
+              repo_owner: "octocat",
+              repo_name: "Hello-World",
+              comment_id: 123,
+              reaction_id: 456
+            )',
+            'result = github_delete_commit_comment_reaction(
+              repo_owner: "octocat",
+              repo_name: "Hello-World",
+              comment_id: 123,
+              reaction_id: 456
+            )
+            
+            if result[:status] == 204
+              puts "Reaction deleted successfully!"
+            end'
+          ]
+        end
+      end
+    end
+  end
+end