fastlane-plugin-ovo_gptdriver 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3e2d0df06cedeecdc50c6eab7668ad7cc9f1a1e124643875d250fb20f348308d
+  data.tar.gz: a78f6186ff717242a9a290c95e57c48b734cf036cf16c3743908ff9d7aeb1c2f
+SHA512:
+  metadata.gz: d941e95a63290a582ce4772c8cfc542c854c6900a12dcdea30041007f3b98088a4ecaa474221d4caa295349b814ddbb50eb7cf5e17b8b9a782ebbeae9f3dc256
+  data.tar.gz: 266daeb91db6138679961a5fe12c382afbd7eac8a22b22e0673dcde2df3edaf4b01820448c4264ac9397336132840598439d34d346a85aa591f0b9c1d24123dd

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Christian Borsato <christian@ovolab.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,52 @@
+# Ovo GPT Driver plugin
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-ovo_gptdriver)
+
+## Getting Started
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-ovo_gptdriver`, add it to your project by running:
+
+```bash
+fastlane add_plugin ovo_gptdriver
+```
+
+## About ovo_gptdriver
+
+The GPT Driver Fastlane Plugin provides a streamlined way to upload build artifacts to the GPT Driver service as part of your CI/CD pipeline. It supports uploading platform-specific binaries (such as APK, AAB, or IPA files), attaching metadata, and associating each build with your organization via a secure key.
+
+This plugin is ideal for mobile teams that want to automate build delivery to GPT Driver with minimal configuration and full control over metadata like branch names or deployment context. Upon successful upload, the action returns the unique build ID generated by the GPT Driver service.
+
+## Available Actions
+
+### ovo_gptdriver_upload_build
+
+This action uploads a build artifact to the GPT Driver service, along with relevant metadata such as platform, organization key, and custom deployment information (e.g., branch name). It is intended for use in CI/CD environments and ensures that each build is properly registered with GPT Driver. If the upload fails, the action returns nil instead of raising an error, allowing for graceful handling.
+
+```ruby
+ovo_gptdriver_upload_build(
+  build_path: build_path,
+  organisation_key: organisation_key,
+  platform: platform,
+  metadata: metadata
+)
+```
+
+## 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`.
+
+## 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/ovo_gptdriver/actions/ovo_gptdriver_upload_build_action.rb

@@ -0,0 +1,73 @@
+require 'fastlane/action'
+
+module Fastlane
+  module Actions
+    class OvoGptdriverUploadBuildAction < Action
+      def self.run(params)
+        Helper::OvoGptdriverHelper.upload_build(
+          build_path: params[:build_path],
+          organisation_key: params[:organisation_key],
+          platform: params[:platform],
+          metadata: params[:metadata]
+        )
+      end
+
+      def self.description
+        "An action to upload build files to the GPT Driver service."
+      end
+
+      def self.authors
+        ["Christian Borsato"]
+      end
+
+      def self.return_value
+        "This action returns a string representing the ID of the uploaded build, as returned by the GPT Driver service. If the upload fails due to any error (e.g., network issues, invalid input, or authentication failure), it returns nil."
+      end
+
+      def self.details
+        "This action uploads a build artifact to the GPT Driver service, along with relevant metadata such as platform, organization key, and custom deployment information (e.g., branch name). It is intended for use in CI/CD environments and ensures that each build is properly registered with GPT Driver. If the upload fails, the action returns nil instead of raising an error, allowing for graceful handling."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :build_path,
+            env_name: "GPTDRIVER_BUILD_PATH",
+            description: "The build binary file path to upload to GPT Driver (e.g., /path/to/your/build_file.apk)",
+            optional: false,
+            is_string: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :organisation_key,
+            env_name: "GPTDRIVER_ORGANISATION_KEY",
+            description: "The unique organization key used to identify your GPT Driver account",
+            optional: false,
+            is_string: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :platform,
+            env_name: "GPTDRIVER_PLATFORM",
+            description: "The platform of the build being uploaded (e.g., android, ios)",
+            optional: false,
+            is_string: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :metadata,
+            env_name: "GPTDRIVER_METADATA",
+            description: "A JSON string containing additional metadata for the upload (e.g., branch name, build type)",
+            optional: true,
+            is_string: true
+          )
+        ]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.category
+        :misc
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/ovo_gptdriver/helper/ovo_gptdriver_helper.rb

@@ -0,0 +1,51 @@
+require 'fastlane_core/ui/ui'
+require 'json'
+require 'rest-client'
+
+module Fastlane
+  UI = FastlaneCore::UI unless Fastlane.const_defined?(:UI)
+
+  module Helper
+    class OvoGptdriverHelper
+      API_BASE_URL = "https://api.mobileboost.io"
+
+      # GPT Driver API Documentation: https://docs.mobileboost.io/gpt-driver-api/basics/images-and-media/api
+      def self.upload_build(build_path:, organisation_key:, platform:, metadata:)
+        UI.message("Starting upload of build '#{build_path}' to GTP Driver...")
+
+        begin
+          # Start request using RestClient
+          response = RestClient.post(
+            "#{API_BASE_URL}/uploadBuild/",
+            {
+              build: File.new(build_path, 'rb'),        # APK/ZIP/TAR.GZ file
+              organisation_key: organisation_key,       # Organization key
+              platform: platform,                       # Platform type
+              metadata: metadata                        # Metadata as JSON
+            },
+            { content_type: :multipart }                # Specify multipart/form-data
+          )
+
+          json_response = JSON.parse(response.body)
+          build_id = json_response["buildId"]
+
+          # If the request is successful (HTTP 2xx)
+          UI.success("Build '#{build_path}' uploaded successfully to GPT Driver.\nBuild ID assigned: #{build_id}")
+
+          # Return the build id
+          return build_id
+        rescue RestClient::ExceptionWithResponse => e
+          # Server returned an HTTP error (e.g. 400, 401, 500)
+          UI.error(
+            "An error occurred while uploading the build '#{build_path}' to GTPDriver.\nStatus Code: #{e.http_code}\nBody: #{e.response}"
+          )
+          return nil
+        rescue StandardError => e
+          # Catch any other unexpected error
+          UI.error("An unexpected error occurred: #{e.to_s}")
+          return nil
+        end
+      end
+    end
+  end
+end

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

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

data/lib/fastlane/plugin/ovo_gptdriver.rb

@@ -0,0 +1,16 @@
+require 'fastlane/plugin/ovo_gptdriver/version'
+
+module Fastlane
+  module OvoGptdriver
+    # 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::OvoGptdriver.all_classes.each do |current|
+  require current
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-ovo_gptdriver
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Christian Borsato
+bindir: bin
+cert_chain: []
+date: 2025-05-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email: christian@ovolab.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/ovo_gptdriver.rb
+- lib/fastlane/plugin/ovo_gptdriver/actions/ovo_gptdriver_upload_build_action.rb
+- lib/fastlane/plugin/ovo_gptdriver/helper/ovo_gptdriver_helper.rb
+- lib/fastlane/plugin/ovo_gptdriver/version.rb
+homepage: https://github.com/ovolab/fastlane-plugin-ovo_gptdriver
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+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.6.3
+specification_version: 4
+summary: This Fastlane plugin provides actions for interacting with GPT Driver.
+test_files: []