busybee 0.2.0 → 0.3.0

data/lib/busybee.rb

@@ -3,14 +3,20 @@
 require "socket"
 require "busybee/version"
 require "busybee/defaults"
+require "busybee/configure"
 require "busybee/credentials"
 require "busybee/logging"
 require "busybee/serialization"
 require "busybee/job"
 require "busybee/job_stream"
 require "busybee/client"
+require "busybee/worker"
+require "busybee/runtime_config"
+require "busybee/runner"
+require "busybee/cli"
 
-# Top-level gem module, only holds configuration values.
+# Top-level gem module. Configuration readers and defaults live here;
+# validated setters live in Busybee::Configure.
 module Busybee
   # Valid credential type identifiers. Update this as new credential classes are added.
   VALID_CREDENTIAL_TYPES = %w[insecure tls oauth camunda_cloud].freeze
@@ -18,9 +24,12 @@ module Busybee
   # Valid log format identifiers.
   VALID_LOG_FORMATS = %w[text json].freeze
 
+  # Valid worker mode identifiers.
+  VALID_WORKER_MODES = %i[polling streaming hybrid].freeze
+
   class << self
-    attr_writer :cluster_address, :grpc_retry_enabled, :grpc_retry_delay_ms, :grpc_retry_errors, :default_message_ttl,
-                :default_fail_job_backoff, :worker_name
+    include Configure
+
     attr_accessor :logger
     attr_reader :credentials
 
@@ -28,95 +37,94 @@ module Busybee
       yield self
     end
 
-    def log_format=(value)
-      if value.nil?
-        @log_format = nil
-        return
-      end
+    def cluster_address
+      @cluster_address || ENV.fetch("CLUSTER_ADDRESS", "localhost:26500")
+    end
 
-      str_value = value.to_s
-      if VALID_LOG_FORMATS.include?(str_value)
-        @log_format = str_value.to_sym
-      else
-        Logging.warn("Invalid log_format: #{str_value.inspect}. Valid formats: #{VALID_LOG_FORMATS.join(', ')}")
-      end
+    def credential_type
+      return @credential_type if instance_variable_defined?(:@credential_type) && !@credential_type.nil?
+
+      # Env var fallback - goes through setter for validation
+      env_value = ENV.fetch("BUSYBEE_CREDENTIAL_TYPE", nil)
+      return nil if env_value.nil?
+
+      self.credential_type = env_value
+      @credential_type
     end
 
-    def log_format
-      @log_format || :text
+    def default_fail_job_backoff
+      @default_fail_job_backoff || Defaults::DEFAULT_FAIL_JOB_BACKOFF_MS
     end
 
-    def cluster_address
-      @cluster_address || ENV.fetch("CLUSTER_ADDRESS", "localhost:26500")
+    def default_max_jobs
+      @default_max_jobs || Defaults::DEFAULT_MAX_JOBS
     end
 
-    def worker_name
-      return @worker_name if @worker_name
-      return ENV["BUSYBEE_WORKER_NAME"] if ENV["BUSYBEE_WORKER_NAME"]
+    def default_input_required
+      @default_input_required.nil? ? Defaults::DEFAULT_INPUT_REQUIRED : @default_input_required
+    end
 
-      Socket.gethostname
-    rescue StandardError
-      "busybee-worker"
+    def default_job_lock_timeout
+      @default_job_lock_timeout || Defaults::DEFAULT_JOB_LOCK_TIMEOUT_MS
     end
 
-    def grpc_retry_enabled
-      return @grpc_retry_enabled unless @grpc_retry_enabled.nil?
+    def default_job_request_timeout
+      @default_job_request_timeout || Defaults::DEFAULT_JOB_REQUEST_TIMEOUT_MS
+    end
 
-      false
+    def default_message_ttl
+      @default_message_ttl || Defaults::DEFAULT_MESSAGE_TTL_MS
     end
 
-    def grpc_retry_delay_ms
-      @grpc_retry_delay_ms || Defaults::DEFAULT_GRPC_RETRY_DELAY_MS
+    def default_output_required
+      @default_output_required.nil? ? Defaults::DEFAULT_OUTPUT_REQUIRED : @default_output_required
     end
 
-    def grpc_retry_errors
-      @grpc_retry_errors || default_retry_errors
+    def default_buffer
+      @default_buffer.nil? ? Defaults::DEFAULT_STREAMING_BUFFER : @default_buffer
     end
 
-    def default_message_ttl
-      @default_message_ttl || Defaults::DEFAULT_MESSAGE_TTL_MS
+    def default_buffer_throttle
+      @default_buffer_throttle || Defaults::DEFAULT_BUFFER_THROTTLE_MS
     end
 
-    def default_fail_job_backoff
-      @default_fail_job_backoff || Defaults::DEFAULT_FAIL_JOB_BACKOFF_MS
+    def default_worker_mode
+      @default_worker_mode || Defaults::DEFAULT_WORKER_MODE
     end
 
-    def credential_type=(value)
-      if value.nil?
-        @credential_type = nil
-        return
-      end
+    def grpc_retry_delay_ms
+      @grpc_retry_delay_ms || Defaults::DEFAULT_GRPC_RETRY_DELAY_MS
+    end
+
+    def grpc_retry_enabled
+      return @grpc_retry_enabled unless @grpc_retry_enabled.nil?
 
-      str_value = value.to_s
-      if VALID_CREDENTIAL_TYPES.include?(str_value)
-        @credential_type = str_value.to_sym
-      else
-        Logging.warn("Invalid credential_type: #{str_value.inspect}. Valid types: #{VALID_CREDENTIAL_TYPES.join(', ')}")
-      end
+      false
     end
 
-    def credential_type
-      return @credential_type if instance_variable_defined?(:@credential_type) && !@credential_type.nil?
+    def grpc_retry_errors
+      @grpc_retry_errors || default_retry_errors
+    end
 
-      # Env var fallback - goes through setter for validation
-      env_value = ENV.fetch("BUSYBEE_CREDENTIAL_TYPE", nil)
-      return nil if env_value.nil?
+    def log_format
+      @log_format || :text
+    end
 
-      self.credential_type = env_value
-      @credential_type
+    def default_backpressure_delay
+      @default_backpressure_delay || Defaults::DEFAULT_BACKPRESSURE_DELAY_MS
     end
 
-    def credentials=(value)
-      if value.nil?
-        @credentials = nil
-        return
-      end
+    def shutdown_on_errors
+      @shutdown_on_errors ||= []
+    end
 
-      unless value.is_a?(Busybee::Credentials)
-        raise ArgumentError, "credentials must be a Busybee::Credentials object, got #{value.class}"
-      end
+    def worker_name
+      return @worker_name if @worker_name
+      return ENV["BUSYBEE_WORKER_NAME"] if ENV["BUSYBEE_WORKER_NAME"]
 
-      @credentials = value
+      Socket.gethostname
+    rescue StandardError
+      "busybee-worker"
     end
 
     private

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: busybee
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andy Rusterholz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-05 00:00:00.000000000 Z
+date: 2026-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -38,6 +38,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.7
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.7
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: grpc
   requirement: !ruby/object:Gem::Requirement
@@ -58,7 +78,8 @@ description: The missing Ruby gem for Camunda 8. Production-ready worker framewo
   and CI/CD deployment tooling for BPMNs.
 email:
 - andyrusterholz@gmail.com
-executables: []
+executables:
+- busybee
 extensions: []
 extra_rdoc_files: []
 files:
@@ -70,13 +91,17 @@ files:
 - docs/configuration.md
 - docs/grpc.md
 - docs/testing.md
+- docs/workers.md
+- exe/busybee
 - lib/busybee.rb
+- lib/busybee/cli.rb
 - lib/busybee/client.rb
 - lib/busybee/client/error_handling.rb
 - lib/busybee/client/job_operations.rb
 - lib/busybee/client/message_operations.rb
 - lib/busybee/client/process_operations.rb
 - lib/busybee/client/variable_operations.rb
+- lib/busybee/configure.rb
 - lib/busybee/credentials.rb
 - lib/busybee/credentials/camunda_cloud.rb
 - lib/busybee/credentials/insecure.rb
@@ -92,16 +117,30 @@ files:
 - lib/busybee/job_stream.rb
 - lib/busybee/logging.rb
 - lib/busybee/railtie.rb
+- lib/busybee/runner.rb
+- lib/busybee/runner/hybrid.rb
+- lib/busybee/runner/multi.rb
+- lib/busybee/runner/polling.rb
+- lib/busybee/runner/streaming.rb
+- lib/busybee/runtime_config.rb
 - lib/busybee/serialization.rb
 - lib/busybee/testing.rb
 - lib/busybee/testing/activated_job.rb
 - lib/busybee/testing/helpers.rb
+- lib/busybee/testing/helpers/execution.rb
 - lib/busybee/testing/helpers/support.rb
+- lib/busybee/testing/matchers/complete_job.rb
+- lib/busybee/testing/matchers/fail_job.rb
 - lib/busybee/testing/matchers/have_activated.rb
 - lib/busybee/testing/matchers/have_available_jobs.rb
 - lib/busybee/testing/matchers/have_received_headers.rb
 - lib/busybee/testing/matchers/have_received_variables.rb
+- lib/busybee/testing/matchers/throw_bpmn_error_on.rb
 - lib/busybee/version.rb
+- lib/busybee/worker.rb
+- lib/busybee/worker/configuration.rb
+- lib/busybee/worker/dsl.rb
+- lib/busybee/worker/shutdown.rb
 homepage: https://github.com/rusterholz/busybee
 licenses:
 - MIT