gruf 2.9.1 → 2.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bffd546b0bd27dcd8cd54146065623e73e0396211ae263985a197255bb8ec48a
-  data.tar.gz: 9b0364643ab5c1008a330ed61c8fba4458f9b075c34eea81acb10de4ee70f53d
+  metadata.gz: 5186fbfc554b119075aff88683ee7f1661a884d96d9766e59664d10805bd4ab2
+  data.tar.gz: 68b995a644b15dc703595df4e35a25539e0edf77d5f5218bffa28253b60eedbf
 SHA512:
-  metadata.gz: 3ef4637ca552b572f77b270ccdc491c660b62d7c1d8ff85fe67151cf22f09e92f18a9b88b63d31e956411cb46380ba695e0eccc74d47a2095c8fc7d6ebfaf838
-  data.tar.gz: 0f38cc6c69487f1cab2ebc5e07b5a06de20f5e35d0000ad4c80a021288557aaaef2acf58fe254be6dc292ddd2e764976acfdd65578a7a0233c663dea83018eb3
+  metadata.gz: 8328cccfcc712c21cb5a477939762524d774d3d45a0882217fe3b7d701cfda90e9dcd27af7ab4c4cbc73ca46d420d85e55be3712efc950590212658030217c40
+  data.tar.gz: 2cf04dce0c4e378edf56ab6b204293ce2b4dc660d2ac103ac55d99e893891ac3a76feb2e05dee4ac3371b47083fd8523441e7e2c87881bacd2511b016a1965b3

data/CHANGELOG.md

@@ -2,11 +2,67 @@ Changelog for the gruf gem. This includes internal history before the gem was ma
 
 ### Pending release
 
-### 2.9.1
+### 2.15.1
+
+- Fix issue where GRPC_SERVER_POOL_KEEP_ALIVE and GRPC_SERVER_POLL_PERIOD when set via ENV are not cast to int
+
+### 2.15.0
+
+- NOTE: This changes the way that gruf controllers are autoloaded. See [UPGRADING.md] for more details.
+- Autoload Gruf Controllers with zeitwerk, allowing for code reloading in development environments
+- Add `GRUF_CONTROLLERS_PATH` ENV to allow ENV-based runtime configuration of path to gruf controller files
+- Move `ServiceBinder` from instance to static class for performance improvements
+- Use zeitwerk for autoloading
+- Update gem metadata
+- Update `Gruf:Configuration#environment` to use `ENV.fetch`
+
+### 2.14.1
+
+- Fix issue where the server object hits thread contention in certain race conditions
+
+### 2.14.0
+
+- Set default client host to 0.0.0.0:9001 (same as default server host)
+- Add support for Ruby 3.1
+
+### 2.13.1
+
+- Fix issue with race condition in server starts where servers may fail to bind connections and never reach
+  serving state (fixes #147)
+
+### 2.13.0
+
+- Remove server mutex handling in deference to core grpc signal handling
+- Relax grpc pin as upstream regression is fixed
+
+### 2.12.0
+
+- Fixed interceptor order to be FIFO as documented, instead of FILO (fixes #139)
+
+### 2.11.0
+
+- Restrict grpc gem to <= 1.41.0 due to regressions in grpc 1.42.x
+- Fallback to stdout logger at INFO if no logger is setup
+- Better handling of namespace collisions with Rails
+- Add `GRPC_SERVER_HOST` and `GRPC_SERVER_PORT` for ENV configuration of the server host+port
+- Add `GRPC_BACKTRACE_ON_ERROR` as available ENV configuration
+- Add default ENV-based configuration of the GRPC server pool
+  - `GRPC_SERVER_POOL_SIZE` - sets the size of the GRPC server pool
+  - `GRPC_SERVER_POOL_KEEP_ALIVE` - keep alive time for threads spawned by the server pool
+  - `GRPC_SERVER_POLL_PERIOD` - period in seconds to poll for workers in the gRPC server pool
+- Improve Yardoc support across the library
+- Added attribute-based documentation for Gruf configuration options
+- Add mfa required for gemspec metadata
+
+### 2.10.0
 
 - Drop support for Ruby 2.4/2.5 to align with Ruby EOL schedule, supporting 2.6+ only
 - Allow for float/TimeSpec timeout values on clients
 
+### 2.9.1
+
+- Allow for float/TimeSpec timeout values on clients (backport from 2.10.0)
+
 ### 2.9.0
 
 - Change to racially neutral terminology across library
@@ -25,7 +81,7 @@ Changelog for the gruf gem. This includes internal history before the gem was ma
 
 ### 2.8.0
 
-- Pass the controller request object into the request logging formatters [#92]  
+- Pass the controller request object into the request logging formatters [#92]
 
 ### 2.7.1
 
@@ -38,12 +94,12 @@ Changelog for the gruf gem. This includes internal history before the gem was ma
 ### 2.6.1
 
 - Add frozen_string_literal: true to files, update rubocop to 0.68
-  
+
 ### 2.6.0
 
 - Drop Ruby 2.2 support
-- Abstract gruf controller's send to make it usable in filters 
-- Adjusts configuration reset into a Railtie for Rails systems to ensure proper OOE 
+- Abstract gruf controller's send to make it usable in filters
+- Adjusts configuration reset into a Railtie for Rails systems to ensure proper OOE
 - Bump rubocop to 0.64, address violations, update activesupport/concurrent-ruby dependencies to have a min version
 
 ### 2.5.2

data/README.md

@@ -1,8 +1,8 @@
 # gruf - gRPC Ruby Framework
 
-[![CircleCI](https://circleci.com/gh/bigcommerce/gruf/tree/main.svg?style=svg)](https://circleci.com/gh/bigcommerce/gruf/tree/main) [![Gem Version](https://badge.fury.io/rb/gruf.svg)](https://badge.fury.io/rb/gruf) [![Documentation](https://inch-ci.org/github/bigcommerce/gruf.svg?branch=main)](https://inch-ci.org/github/bigcommerce/gruf?branch=main)
+[![CircleCI](https://circleci.com/gh/bigcommerce/gruf/tree/main.svg?style=svg)](https://circleci.com/gh/bigcommerce/gruf/tree/main) [![Gem Version](https://badge.fury.io/rb/gruf.svg)](https://badge.fury.io/rb/gruf) [![Documentation](https://inch-ci.org/github/bigcommerce/gruf.svg?branch=main)](https://inch-ci.org/github/bigcommerce/gruf?branch=main) [![Maintainability](https://api.codeclimate.com/v1/badges/4a8e9269f99100aeb7cb/maintainability)](https://codeclimate.com/github/bigcommerce/gruf/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/4a8e9269f99100aeb7cb/test_coverage)](https://codeclimate.com/github/bigcommerce/gruf/test_coverage)
 
-gruf is a Ruby framework that wraps the [gRPC Ruby library](https://github.com/grpc/grpc/tree/main/src/ruby) to
+gruf is a Ruby framework that wraps the [gRPC Ruby library](https://github.com/grpc/grpc/tree/master/src/ruby) to
 provide a more streamlined integration into Ruby and Ruby on Rails applications.
 
 It provides an abstracted server and client for gRPC services, along with other tools to help get gRPC services in Ruby
@@ -17,7 +17,7 @@ up fast and efficiently at scale. Some of its features include:
   still preserving gRPC BadStatus codes
 * Server and client execution timings in responses
 
-gruf currently has active support for gRPC 1.10.x+. gruf is compatible and tested with Ruby 2.2-2.7.
+gruf currently has active support for gRPC 1.10.x+. gruf is compatible and tested with Ruby 2.6-3.1.
 gruf is also not [Rails](https://github.com/rails/rails)-specific, and can be used in any Ruby framework
 (such as [Grape](https://github.com/ruby-grape/grape) or [dry-rb](https://dry-rb.org/), for instance).
 

data/gruf.gemspec

@@ -15,8 +15,7 @@
 # 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.
 #
-$LOAD_PATH.push File.expand_path('lib', __dir__)
-require 'gruf/version'
+require_relative 'lib/gruf/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'gruf'
@@ -33,9 +32,17 @@ Gem::Specification.new do |spec|
   spec.executables << 'gruf'
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.4', '< 3.1'
+  spec.required_ruby_version = '>= 2.6', '< 3.2'
+
+  spec.metadata = {
+    'bug_tracker_uri' => 'https://github.com/bigcommerce/gruf/issues',
+    'changelog_uri' => 'https://github.com/bigcommerce/gruf/CHANGELOG.md',
+    'homepage_uri' => 'https://github.com/bigcommerce/gruf',
+    'rubygems_mfa_required' => 'true',
+    'source_code_uri' => 'https://github.com/bigcommerce/gruf',
+    'wiki_uri' => 'https://github.com/bigcommerce/gruf/wiki'
+  }
 
-  spec.add_development_dependency 'bundler', '~> 1.11'
   spec.add_development_dependency 'bundler-audit', '>= 0.6'
   # rubocop:disable Gemspec/RubyVersionGlobalsUsage
   spec.add_development_dependency(
@@ -57,10 +64,11 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency 'activesupport', '> 4'
   spec.add_runtime_dependency 'concurrent-ruby', '> 1'
-  spec.add_runtime_dependency 'e2mmap', '~> 0.1'
+  spec.add_runtime_dependency 'e2mmap', '>= 0.1'
   spec.add_runtime_dependency 'grpc', '~> 1.10'
   spec.add_runtime_dependency 'grpc-tools', '~> 1.10'
   spec.add_runtime_dependency 'json', '>= 2.3'
-  spec.add_runtime_dependency 'slop', '~> 4.6'
-  spec.add_runtime_dependency 'thwait', '~> 0.1'
+  spec.add_runtime_dependency 'slop', '>= 4.6'
+  spec.add_runtime_dependency 'thwait', '>= 0.1'
+  spec.add_runtime_dependency 'zeitwerk', '>= 2'
 end

data/lib/gruf/autoloaders.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2022-present, BigCommerce Pty. Ltd. All rights reserved
+#
+# 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.
+#
+module Gruf
+  ##
+  # Module for accessing Gruf zeitwerk-based autoloaders
+  #
+  module Autoloaders
+    class << self
+      include Enumerable
+
+      ##
+      # Initialize the autoloaders with a given controllers path
+      #
+      # @param [String] controllers_path The path to Gruf Controllers
+      #
+      def load!(controllers_path:)
+        controllers(controllers_path: controllers_path)
+      end
+
+      ##
+      # Enumerate across the managed set of autoloaders
+      #
+      def each
+        yield controllers
+      end
+
+      ##
+      # Reload all files managed by the autoloader
+      #
+      def reload
+        each(&:reload)
+      end
+
+      ##
+      # Lazily instantiate and memoize the Gruf Controllers autoloader in a thread-safe manner
+      #
+      # @return [::Gruf::Controllers::Autoloader]
+      #
+      # rubocop:disable ThreadSafety/InstanceVariableInClassMethod
+      def controllers(controllers_path: nil)
+        controllers_mutex do
+          @controllers ||= ::Gruf::Controllers::Autoloader.new(path: controllers_path || ::Gruf.controllers_path)
+        end
+      end
+      # rubocop:enable ThreadSafety/InstanceVariableInClassMethod
+
+      ##
+      # Handle mutations to the controllers autoloader in a thread-safe manner
+      #
+      # rubocop:disable ThreadSafety/InstanceVariableInClassMethod
+      def controllers_mutex(&block)
+        @controllers_mutex ||= begin
+          require 'monitor'
+          Monitor.new
+        end
+        @controllers_mutex.synchronize(&block)
+      end
+      # rubocop:enable ThreadSafety/InstanceVariableInClassMethod
+    end
+  end
+end

data/lib/gruf/cli/executor.rb

@@ -23,8 +23,14 @@ module Gruf
     # Handles execution of the gruf binstub, along with command-line arguments
     #
     class Executor
+      class NoServicesBoundError < StandardError; end
+
       ##
       # @param [Hash|ARGV]
+      # @param [::Gruf::Server|NilClass] server
+      # @param [Array<Class>|NilClass] services
+      # @param [Gruf::Hooks::Executor|NilClass] hook_executor
+      # @param [Logger|NilClass] logger
       #
       def initialize(
         args = ARGV,
@@ -35,7 +41,7 @@ module Gruf
       )
         @args = args
         setup! # ensure we set some defaults from CLI here so we can allow configuration
-        @services = services || Gruf.services
+        @services = services.is_a?(Array) ? services : []
         @hook_executor = hook_executor || Gruf::Hooks::Executor.new(hooks: Gruf.hooks&.prepare)
         @server = server || Gruf::Server.new(Gruf.server_options)
         @logger = logger || Gruf.logger || ::Logger.new($stderr)
@@ -46,6 +52,17 @@ module Gruf
       #
       def run
         exception = nil
+        # wait to load controllers until last possible second to allow late configuration
+        ::Gruf.autoloaders.load!(controllers_path: Gruf.controllers_path)
+        # allow lazy registering globally as late as possible, this allows more flexible binstub injections
+        @services = ::Gruf.services unless @services&.any?
+
+        unless @services.any?
+          raise NoServicesBoundError,
+                'No services bound to this gruf process; please bind a service to a Gruf controller ' \
+                'to start the server successfully'
+        end
+
         begin
           @services.each { |s| @server.add_service(s) }
           @hook_executor.call(:before_server_start, server: @server)

data/lib/gruf/client/error.rb

@@ -23,7 +23,8 @@ module Gruf
     # GRPC::BadStatus error
     #
     class Error < StandardError
-      # @return [Object] error The deserialized error
+      # @!attribute [r] error
+      #   @return [Object] error The deserialized error
       attr_reader :error
 
       ##
@@ -36,33 +37,5 @@ module Gruf
         super
       end
     end
-
-    ##
-    # See https://github.com/grpc/grpc-go/blob/master/codes/codes.go for a detailed summary of each error type
-    #
-    module Errors
-      class Base < Gruf::Client::Error; end
-      class Error < Base; end
-      class Validation < Base; end
-
-      class Ok < Base; end
-
-      class InvalidArgument < Validation; end
-      class NotFound < Validation; end
-      class AlreadyExists < Validation; end
-      class OutOfRange < Validation; end
-
-      class Cancelled < Error; end
-      class DataLoss < Error; end
-      class DeadlineExceeded < Error; end
-      class FailedPrecondition < Error; end
-      class Internal < Error; end
-      class PermissionDenied < Error; end
-      class ResourceExhausted < Error; end
-      class Unauthenticated < Error; end
-      class Unavailable < Error; end
-      class Unimplemented < Error; end
-      class Unknown < Error; end
-    end
   end
 end

data/lib/gruf/client/errors.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-present, BigCommerce Pty. Ltd. All rights reserved
+#
+# 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.
+#
+module Gruf
+  class Client < SimpleDelegator
+    ##
+    # See https://github.com/grpc/grpc-go/blob/master/codes/codes.go for a detailed summary of each error type
+    #
+    module Errors
+      class Base < Gruf::Client::Error; end
+      class Error < Base; end
+      class Validation < Base; end
+
+      class Ok < Base; end
+
+      class InvalidArgument < Validation; end
+      class NotFound < Validation; end
+      class AlreadyExists < Validation; end
+      class OutOfRange < Validation; end
+
+      class Cancelled < Error; end
+      class DataLoss < Error; end
+      class DeadlineExceeded < Error; end
+      class FailedPrecondition < Error; end
+      class Internal < Error; end
+      class PermissionDenied < Error; end
+      class ResourceExhausted < Error; end
+      class Unauthenticated < Error; end
+      class Unavailable < Error; end
+      class Unimplemented < Error; end
+      class Unknown < Error; end
+    end
+  end
+end

data/lib/gruf/client.rb

@@ -15,9 +15,6 @@
 # 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.
 #
-require_relative 'client/error'
-require_relative 'client/error_factory'
-
 module Gruf
   ##
   # Abstracts out the calling interface for interacting with gRPC clients. Streamlines calling and provides
@@ -38,11 +35,14 @@ module Gruf
   class Client < SimpleDelegator
     include Gruf::Loggable
 
-    # @return [Class] The base, friendly name of the service being requested
+    # @!attribute [r] base_klass
+    #   @return [Class] The base, friendly name of the service being requested
     attr_reader :base_klass
-    # @return [Class] The class name of the gRPC service being requested
+    # @!attribute [r] service_klass
+    #   @return [Class] The class name of the gRPC service being requested
     attr_reader :service_klass
-    # @return [Hash] A hash of options for the client
+    # @!attribute [r] opts
+    #   @return [Hash] A hash of options for the client
     attr_reader :opts
 
     ##
@@ -230,7 +230,7 @@ module Gruf
         GRPC::Core::TimeConsts::ZERO
       elsif timeout.is_a?(GRPC::Core::TimeSpec)
         timeout
-      elsif timeout.is_a?(Numeric)
+      elsif timeout.is_a?(Numeric) # rubocop:disable Lint/DuplicateBranch
         timeout
       elsif timeout.respond_to?(:to_f)
         timeout.to_f

data/lib/gruf/configuration.rb

@@ -20,6 +20,63 @@ module Gruf
   # Represents configuration settings for the system
   #
   module Configuration
+    # @!attribute root_path
+    #   @return [String] The root path for your application
+    # @!attribute server_binding_url
+    #   @return [String] The full hostname:port that the gRPC server should bind to
+    # @!attribute server_options
+    #   @return [Hash] A hash of options to pass to the server instance
+    # @!attribute interceptors
+    #   @return [::Gruf::Interceptors::Registry] A registry of Gruf server interceptors
+    # @!attribute hooks
+    #   @return [::Gruf::Hooks::Registry] A registry of Gruf hooks for the server
+    # @!attribute default_channel_credentials
+    #   @return [NilClass]
+    #   @return [Symbol]
+    #   @return [Hash]
+    # @!attribute default_client_host
+    #   @return [String] The default host for all new Gruf::Client objects to use as their target host
+    # @!attribute use_ssl
+    #   @return [Boolean] If true, will setup the server to use TLS
+    # @!attribute ssl_crt_file
+    #   @return [String] If use_ssl is true, the relative path from the root_path to the CRT file for the server
+    # @!attribute ssl_key_file
+    #   @return [String] If use_ssl is true, the relative path from the root_path to the key file for the server
+    # @!attribute controllers_path
+    #   @return [String] The relative path from root_path to locate Gruf Controllers in
+    # @!attribute services
+    #   @return [Array<Class>] An array of services to serve with this Gruf server
+    # @!attribute logger
+    #   @return [Logger] The logger class for Gruf-based logging
+    # @!attribute grpc_logger
+    #   @return [Logger] The logger to use with GRPC's core logger (which logs plaintext). It is recommended to set
+    #      this to an STDOUT logger and use a logging pipeline that can translate plaintext logs given GRPC's
+    #      unformatted logging.
+    # @!attribute error_metadata_key
+    #   @return [Symbol] The metadata key to use for error messages sent back in trailing metadata.
+    # @!attribute error_serializer
+    #   @return [NilClass|::Gruf::Serializers::Errors::Base] The error serializer to use for error messages sent
+    #      back in trailing metadata. Defaults to the base JSON serializer.
+    # @!attribute append_server_errors_to_trailing_metadata
+    #   @return [Boolean] If true, will append all server error information into the trailing metadata in the response
+    #      from the server
+    # @!attribute use_default_interceptors
+    #   @return [Boolean] If true, will use the default ActiveRecord and Timer interceptors for servers
+    # @!attribute backtrace_on_error
+    #   @return [Boolean] If true, will return the backtrace on any errors in servers in the trailing metadata
+    # @!attribute backtrace_limit
+    #   @return [Integer] The limit of lines to use in backtraces returned
+    # @!attribute use_exception_message
+    #   @return [String] If true, will pass the actual exception message from the error in a server
+    # @!attribute internal_error_message
+    #   @return [String] If use_exception_message is false, this message will be used instead as a replacement
+    # @!attribute event_listener_proc
+    #   @return [NilClass]
+    #   @return [Proc] If set, this will be used during GRPC events (such as pool exhaustions)
+    # @!attribute synchronized_client_internal_cache_expiry
+    #   @return [Integer] Internal cache expiry period (in seconds) for the SynchronizedClient
+    # @!attribute rpc_server_options
+    #   @return [Hash] A hash of RPC options for GRPC server configuration
     VALID_CONFIG_KEYS = {
       root_path: '',
       server_binding_url: '0.0.0.0:9001',
@@ -27,7 +84,7 @@ module Gruf
       interceptors: nil,
       hooks: nil,
       default_channel_credentials: nil,
-      default_client_host: '',
+      default_client_host: '0.0.0.0:9001',
       use_ssl: false,
       ssl_crt_file: '',
       ssl_key_file: '',
@@ -61,8 +118,8 @@ module Gruf
     # Whenever this is extended into a class, setup the defaults
     #
     def self.extended(base)
-      if defined?(Rails)
-        Gruf::Integrations::Rails::Railtie.config.before_initialize { base.reset }
+      if defined?(::Rails)
+        ::Gruf::Integrations::Rails::Railtie.config.before_initialize { base.reset }
       else
         base.reset
       end
@@ -100,26 +157,40 @@ module Gruf
       VALID_CONFIG_KEYS.each do |k, v|
         send("#{k}=", v)
       end
-      self.interceptors = Gruf::Interceptors::Registry.new
-      self.hooks = Gruf::Hooks::Registry.new
-      self.root_path = Rails.root.to_s.chomp('/') if defined?(Rails)
-      if defined?(Rails) && Rails.logger
-        self.logger = Rails.logger
-      else
-        require 'logger'
-        self.logger = ::Logger.new($stdout)
-      end
-      self.grpc_logger = logger if grpc_logger.nil?
+      self.server_binding_url = "#{::ENV.fetch('GRPC_SERVER_HOST',
+                                               '0.0.0.0')}:#{::ENV.fetch('GRPC_SERVER_PORT', 9_001)}"
+      self.interceptors = ::Gruf::Interceptors::Registry.new
+      self.hooks = ::Gruf::Hooks::Registry.new
+      self.root_path = ::Rails.root.to_s.chomp('/') if defined?(::Rails)
+      determine_loggers
       self.ssl_crt_file = "#{root_path}config/ssl/#{environment}.crt"
       self.ssl_key_file = "#{root_path}config/ssl/#{environment}.key"
-      self.controllers_path = root_path.to_s.empty? ? 'app/rpc' : "#{root_path}/app/rpc"
+      cp = ::ENV.fetch('GRUF_CONTROLLERS_PATH', 'app/rpc').to_s
+      self.controllers_path = root_path.to_s.empty? ? cp : "#{root_path}/#{cp}"
+      self.backtrace_on_error = ::ENV.fetch('GRPC_BACKTRACE_ON_ERROR', 0).to_i.positive?
+      self.rpc_server_options = {
+        max_waiting_requests: ::ENV.fetch('GRPC_SERVER_MAX_WAITING_REQUESTS',
+                                          GRPC::RpcServer::DEFAULT_MAX_WAITING_REQUESTS).to_i,
+        pool_size: ::ENV.fetch('GRPC_SERVER_POOL_SIZE', GRPC::RpcServer::DEFAULT_POOL_SIZE).to_i,
+        pool_keep_alive: ::ENV.fetch('GRPC_SERVER_POOL_KEEP_ALIVE', GRPC::Pool::DEFAULT_KEEP_ALIVE).to_i,
+        poll_period: ::ENV.fetch('GRPC_SERVER_POLL_PERIOD', GRPC::RpcServer::DEFAULT_POLL_PERIOD).to_i,
+        connect_md_proc: nil,
+        server_args: {}
+      }
       if use_default_interceptors
-        interceptors.use(Gruf::Interceptors::ActiveRecord::ConnectionReset)
-        interceptors.use(Gruf::Interceptors::Instrumentation::OutputMetadataTimer)
+        interceptors.use(::Gruf::Interceptors::ActiveRecord::ConnectionReset)
+        interceptors.use(::Gruf::Interceptors::Instrumentation::OutputMetadataTimer)
       end
       options
     end
 
+    ##
+    # @return [Boolean]
+    #
+    def development?
+      environment == 'development'
+    end
+
     private
 
     ##
@@ -128,11 +199,30 @@ module Gruf
     # @return [String] The current Ruby environment
     #
     def environment
-      if defined?(Rails)
-        Rails.env.to_s
+      if defined?(::Rails)
+        ::Rails.env.to_s
+      else
+        ENV.fetch('RACK_ENV') { ENV.fetch('RAILS_ENV', 'development') }.to_s
+      end
+    end
+
+    ##
+    # Dynamically determine the appropriate logger
+    #
+    def determine_loggers
+      if defined?(::Rails) && ::Rails.logger
+        self.logger = ::Rails.logger
       else
-        (ENV['RACK_ENV'] || ENV['RAILS_ENV'] || 'development').to_s
+        require 'logger'
+        self.logger = ::Logger.new($stdout)
+        log_level = ::ENV.fetch('LOG_LEVEL', 'info').to_s.upcase
+        begin
+          logger.level = ::Logger::Severity.const_get(log_level)
+        rescue NameError => _e
+          logger.level = ::Logger::Severity::INFO
+        end
       end
+      self.grpc_logger = logger if grpc_logger.nil?
     end
   end
 end

data/lib/gruf/controllers/autoloader.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-present, BigCommerce Pty. Ltd. All rights reserved
+#
+# 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.
+#
+module Gruf
+  module Controllers
+    ##
+    # Handles autoloading of Gruf controllers in the application path. This allows for code reloading on Gruf
+    # controllers.
+    #
+    class Autoloader
+      include ::Gruf::Loggable
+
+      # @!attribute [r] path
+      #   @return [String] The path for this autoloader
+      attr_reader :path
+
+      ##
+      # @param [String] path
+      # @param [Boolean] reloading
+      # @param [String] tag
+      #
+      def initialize(path:, reloading: nil, tag: nil)
+        super()
+        @path = path
+        @loader = ::Zeitwerk::Loader.new
+        @loader.tag = tag || 'gruf-controllers'
+        @setup = false
+        @reloading_enabled = reloading || ::Gruf.development?
+        setup!
+      end
+
+      ##
+      # Reload all files managed by the autoloader, if reloading is enabled
+      #
+      def reload
+        @loader.reload if @reloading_enabled
+      end
+
+      private
+
+      ##
+      # @return [Boolean]
+      #
+      def setup!
+        return true if @setup
+
+        return false unless File.directory?(@path)
+
+        @loader.enable_reloading if @reloading_enabled
+        @loader.ignore("#{@path}/**/*_pb.rb")
+        @loader.push_dir(@path)
+        @loader.setup
+        # always eager load RPC files, so that the service binder can bind the Gruf::Controller instantiation
+        # to the gRPC Service classes
+        @loader.eager_load
+        @setup = true
+      end
+    end
+  end
+end