fastlane-plugin-circle_ci 0.2.0 → 0.3.0

data/lib/fastlane/plugin/circle_ci/actions/circleci_get_pipeline_definition.rb

@@ -0,0 +1,99 @@
+require 'fastlane/action'
+require_relative '../helper/circle_ci_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      CIRCLECI_PIPELINE_DEFINITION = :CIRCLECI_PIPELINE_DEFINITION
+    end
+
+    class CircleciGetPipelineDefinitionAction < Action
+      def self.run(params)
+        UI.message("Getting CircleCI pipeline definition via API v2...")
+        
+        api_token = params[:api_token]
+        project_id = params[:project_id]
+        pipeline_definition_id = params[:pipeline_definition_id]
+        
+        # Make API request
+        result = Helper::CircleCiHelper.get_v2("projects/#{project_id}/pipeline-definitions/#{pipeline_definition_id}", api_token)
+        
+        # Store values in lane context
+        Actions.lane_context[SharedValues::CIRCLECI_PIPELINE_DEFINITION] = result
+        
+        UI.success("Successfully retrieved pipeline definition with ID #{pipeline_definition_id}")
+        
+        return result
+      end
+
+      def self.description
+        "Gets a specific pipeline definition using CircleCI API v2"
+      end
+
+      def self.details
+        "This action retrieves details for a specific pipeline definition using the CircleCI API v2. Pipeline definitions describe how pipelines are configured for a project."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :api_token,
+                                       env_name: "CIRCLE_CI_API_TOKEN",
+                                       description: "API Token for CircleCI API",
+                                       sensitive: true,
+                                       code_gen_sensitive: true,
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_API_TOKEN"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :project_id,
+                                       env_name: "CIRCLE_CI_PROJECT_ID",
+                                       description: "The ID of the CircleCI project",
+                                       is_string: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :pipeline_definition_id,
+                                       description: "The ID of the pipeline definition to retrieve",
+                                       is_string: true,
+                                       optional: false)
+        ]
+      end
+
+      def self.output
+        [
+          ['CIRCLECI_PIPELINE_DEFINITION', 'A hash containing pipeline definition information']
+        ]
+      end
+
+      def self.return_value
+        "Returns a hash containing pipeline definition information."
+      end
+
+      def self.authors
+        ["crazymanish", "copilot"]
+      end
+
+      def self.example_code
+        [
+          'circleci_get_pipeline_definition(
+            project_id: "01234567-89ab-cdef-0123-456789abcdef",
+            pipeline_definition_id: "fedcba98-7654-3210-fedc-ba9876543210"
+          )',
+          'definition = circleci_get_pipeline_definition(
+            project_id: "01234567-89ab-cdef-0123-456789abcdef",
+            pipeline_definition_id: "fedcba98-7654-3210-fedc-ba9876543210"
+          )
+          
+          # Use the pipeline definition information
+          UI.message("Definition Name: #{definition["name"]}, Created At: #{definition["created_at"]}")'
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :ci
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/circle_ci/actions/circleci_get_pipeline_definitions.rb

@@ -0,0 +1,94 @@
+require 'fastlane/action'
+require_relative '../helper/circle_ci_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      CIRCLECI_PIPELINE_DEFINITIONS = :CIRCLECI_PIPELINE_DEFINITIONS
+    end
+
+    class CircleciGetPipelineDefinitionsAction < Action
+      def self.run(params)
+        UI.message("Getting CircleCI pipeline definitions via API v2...")
+        
+        api_token = params[:api_token]
+        project_id = params[:project_id]
+        
+        # Make API request
+        result = Helper::CircleCiHelper.get_v2("projects/#{project_id}/pipeline-definitions", api_token)
+        
+        # Store values in lane context
+        Actions.lane_context[SharedValues::CIRCLECI_PIPELINE_DEFINITIONS] = result
+        
+        UI.success("Successfully retrieved pipeline definitions for project #{project_id}")
+        
+        return result
+      end
+
+      def self.description
+        "Gets pipeline definitions for a CircleCI project using API v2"
+      end
+
+      def self.details
+        "This action retrieves all pipeline definitions for a specific CircleCI project using the CircleCI API v2. Pipeline definitions describe how pipelines are configured for a project."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :api_token,
+                                       env_name: "CIRCLE_CI_API_TOKEN",
+                                       description: "API Token for CircleCI API",
+                                       sensitive: true,
+                                       code_gen_sensitive: true,
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_API_TOKEN"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :project_id,
+                                       env_name: "CIRCLE_CI_PROJECT_ID",
+                                       description: "The ID of the CircleCI project",
+                                       is_string: true,
+                                       optional: false)
+        ]
+      end
+
+      def self.output
+        [
+          ['CIRCLECI_PIPELINE_DEFINITIONS', 'A hash containing pipeline definitions information']
+        ]
+      end
+
+      def self.return_value
+        "Returns a hash containing pipeline definitions information."
+      end
+
+      def self.authors
+        ["crazymanish", "copilot"]
+      end
+
+      def self.example_code
+        [
+          'circleci_get_pipeline_definitions(
+            project_id: "01234567-89ab-cdef-0123-456789abcdef"
+          )',
+          'definitions = circleci_get_pipeline_definitions(
+            project_id: "01234567-89ab-cdef-0123-456789abcdef"
+          )
+          
+          # Use the pipeline definitions information
+          definitions["items"].each do |definition|
+            UI.message("Definition ID: #{definition["id"]}, Name: #{definition["name"]}")
+          end'
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :ci
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/circle_ci/actions/circleci_get_pipeline_values.rb

@@ -0,0 +1,91 @@
+require 'fastlane/action'
+require_relative '../helper/circle_ci_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      CIRCLECI_PIPELINE_VALUES = :CIRCLECI_PIPELINE_VALUES
+    end
+
+    class CircleciGetPipelineValuesAction < Action
+      def self.run(params)
+        UI.message("Getting CircleCI pipeline values via API v2...")
+        
+        api_token = params[:api_token]
+        pipeline_id = params[:pipeline_id]
+        
+        # Make API request
+        result = Helper::CircleCiHelper.get_v2("pipeline/#{pipeline_id}/values", api_token)
+        
+        # Store values in lane context
+        Actions.lane_context[SharedValues::CIRCLECI_PIPELINE_VALUES] = result
+        
+        UI.success("Successfully retrieved values for pipeline #{pipeline_id}")
+        
+        return result
+      end
+
+      def self.description
+        "Gets values (parameters, configurations) for a CircleCI pipeline using API v2"
+      end
+
+      def self.details
+        "This action retrieves all values for a specific CircleCI pipeline using the CircleCI API v2. Values include parameters, configurations, and other metadata about the pipeline."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :api_token,
+                                       env_name: "CIRCLE_CI_API_TOKEN",
+                                       description: "API Token for CircleCI API",
+                                       sensitive: true,
+                                       code_gen_sensitive: true,
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_API_TOKEN"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :pipeline_id,
+                                       description: "The ID of the pipeline to retrieve values for",
+                                       is_string: true,
+                                       optional: false)
+        ]
+      end
+
+      def self.output
+        [
+          ['CIRCLECI_PIPELINE_VALUES', 'A hash containing the pipeline values information']
+        ]
+      end
+
+      def self.return_value
+        "Returns a hash containing pipeline values information."
+      end
+
+      def self.authors
+        ["crazymanish", "copilot"]
+      end
+
+      def self.example_code
+        [
+          'circleci_get_pipeline_values(
+            pipeline_id: "01234567-89ab-cdef-0123-456789abcdef"
+          )',
+          'values = circleci_get_pipeline_values(
+            pipeline_id: "01234567-89ab-cdef-0123-456789abcdef"
+          )
+          
+          # Use the pipeline values information
+          UI.message("Pipeline parameters: #{values["parameters"]}")'
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :ci
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/circle_ci/actions/circleci_get_pipeline_workflows.rb

@@ -0,0 +1,108 @@
+require 'fastlane/action'
+require_relative '../helper/circle_ci_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      CIRCLECI_PIPELINE_WORKFLOWS = :CIRCLECI_PIPELINE_WORKFLOWS
+    end
+
+    class CircleciGetPipelineWorkflowsAction < Action
+      def self.run(params)
+        UI.message("Getting workflows for CircleCI pipeline via API v2...")
+        
+        api_token = params[:api_token]
+        pipeline_id = params[:pipeline_id]
+        
+        # Make API request
+        result = Helper::CircleCiHelper.get_v2("pipeline/#{pipeline_id}/workflow", api_token)
+        
+        # Store values in lane context
+        Actions.lane_context[SharedValues::CIRCLECI_PIPELINE_WORKFLOWS] = result["items"]
+        
+        UI.success("Successfully retrieved #{result["items"].count} workflows for pipeline #{pipeline_id}")
+        
+        return result["items"]
+      end
+
+      def self.description
+        "Gets workflows for a CircleCI pipeline using API v2"
+      end
+
+      def self.details
+        "This action retrieves all workflows for a specific CircleCI pipeline using the CircleCI API v2, including status, IDs, and names."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :api_token,
+                                       env_name: "CIRCLE_CI_API_TOKEN",
+                                       description: "API Token for CircleCI API",
+                                       sensitive: true,
+                                       code_gen_sensitive: true,
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_API_TOKEN"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :pipeline_id,
+                                       env_name: "CIRCLE_CI_PIPELINE_ID",
+                                       description: "The ID of the pipeline to get workflows for",
+                                       is_string: true,
+                                       optional: false)
+        ]
+      end
+
+      def self.output
+        [
+          ['CIRCLECI_PIPELINE_WORKFLOWS', 'An array of workflow data for the pipeline']
+        ]
+      end
+
+      def self.return_value
+        "Returns an array of workflow data including IDs, names, and status information."
+      end
+
+      def self.authors
+        ["crazymanish", "copilot"]
+      end
+
+      def self.example_code
+        [
+          'circleci_get_pipeline_workflows(
+            pipeline_id: "pipeline-uuid"
+          )',
+          'workflows = circleci_get_pipeline_workflows(
+            pipeline_id: "pipeline-uuid"
+          )
+          
+          # Find workflows by status
+          running_workflows = workflows.select { |w| w["status"] == "running" }
+          
+          if running_workflows.any?
+            UI.message("There are #{running_workflows.count} workflows still running in this pipeline")
+            running_workflows.each do |workflow|
+              puts "  - #{workflow["name"]}: #{workflow["status"]}"
+            end
+          end
+          
+          # Find a specific workflow
+          deploy_workflow = workflows.find { |w| w["name"] == "deploy" }
+          if deploy_workflow
+            # Get jobs for the deploy workflow
+            jobs = circleci_get_workflow_jobs(
+              workflow_id: deploy_workflow["id"]
+            )
+          end'
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :ci
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/circle_ci/actions/circleci_get_project_branches.rb

@@ -0,0 +1,105 @@
+require 'fastlane/action'
+require_relative '../helper/circle_ci_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      CIRCLECI_PROJECT_BRANCHES = :CIRCLECI_PROJECT_BRANCHES
+    end
+
+    class CircleciGetProjectBranchesAction < Action
+      def self.run(params)
+        UI.message("Getting all branches for CircleCI project via Insights API v2...")
+        
+        api_token = params[:api_token]
+        project_slug = params[:project_slug]
+        
+        # Build query parameters
+        query_params = {}
+        query_params["reporting-window"] = params[:reporting_window] if params[:reporting_window]
+        
+        # Make API request
+        result = Helper::CircleCiHelper.get_v2("insights/#{project_slug}/branches", api_token, query_params)
+        
+        # Store values in lane context
+        Actions.lane_context[SharedValues::CIRCLECI_PROJECT_BRANCHES] = result
+        
+        UI.success("Successfully retrieved all branches for project #{project_slug}")
+        
+        return result
+      end
+
+      def self.description
+        "Gets all branches for a CircleCI project using Insights API v2"
+      end
+
+      def self.details
+        "This action retrieves a list of all branches for a specified CircleCI project using the Insights API v2. The list will only contain branches currently available within Insights. The maximum number of branches returned is 5,000."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :api_token,
+                                       env_name: "CIRCLE_CI_API_TOKEN",
+                                       description: "API Token for CircleCI API",
+                                       sensitive: true,
+                                       code_gen_sensitive: true,
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_API_TOKEN"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :project_slug,
+                                       env_name: "CIRCLE_CI_PROJECT_SLUG",
+                                       description: "Project slug in the form of :vcs-type/:org-name/:project-name (e.g. github/myorg/myrepo)",
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_PROJECT_SLUG"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :reporting_window,
+                                       description: "The time window used to calculate summary metrics (last-24-hours, last-7-days, last-90-days, etc.)",
+                                       is_string: true,
+                                       optional: true)
+        ]
+      end
+
+      def self.output
+        [
+          ['CIRCLECI_PROJECT_BRANCHES', 'A hash containing all branches information for the project']
+        ]
+      end
+
+      def self.return_value
+        "Returns a hash containing all branches information for the project."
+      end
+
+      def self.authors
+        ["crazymanish", "copilot"]
+      end
+
+      def self.example_code
+        [
+          'circleci_get_project_branches(
+            project_slug: "gh/MyOrg/my-project"
+          )',
+          'branches = circleci_get_project_branches(
+            project_slug: "gh/MyOrg/my-project",
+            reporting_window: "last-90-days"
+          )
+          
+          # Access the branch information
+          branches["items"].each do |branch|
+            UI.message("Branch: #{branch["name"]}")
+          end'
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :ci
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/circle_ci/actions/circleci_get_project_config.rb

@@ -0,0 +1,104 @@
+require 'fastlane/action'
+require_relative '../helper/circle_ci_helper'
+
+module Fastlane
+  module Actions
+    module SharedValues
+      CIRCLECI_PROJECT_CONFIG = :CIRCLECI_PROJECT_CONFIG
+    end
+
+    class CircleciGetProjectConfigAction < Action
+      def self.run(params)
+        UI.message("Getting CircleCI project configuration via API v2...")
+        
+        api_token = params[:api_token]
+        project_slug = params[:project_slug]
+        
+        # Make API request
+        result = Helper::CircleCiHelper.get_v2("project/#{project_slug}/config", api_token)
+        
+        # Store values in lane context
+        Actions.lane_context[SharedValues::CIRCLECI_PROJECT_CONFIG] = result
+        
+        UI.success("Successfully retrieved configuration for project #{project_slug}")
+        
+        return result
+      end
+
+      def self.description
+        "Gets the configuration for a CircleCI project using API v2"
+      end
+
+      def self.details
+        "This action retrieves configuration information for a specific CircleCI project using the CircleCI API v2, including compiled YAML configuration."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :api_token,
+                                       env_name: "CIRCLE_CI_API_TOKEN",
+                                       description: "API Token for CircleCI API",
+                                       sensitive: true,
+                                       code_gen_sensitive: true,
+                                       is_string: true,
+                                       default_value: ENV["CIRCLE_CI_API_TOKEN"],
+                                       default_value_dynamic: true,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :project_slug,
+                                       env_name: "CIRCLE_CI_PROJECT_SLUG",
+                                       description: "Project slug in the form of :vcs-type/:org-name/:project-name (e.g. github/myorg/myrepo)",
+                                       is_string: true,
+                                       optional: false)
+        ]
+      end
+
+      def self.output
+        [
+          ['CIRCLECI_PROJECT_CONFIG', 'A hash containing the project configuration details']
+        ]
+      end
+
+      def self.return_value
+        "Returns a hash containing project configuration information including compiled YAML configuration."
+      end
+
+      def self.authors
+        ["crazymanish", "copilot"]
+      end
+
+      def self.example_code
+        [
+          'circleci_get_project_config(
+            project_slug: "github/myorg/myrepo"
+          )',
+          'config = circleci_get_project_config(
+            project_slug: "github/myorg/myrepo"
+          )
+          
+          # Check the configuration source type
+          if config["source"] == "local"
+            UI.message("Project uses a local config file")
+          else
+            UI.message("Project uses a #{config["source"]} config")
+          end
+          
+          # Get compiled configuration
+          compiled_config = config["compiled"]
+          
+          # Look for specific workflows or jobs
+          if compiled_config && compiled_config.include?("publish-workflow")
+            UI.message("Found publish workflow in the configuration")
+          end'
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :ci
+      end
+    end
+  end
+end