fastlane-plugin-wpmreleasetoolkit 14.3.1 → 14.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ab881ca2ace19096ebd20f3fd2360b3b1292193de386d1af5d911b2962f5f15
-  data.tar.gz: 53f1bdd9b33fd1e77c7f8024aa8c135cf4449d4ccf50ab4a09e4c47e11133d3b
+  metadata.gz: 53fda01b5c9773e9763663cbce794b14dfc05895fd4811832244b10419b57290
+  data.tar.gz: 39baf709e7720943a6e403859515bc0dcfd5d8538afe74ae258d24d5586c7c0b
 SHA512:
-  metadata.gz: 7582dc3820b054a40ffb705d8a47468384ce6cbb1bc1ef12b4b21c3989dd275b8ef70251dfbd1721650ea3839566fdc2858434c8b62f76b831ff49c332b76b57
-  data.tar.gz: d89204a2d5e4c52dae4ce2cb45e46464ae2cdd8d76b94987303366fffeb6db126301823a19c3128d9f16ccf9a72c24d6007757e84d1f112a88511490b3e168a4
+  metadata.gz: 5bc8522d6cb6cde402d7cf99b629cc12fc2a407f13bcc908833440175a7a22a7dbb8aac2ed860dad902d10ef880c0d97478f12ada9d0dfccaaf651442b4e2d3c
+  data.tar.gz: 0b7bc991e3742c49e8b2717a2dc8207c0272c01cdda7110e99852ea52ff4651053c8d2dcd9372cba615a52b816dc829dc11f72db7c3fc6afc48061802a6e6f3b

data/lib/fastlane/plugin/wpmreleasetoolkit/env_manager/env_manager.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+require 'dotenv'
+require 'shellwords'
+require 'fastlane'
+
+module Fastlane
+  module Wpmreleasetoolkit
+    # Manages loading of environment variables from a .env and accessing them in a user-friendly way.
+    class EnvManager
+      attr_reader :env_path, :env_example_path, :print_error_lambda
+
+      class << self
+        attr_writer :default_print_error_lambda
+      end
+
+      # Set up by loading the .env file with the given name.
+      def initialize(
+        env_file_name:,
+        env_file_folder: File.join(Dir.home, '.a8c-apps'),
+        example_env_file_path: 'fastlane/example.env',
+        print_error_lambda: ->(message) { FastlaneCore::UI.user_error!(message) },
+        print_warning_lambda: ->(message) { FastlaneCore::UI.important(message) }
+      )
+        @env_path = File.join(env_file_folder, env_file_name)
+        @env_example_path = example_env_file_path
+        @print_error_lambda = print_error_lambda
+        @print_warning_lambda = print_warning_lambda
+
+        unless File.exist?(@env_path) || running_on_ci?
+          @print_warning_lambda.call("Warning: env file not found at #{@env_path}. Environment variables may not be loaded.")
+        end
+
+        # Parse rather than load so we don't mutate the global ENV. Each instance
+        # gets its own view, and values from the process environment (e.g. set by
+        # CI) still take precedence — see `env_value`.
+        @loaded_env = File.exist?(@env_path) ? Dotenv.parse(@env_path) : {}
+      end
+
+      # Use this instead of getting values from `ENV` directly. It will throw an error if the requested value is missing or empty.
+      def get_required_env!(key)
+        unless env_var_set?(key)
+          message = "Environment variable '#{key}' is not set."
+
+          error_message =
+            if running_on_ci?
+              message
+            elsif File.exist?(@env_path)
+              "#{message} Consider adding it to #{@env_path}."
+            else
+              env_file_dir = File.dirname(@env_path)
+              env_file_name = File.basename(@env_path)
+
+              <<~MSG
+                #{env_file_name} not found in #{env_file_dir} while looking for env var #{key}.
+
+                Please copy #{@env_example_path} to #{@env_path} and fill in the value for #{key}.
+
+                mkdir -p #{Shellwords.shellescape(env_file_dir)} && cp #{Shellwords.shellescape(@env_example_path)} #{Shellwords.shellescape(@env_path)}
+              MSG
+            end
+
+          @print_error_lambda.call(error_message)
+          raise KeyError, error_message
+        end
+
+        value = env_value(key)
+
+        if value.to_s.empty?
+          empty_message = "Env var for key #{key} is set but empty. Please set a value for #{key}."
+          @print_error_lambda.call(empty_message)
+          raise ArgumentError, empty_message
+        end
+
+        value
+      end
+
+      # Use this to ensure all env vars a lane requires are set.
+      #
+      # The best place to call this is at the start of a lane, to fail early.
+      def require_env_vars!(*keys)
+        keys.flatten.each { |key| get_required_env!(key) }
+      end
+
+      # CI environment helpers — read common metadata from the CI provider.
+      #
+      # Notice that given Buildkite is the only CI provider we use, they are Buildkite-dependent.
+      #
+      # If this were to be adopted more broadly, we'd need a two-tier approach:
+      # 1. Detect which CI is in use
+      # 2. Use its specific env vars
+      # 3. Maybe fallback to best guess or outright error if no vendor detected
+
+      def build_number
+        ENV.fetch('BUILDKITE_BUILD_NUMBER', '0')
+      end
+
+      def branch_name
+        ENV.fetch('BUILDKITE_BRANCH', nil)
+      end
+
+      def commit_hash
+        ENV.fetch('BUILDKITE_COMMIT', nil)
+      end
+
+      # Returns the PR number as an Integer, or nil if not running on a PR build.
+      # Buildkite sets BUILDKITE_PULL_REQUEST to 'false' (not nil) when not on a PR.
+      def pull_request_number
+        pr_num = ENV.fetch('BUILDKITE_PULL_REQUEST', 'false')
+        pr_num == 'false' ? nil : Integer(pr_num)
+      end
+
+      # Returns a human-readable label: "PR #123" for PR builds, or the branch name otherwise.
+      def pr_number_or_branch_name
+        pull_request_number&.then { |num| "PR ##{num}" } || branch_name
+      end
+
+      # Class-level convenience methods that delegate to a default instance.
+      # This preserves the existing API: `EnvManager.set_up(...)` then `EnvManager.get_required_env!(...)`.
+
+      def self.set_up(**args)
+        if configured?
+          default_print_error_lambda.call('EnvManager is already configured. Call `EnvManager.reset!` before calling `EnvManager.set_up(...)` again.')
+          return @default
+        end
+
+        @default = new(**args)
+      end
+
+      def self.get_required_env!(key)
+        default!.get_required_env!(key)
+      end
+
+      def self.require_env_vars!(*keys)
+        default!.require_env_vars!(*keys)
+      end
+
+      # Clears the default instance, useful for test teardown.
+      def self.reset!
+        @default = nil
+      end
+
+      # Returns true if a default instance has been configured via `.set_up`.
+      def self.configured?
+        !@default.nil?
+      end
+
+      def self.default!
+        return @default if configured?
+
+        message = 'EnvManager is not configured. Call `EnvManager.set_up(...)` first.'
+        default_print_error_lambda.call(message)
+        raise message
+      end
+
+      def self.default_print_error_lambda
+        @default&.print_error_lambda || @default_print_error_lambda || ->(message) { FastlaneCore::UI.user_error!(message) }
+      end
+
+      private
+
+      # Process ENV takes precedence over values loaded from the .env file, matching
+      # the original `Dotenv.load` (no-override) semantics.
+      def env_var_set?(key)
+        ENV.key?(key) || @loaded_env.key?(key)
+      end
+
+      def env_value(key)
+        ENV.key?(key) ? ENV.fetch(key) : @loaded_env[key]
+      end
+
+      # Consider any non-empty, non-falsy value of `CI` to mean we're running on CI.
+      # Most CI providers set `CI=true`, but some use `CI=1`.
+      #
+      # Note: the CI helpers above (`build_number`, etc.) remain Buildkite-specific —
+      # see the block comment on them. Detection via `CI` is a de facto standard and
+      # cheap to generalize; value-fetching is not.
+      def running_on_ci?
+        value = ENV.fetch('CI', nil)
+        return false if value.nil? || value.empty?
+
+        !%w[false 0].include?(value.downcase)
+      end
+    end
+  end
+end

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

@@ -3,6 +3,6 @@
 module Fastlane
   module Wpmreleasetoolkit
     NAME = 'fastlane-plugin-wpmreleasetoolkit'
-    VERSION = '14.3.1'
+    VERSION = '14.4.1'
   end
 end

data/lib/fastlane/plugin/wpmreleasetoolkit.rb

@@ -4,9 +4,9 @@ require 'fastlane/plugin/wpmreleasetoolkit/version'
 
 module Fastlane
   module Wpmreleasetoolkit
-    # Return all .rb files inside the "actions", "helper" and "models" directories
+    # Return all .rb files inside the "actions", "env_manager", "helper", "models", and "versioning" directories
     def self.all_classes
-      Dir[File.expand_path('**/{actions,helper,models,versioning}/**/*.rb', File.dirname(__FILE__))]
+      Dir[File.expand_path('**/{actions,env_manager,helper,models,versioning}/**/*.rb', File.dirname(__FILE__))]
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-wpmreleasetoolkit
 version: !ruby/object:Gem::Version
-  version: 14.3.1
+  version: 14.4.1
 platform: ruby
 authors:
 - Automattic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: buildkit
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: fastlane
   requirement: !ruby/object:Gem::Requirement
@@ -114,14 +128,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.19'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.19.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.19'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.19.3
 - !ruby/object:Gem::Dependency
   name: octokit
   requirement: !ruby/object:Gem::Requirement
@@ -453,6 +473,7 @@ files:
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/ios/ios_send_app_size_metrics.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/ios/ios_update_metadata_source.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/ios/ios_update_release_notes.rb
+- lib/fastlane/plugin/wpmreleasetoolkit/env_manager/env_manager.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/helper/android/android_emulator_helper.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/helper/android/android_localize_helper.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/helper/android/android_tools_path_helper.rb