fastlane-plugin-xcresulttool 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ee69d18cababb1b2c84287da4398ede97454e53dcd475ca3a6881baae3acaf67
+  data.tar.gz: fa1eb81b29668ee7e021c3c03f296f0d6a8450b0532d4fddbe07b282b72d50b3
+SHA512:
+  metadata.gz: '07249854ad5aafc583a198fdf4507da6716c0540f33d956f973bdb94a1e5daa26fd0164f84f56aa05788a49dfb9fdc60fa93709f7dde55aed0913b144c31e532'
+  data.tar.gz: f8bbc21fe1090db04fcda35e3e53ca9d7bf98ea7574fc7f06c4312fd43a2f03009abf18d4073bb03c5f79c9c29a1630bae8f6573537c43382b3951e54cff33f0

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Manish Rathi <i.am.manish.rathi@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,135 @@
+# xcresulttool plugin
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-xcresulttool)
+
+## Getting Started
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-xcresulttool`, add it to your project by running:
+
+```bash
+fastlane add_plugin xcresulttool
+```
+
+## About xcresulttool
+
+A fastlane plugin that provides an interface to Apple's `xcrun xcresulttool` command line utility. This plugin allows you to extract, export, merge, compare, and analyze data from Xcode test result bundles (.xcresult) files.
+
+The plugin includes dedicated actions for each `xcresulttool` subcommand, making it easy to integrate with your fastlane workflows.
+
+## Actions
+
+### xcresulttool
+
+The main action that supports all subcommands. You can use this action with a `subcommand` parameter to access all functionalities.
+
+```ruby
+xcresulttool(
+  subcommand: "get",
+  result_bundle_path: "path/to/Test.xcresult",
+  format: "json",
+  type: "action-testSummary"
+)
+```
+
+### xcresulttool_get
+
+Extract content from an .xcresult bundle:
+
+```ruby
+xcresulttool_get(
+  result_bundle_path: "path/to/Test.xcresult",
+  type: "action-testSummary",
+  format: "json",
+  output_path: "test_summary.json" # optional
+)
+```
+
+### xcresulttool_export
+
+Export content from an .xcresult bundle:
+
+```ruby
+xcresulttool_export(
+  result_bundle_path: "path/to/Test.xcresult",
+  output_path: "output.json",
+  format: "json"
+)
+```
+
+### xcresulttool_metadata
+
+Get metadata from an .xcresult bundle:
+
+```ruby
+xcresulttool_metadata(
+  result_bundle_path: "path/to/Test.xcresult",
+  format: "human-readable",
+  output_path: "metadata.txt" # optional
+)
+```
+
+### xcresulttool_merge
+
+Merge multiple .xcresult bundles into a single bundle:
+
+```ruby
+xcresulttool_merge(
+  source_results: ["path/to/Test1.xcresult", "path/to/Test2.xcresult"],
+  output_path: "path/to/MergedResults.xcresult"
+)
+```
+
+### xcresulttool_compare
+
+Compare two .xcresult bundles and report differences:
+
+```ruby
+xcresulttool_compare(
+  result_bundle_path: "path/to/Test.xcresult",
+  baseline_path: "path/to/Baseline.xcresult",
+  format: "human-readable",
+  only_changes: true,
+  output_path: "comparison_results.txt" # optional
+)
+```
+
+## Example
+
+Check out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plugin. Try it by cloning the repo, running `fastlane install_plugins` and `bundle exec fastlane test`.
+
+## Common Use Cases
+
+- Extract test summaries to track pass/fail rates over time
+- Export test attachments (screenshots, logs) for debugging
+- Merge test results from parallel test runs
+- Compare test results between different runs or branches
+- Access test metadata for reporting
+
+## Run tests for this plugin
+
+To run both the tests, and code style validation, run
+
+```
+rake
+```
+
+To automatically fix many of the styling issues, use
+```
+rubocop -a
+```
+
+## Issues and Feedback
+
+For any other issues and feedback about this plugin, please submit it to this repository.
+
+## Troubleshooting
+
+If you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.
+
+## Using _fastlane_ Plugins
+
+For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).
+
+## About _fastlane_
+
+_fastlane_ is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out [fastlane.tools](https://fastlane.tools).

data/lib/fastlane/plugin/xcresulttool/actions/xcresulttool_action.rb

@@ -0,0 +1,239 @@
+require 'fastlane/action'
+require_relative '../helper/xcresulttool_helper'
+
+module Fastlane
+  module Actions
+    class XcresulttoolAction < Action
+      def self.run(params)
+        subcommand = params[:subcommand]
+        args = [subcommand]
+
+        # Common parameters
+        result_bundle_path = params[:result_bundle_path]
+        Helper::XcresulttoolHelper.validate_result_bundle_path(result_bundle_path) if result_bundle_path
+        
+        case subcommand
+        when "get"
+          args << "--path" << params[:result_bundle_path]
+          args << "--format" << params[:format] if params[:format]
+          args << "--id" << params[:id] if params[:id]
+          args << "--output-path" << params[:output_path] if params[:output_path]
+          args << "--type" << params[:type] if params[:type]
+        
+        when "export"
+          args << "--path" << params[:result_bundle_path]
+          args << "--format" << params[:format] if params[:format]
+          args << "--output-path" << params[:output_path] if params[:output_path]
+          args << "--output-dir" << params[:output_dir] if params[:output_dir]
+          args << "--export-items" << params[:export_items].join(" ") if params[:export_items]
+          
+        when "graph"
+          UI.important("Warning: 'graph' subcommand is deprecated and will be removed in a future release.")
+          UI.important("Consider using 'xcresulttool get test-report' instead.")
+          args << "--path" << params[:result_bundle_path]
+          args << "--format" << params[:format] if params[:format]
+          
+        when "metadata"
+          args << "--path" << params[:result_bundle_path]
+          args << "--format" << params[:format] if params[:format]
+          
+        when "formatDescription"
+          UI.important("Warning: 'formatDescription' subcommand is deprecated and will be removed in a future release.")
+          
+        when "merge"
+          args << "--output-path" << params[:output_path] if params[:output_path]
+          args += params[:source_results].map { |path| ["--input-path", path] }.flatten if params[:source_results]
+          
+        when "compare"
+          args << "--path" << params[:result_bundle_path]
+          args << "--baseline-path" << params[:baseline_path] if params[:baseline_path]
+          args << "--format" << params[:format] if params[:format]
+          args << "--only-changes" if params[:only_changes]
+          args << "--only-new-tests" if params[:only_new_tests]
+          args << "--only-deleted-tests" if params[:only_deleted_tests]
+          args << "--only-test-status-changes" if params[:only_test_status_changes]
+          args << "--only-performance-changes" if params[:only_performance_changes]
+          
+        else
+          UI.user_error!("Unsupported subcommand: #{subcommand}. Available subcommands: get, export, graph, metadata, formatDescription, merge, compare")
+        end
+        
+        # Additional parameters that could be passed to any subcommand
+        args << "--verbose" if params[:verbose]
+        
+        # Execute the command
+        result = Helper::XcresulttoolHelper.execute_command(args)
+        
+        if params[:output_path]
+          UI.success("Results saved to #{params[:output_path]}")
+        else
+          return result
+        end
+      end
+
+      def self.description
+        "A fastlane plugin for xcresulttool"
+      end
+
+      def self.authors
+        ["crazymanish"]
+      end
+
+      def self.return_value
+        "For most subcommands, returns the output of the xcresulttool command as a string. When an output path is specified, returns nil but saves the output to the specified path."
+      end
+
+      def self.details
+        "This plugin provides a fastlane interface to Apple's xcresulttool command line utility, which is used to extract and process data from Xcode's .xcresult bundles. It supports all xcresulttool subcommands: get, export, graph, metadata, formatDescription, merge, and compare."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :subcommand,
+            description: "The xcresulttool subcommand to run (get, export, graph, metadata, formatDescription, merge, compare)",
+            verify_block: proc do |value|
+              valid_subcommands = ["get", "export", "graph", "metadata", "formatDescription", "merge", "compare"]
+              UI.user_error!("Unsupported subcommand: '#{value}'. Available subcommands: #{valid_subcommands.join(", ")}") unless valid_subcommands.include?(value)
+            end,
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :result_bundle_path,
+            description: "Path to the .xcresult bundle",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :format,
+            description: "Output format (json, flat, human-readable)",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :id,
+            description: "ID for the get subcommand",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :type,
+            description: "Content type for the get subcommand (e.g., 'action-testSummary', 'test-report')",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            description: "Path to save output",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_dir,
+            description: "Directory to save output files",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :export_items,
+            description: "Items to export (array of strings)",
+            optional: true,
+            type: Array
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :source_results,
+            description: "Array of xcresult bundle paths to merge",
+            optional: true,
+            type: Array
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :baseline_path,
+            description: "Path to baseline .xcresult bundle for comparison",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :only_changes,
+            description: "Show only changes in comparison",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :only_new_tests,
+            description: "Show only new tests in comparison",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :only_deleted_tests,
+            description: "Show only deleted tests in comparison",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :only_test_status_changes,
+            description: "Show only test status changes in comparison",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :only_performance_changes,
+            description: "Show only performance changes in comparison",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            description: "Enable verbose output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcresulttool(
+            subcommand: "get",
+            result_bundle_path: "path/to/Test.xcresult",
+            format: "json",
+            type: "action-testSummary"
+          )',
+          'xcresulttool(
+            subcommand: "export",
+            result_bundle_path: "path/to/Test.xcresult",
+            output_path: "output.json",
+            format: "json"
+          )',
+          'xcresulttool(
+            subcommand: "compare",
+            result_bundle_path: "path/to/Test.xcresult",
+            baseline_path: "path/to/Baseline.xcresult",
+            format: "json",
+            only_changes: true
+          )',
+          'xcresulttool(
+            subcommand: "merge",
+            output_path: "merged.xcresult",
+            source_results: ["result1.xcresult", "result2.xcresult"]
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/actions/xcresulttool_compare_action.rb

@@ -0,0 +1,165 @@
+require 'fastlane/action'
+require_relative '../helper/xcresulttool_helper'
+
+module Fastlane
+  module Actions
+    class XcresulttoolCompareAction < Action
+      def self.run(params)
+        args = ["compare"]
+        
+        # Validate result bundle paths
+        Helper::XcresulttoolHelper.validate_result_bundle_path(params[:result_bundle_path])
+        Helper::XcresulttoolHelper.validate_result_bundle_path(params[:baseline_path])
+        
+        # Add required arguments
+        args << params[:result_bundle_path] # Use positional argument for comparison path
+        args << "--baseline-path" << params[:baseline_path]
+        
+        # Add comparison output options
+        args << "--summary" if params[:summary]
+        args << "--test-failures" if params[:test_failures]
+        args << "--tests" if params[:tests]
+        args << "--build-warnings" if params[:build_warnings]
+        args << "--analyzer-issues" if params[:analyzer_issues]
+        
+        # Add optional output format and path if supported
+        args << "--format" << params[:format] if params[:format] && params[:format_supported]
+        args << "--output-path" << params[:output_path] if params[:output_path]
+        
+        args << "--verbose" if params[:verbose]
+        
+        # Execute the command
+        result = Helper::XcresulttoolHelper.execute_command(args)
+        
+        if params[:output_path]
+          UI.success("Comparison results saved to #{params[:output_path]}")
+        else
+          return result
+        end
+      end
+
+      def self.description
+        "Compare two Result Bundles using xcresulttool"
+      end
+
+      def self.authors
+        ["crazymanish"]
+      end
+
+      def self.return_value
+        "The output of the xcresulttool compare command as a string, or nil if output_path is specified"
+      end
+
+      def self.details
+        "This action compares two Xcode result bundles (.xcresult) and reports differences using Apple's xcresulttool compare subcommand"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :result_bundle_path,
+            description: "Path to the .xcresult bundle to be compared",
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :baseline_path,
+            description: "Path to the baseline .xcresult bundle for comparison",
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :summary,
+            description: "Include the differential summary info in the output",
+            optional: true,
+            default_value: true,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :test_failures,
+            description: "Include the differential test failures info in the output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :tests,
+            description: "Include the differential tests info in the output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :build_warnings,
+            description: "Include the differential build warnings info in the output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :analyzer_issues,
+            description: "Include the differential analyzer issues info in the output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :format,
+            description: "Output format (json, flat, human-readable)",
+            optional: true,
+            default_value: "json",
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :format_supported,
+            description: "Whether the format option is supported by your version of xcresulttool (newer versions only)",
+            optional: true,
+            default_value: false,
+            is_string: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            description: "Path to save comparison results",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            description: "Enable verbose output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcresulttool_compare(
+            result_bundle_path: "path/to/Test.xcresult",
+            baseline_path: "path/to/Baseline.xcresult",
+            summary: true,
+            test_failures: true
+          )',
+          'xcresulttool_compare(
+            result_bundle_path: "path/to/Test.xcresult",
+            baseline_path: "path/to/Baseline.xcresult",
+            summary: true,
+            tests: true,
+            build_warnings: true,
+            analyzer_issues: true,
+            output_path: "comparison_results.txt"
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/actions/xcresulttool_export_action.rb

@@ -0,0 +1,123 @@
+require 'fastlane/action'
+require_relative '../helper/xcresulttool_helper'
+
+module Fastlane
+  module Actions
+    class XcresulttoolExportAction < Action
+      def self.run(params)
+        args = ["export"]
+        
+        # Validate result bundle path
+        Helper::XcresulttoolHelper.validate_result_bundle_path(params[:result_bundle_path])
+        
+        # Add required arguments
+        args << "--path" << params[:result_bundle_path]
+        
+        # Add optional arguments
+        args << "--format" << params[:format] if params[:format]
+        args << "--output-path" << params[:output_path] if params[:output_path]
+        args << "--output-dir" << params[:output_dir] if params[:output_dir]
+        
+        # Handle export items
+        if params[:export_items]
+          params[:export_items].each do |item|
+            args << "--export-item" << item
+          end
+        end
+        
+        args << "--verbose" if params[:verbose]
+        
+        # Execute the command
+        result = Helper::XcresulttoolHelper.execute_command(args)
+        
+        output_location = params[:output_path] || params[:output_dir]
+        if output_location
+          UI.success("Results exported to #{output_location}")
+        else
+          return result
+        end
+      end
+
+      def self.description
+        "Export Result Bundle contents using xcresulttool"
+      end
+
+      def self.authors
+        ["crazymanish"]
+      end
+
+      def self.return_value
+        "The output of the xcresulttool export command as a string, or nil if output_path or output_dir is specified"
+      end
+
+      def self.details
+        "This action exports content from an Xcode result bundle (.xcresult) using Apple's xcresulttool export subcommand"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :result_bundle_path,
+            description: "Path to the .xcresult bundle",
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :format,
+            description: "Output format (json, flat, human-readable)",
+            optional: true,
+            default_value: "json",
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            description: "Path to save output file",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_dir,
+            description: "Directory to save output files",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :export_items,
+            description: "Array of items to export",
+            optional: true,
+            type: Array
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            description: "Enable verbose output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcresulttool_export(
+            result_bundle_path: "path/to/Test.xcresult",
+            output_path: "output.json"
+          )',
+          'xcresulttool_export(
+            result_bundle_path: "path/to/Test.xcresult",
+            output_dir: "export_directory",
+            export_items: ["logs", "diagnostics"]
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/actions/xcresulttool_get_action.rb

@@ -0,0 +1,119 @@
+require 'fastlane/action'
+require_relative '../helper/xcresulttool_helper'
+
+module Fastlane
+  module Actions
+    class XcresulttoolGetAction < Action
+      def self.run(params)
+        args = ["get"]
+        
+        # Validate result bundle path
+        Helper::XcresulttoolHelper.validate_result_bundle_path(params[:result_bundle_path])
+        
+        # Add required arguments
+        args << "--path" << params[:result_bundle_path]
+        
+        # Add optional arguments
+        args << "--format" << params[:format] if params[:format]
+        args << "--id" << params[:id] if params[:id]
+        args << "--output-path" << params[:output_path] if params[:output_path]
+        args << "--type" << params[:type] if params[:type]
+        args << "--verbose" if params[:verbose]
+        
+        # Execute the command
+        result = Helper::XcresulttoolHelper.execute_command(args)
+        
+        if params[:output_path]
+          UI.success("Results saved to #{params[:output_path]}")
+        else
+          return result
+        end
+      end
+
+      def self.description
+        "Get Result Bundle contents using xcresulttool"
+      end
+
+      def self.authors
+        ["crazymanish"]
+      end
+
+      def self.return_value
+        "The output of the xcresulttool get command as a string, or nil if output_path is specified"
+      end
+
+      def self.details
+        "This action extracts content from an Xcode result bundle (.xcresult) using Apple's xcresulttool get subcommand"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :result_bundle_path,
+            description: "Path to the .xcresult bundle",
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :format,
+            description: "Output format (json, flat, human-readable)",
+            optional: true,
+            default_value: "json",
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :id,
+            description: "ID for the get subcommand",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :type,
+            description: "Content type for the get subcommand (e.g., 'action-testSummary', 'test-report')",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            description: "Path to save output",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            description: "Enable verbose output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcresulttool_get(
+            result_bundle_path: "path/to/Test.xcresult",
+            format: "json"
+          )',
+          'xcresulttool_get(
+            result_bundle_path: "path/to/Test.xcresult",
+            type: "action-testSummary",
+            output_path: "test_summary.json"
+          )',
+          'xcresulttool_get(
+            result_bundle_path: "path/to/Test.xcresult",
+            type: "test-report"
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/actions/xcresulttool_merge_action.rb

@@ -0,0 +1,95 @@
+require 'fastlane/action'
+require_relative '../helper/xcresulttool_helper'
+
+module Fastlane
+  module Actions
+    class XcresulttoolMergeAction < Action
+      def self.run(params)
+        args = ["merge"]
+        
+        # Validate source result bundles
+        source_results = params[:source_results]
+        UI.user_error!("At least one source result bundle path must be provided") if source_results.nil? || source_results.empty?
+        
+        source_results.each do |path|
+          Helper::XcresulttoolHelper.validate_result_bundle_path(path)
+        end
+        
+        # Add required output path
+        output_path = params[:output_path]
+        UI.user_error!("Output path must be provided") if output_path.nil? || output_path.empty?
+        args << "--output-path" << output_path
+        
+        # Add source result bundle paths directly as arguments
+        source_results.each do |path|
+          args << path
+        end
+        
+        # Add verbose option if needed
+        args << "--verbose" if params[:verbose]
+        
+        # Execute the command
+        Helper::XcresulttoolHelper.execute_command(args)
+        
+        UI.success("Result bundles merged to #{output_path}")
+      end
+
+      def self.description
+        "Merge multiple Result Bundles using xcresulttool"
+      end
+
+      def self.authors
+        ["crazymanish"]
+      end
+
+      def self.return_value
+        nil
+      end
+
+      def self.details
+        "This action merges multiple Xcode result bundles (.xcresult) into a single bundle using Apple's xcresulttool merge subcommand"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :source_results,
+            description: "Array of paths to .xcresult bundles to merge",
+            optional: false,
+            type: Array
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            description: "Path where to save the merged result bundle",
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            description: "Enable verbose output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcresulttool_merge(
+            source_results: ["path/to/Test1.xcresult", "path/to/Test2.xcresult"],
+            output_path: "path/to/MergedResults.xcresult"
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/actions/xcresulttool_metadata_action.rb

@@ -0,0 +1,100 @@
+require 'fastlane/action'
+require_relative '../helper/xcresulttool_helper'
+
+module Fastlane
+  module Actions
+    class XcresulttoolMetadataAction < Action
+      def self.run(params)
+        args = ["metadata"]
+        
+        # Validate result bundle path
+        Helper::XcresulttoolHelper.validate_result_bundle_path(params[:result_bundle_path])
+        
+        # Add required arguments
+        args << "--path" << params[:result_bundle_path]
+        
+        # Add optional arguments
+        args << "--format" << params[:format] if params[:format]
+        args << "--output-path" << params[:output_path] if params[:output_path]
+        args << "--verbose" if params[:verbose]
+        
+        # Execute the command
+        result = Helper::XcresulttoolHelper.execute_command(args)
+        
+        if params[:output_path]
+          UI.success("Metadata saved to #{params[:output_path]}")
+        else
+          return result
+        end
+      end
+
+      def self.description
+        "Get Result Bundle metadata using xcresulttool"
+      end
+
+      def self.authors
+        ["crazymanish"]
+      end
+
+      def self.return_value
+        "The output of the xcresulttool metadata command as a string, or nil if output_path is specified"
+      end
+
+      def self.details
+        "This action extracts metadata from an Xcode result bundle (.xcresult) using Apple's xcresulttool metadata subcommand"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :result_bundle_path,
+            description: "Path to the .xcresult bundle",
+            optional: false,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :format,
+            description: "Output format (json, flat, human-readable)",
+            optional: true,
+            default_value: "json",
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :output_path,
+            description: "Path to save output",
+            optional: true,
+            type: String
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :verbose,
+            description: "Enable verbose output",
+            optional: true,
+            default_value: false,
+            is_string: false
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcresulttool_metadata(
+            result_bundle_path: "path/to/Test.xcresult"
+          )',
+          'xcresulttool_metadata(
+            result_bundle_path: "path/to/Test.xcresult",
+            format: "human-readable",
+            output_path: "metadata.txt"
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/helper/xcresulttool_helper.rb

@@ -0,0 +1,42 @@
+require 'fastlane_core/ui/ui'
+
+module Fastlane
+  UI = FastlaneCore::UI unless Fastlane.const_defined?(:UI)
+
+  module Helper
+    class XcresulttoolHelper
+      # class methods that you define here become available in your action
+      # as `Helper::XcresulttoolHelper.your_method`
+      #
+      def self.show_message
+        UI.message("Hello from the xcresulttool plugin helper!")
+      end
+
+      # Execute xcresulttool command with given arguments
+      def self.execute_command(command_args)
+        cmd = ['xcrun', 'xcresulttool'] + command_args
+        UI.verbose("Executing command: #{cmd.join(' ')}")
+        
+        result = ''
+        status = FastlaneCore::CommandExecutor.execute(
+          command: cmd,
+          print_all: false,
+          print_command: true
+        ) do |output|
+          result << output
+        end
+        
+        if status != 0
+          UI.user_error!("Command failed with status #{status}")
+        end
+        
+        return result
+      end
+
+      # Validate that a result bundle path exists
+      def self.validate_result_bundle_path(result_bundle_path)
+        UI.user_error!("Result bundle not found at path: #{result_bundle_path}") unless File.exist?(result_bundle_path)
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/xcresulttool/version.rb

@@ -0,0 +1,5 @@
+module Fastlane
+  module Xcresulttool
+    VERSION = "0.1.0"
+  end
+end

data/lib/fastlane/plugin/xcresulttool.rb

@@ -0,0 +1,16 @@
+require 'fastlane/plugin/xcresulttool/version'
+
+module Fastlane
+  module Xcresulttool
+    # Return all .rb files inside the "actions" and "helper" directory
+    def self.all_classes
+      Dir[File.expand_path('**/{actions,helper}/*.rb', File.dirname(__FILE__))]
+    end
+  end
+end
+
+# By default we want to import all available actions and helpers
+# A plugin can contain any number of actions and plugins
+Fastlane::Xcresulttool.all_classes.each do |current|
+  require current
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-xcresulttool
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Manish Rathi
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-05-09 00:00:00.000000000 Z
+dependencies: []
+description:
+email: i.am.manish.rathi@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/xcresulttool.rb
+- lib/fastlane/plugin/xcresulttool/actions/xcresulttool_action.rb
+- lib/fastlane/plugin/xcresulttool/actions/xcresulttool_compare_action.rb
+- lib/fastlane/plugin/xcresulttool/actions/xcresulttool_export_action.rb
+- lib/fastlane/plugin/xcresulttool/actions/xcresulttool_get_action.rb
+- lib/fastlane/plugin/xcresulttool/actions/xcresulttool_merge_action.rb
+- lib/fastlane/plugin/xcresulttool/actions/xcresulttool_metadata_action.rb
+- lib/fastlane/plugin/xcresulttool/helper/xcresulttool_helper.rb
+- lib/fastlane/plugin/xcresulttool/version.rb
+homepage:
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: A fastlane plugin for xcresulttoo
+test_files: []