provider_kit 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba514d53e0d9f91bec62dbe6ff0687b73038ae223a19f266a6a11321fda19b54
-  data.tar.gz: 33ab21762119c6ca00ce6951fde0bedd45f6c9e719c4b175478592df47c7aadf
+  metadata.gz: da3e02d32cafa95d8718676ae02a14be2e79d520b90bee3e10f3b3738b75c507
+  data.tar.gz: 2276650b63b069e3ba4890f171925d903cbe603776355bb6a285194da69a3a83
 SHA512:
-  metadata.gz: e16ff38a23a7cb98796299f1259f009d94fb5ae2b28cf6db850e38b3f58f6a0ab89eec170d25a1b537569842497694ba74fb0fd660d91df609fc3b573c578675
-  data.tar.gz: 00ed090c391619a04d47dc39ca56d42f9bbdef1742bfa4ced62e009624508224b71e7677f4cac17a1c33e9c16b36e544c1c75b6ad07d35d1610b0b92ce80d678
+  metadata.gz: 1dde2f369723133094c1a28c6220713808a459f94d02f1d39ae681327e57e7cc7b86ad54234e0d09cbc24e9a262f0d729efa051f41b7a2550e489d6b35c6089e
+  data.tar.gz: '0204738efbe20bfa85e55f8ea9a4c48dd145836b822f2c53a047f053b969599486a49c8ce3c2b5f78ab7df905f8461d1e2728858d1da1b25c3326e1e6d025086'

data/lib/provider_kit/attribute.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ProviderKit
+  # serialized attribute for provider
+  module Attribute
+
+    extend ActiveSupport::Concern
+
+    def provider
+      if provider_key.present?
+        @provider ||= ProviderKit::ProviderAttribute.new(provider_key, record: self)
+      end
+    end
+
+    def provider=(value)
+      @provider = nil
+
+      write_attribute(:provider, value.to_s.presence)
+    end
+
+    def provider_key
+      read_attribute(:provider).to_s.presence
+    end
+
+  end
+end

data/lib/provider_kit/capability.rb

@@ -26,6 +26,15 @@ module ProviderKit
       end
     end
 
+    def respond_to_missing?(method_name, include_private = false)
+      if method_name.to_s.match?(/(.+)\?$/)
+        attribute_name = method_name.to_s.chomp("?")
+        return callable?(attribute_name)
+      end
+
+      callable?(method_name) || super
+    end
+
     def with_context(provider: @provider, **context)
       Capability.new(
         key,
@@ -42,8 +51,12 @@ module ProviderKit
 
       def call(method_name, *args, **kwargs)
         call_target = target
-        return nil unless call_target
-        return nil unless callable?(method_name)
+        return unless call_target
+
+        unless callable?(method_name)
+          raise NoMethodError,
+            "undefined method `#{ method_name }' for instance of #{ @target_klass }"
+        end
 
         raw_response = call_target.public_send(method_name, *args, **kwargs)
 

data/lib/provider_kit/capable.rb

@@ -41,6 +41,13 @@ module ProviderKit
       end
     end
 
+    # Null provider is a placeholder for integrations that do not need a custom provider
+    #
+    # returns true if this is the null provider
+    def null?
+      key == :null
+    end
+
     def provider_key
       key
     end
@@ -66,6 +73,14 @@ module ProviderKit
         capability.callable?(method_name)
       end
 
+      def config
+        provider.config
+      end
+
+      def label
+        config[:name].presence || self.to_s.underscore.humanize
+      end
+
       def method_missing(method_name, *args, **kwargs)
         if capable_of?(method_name)
           perform_capability(method_name, *args, **kwargs)

data/lib/provider_kit/null_provider.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module ProviderKit
+  # This is an empty provider that doesn't do anything, but can be used as a placeholder
+  class NullProvider
+
+    include ProviderKit::Capable
+
+  end
+end

data/lib/provider_kit/provideable.rb

@@ -5,27 +5,12 @@ module ProviderKit
   module Provideable
 
     extend ActiveSupport::Concern
+    include Attribute
 
     included do
       validate :validate_provider_presence
     end
 
-    def provider
-      if provider_key.present?
-        @provider ||= ProviderKit::ProviderAttribute.new(provider_key, record: self)
-      end
-    end
-
-    def provider=(value)
-      @provider = nil
-
-      write_attribute(:provider, value.to_s.presence)
-    end
-
-    def provider_key
-      read_attribute(:provider).to_s.presence
-    end
-
     private
 
       def validate_provider_presence

data/lib/provider_kit/provider.rb

@@ -29,6 +29,10 @@ module ProviderKit
     def provider_instance
       return nil unless provider
 
+      if provider.class == Module
+        raise "Provider #{ provider } is a module, not a class"
+      end
+
       instance = provider.new
 
       if instance.respond_to?(:context=) && record != key

data/lib/provider_kit/provider_attribute.rb

@@ -6,6 +6,8 @@ module ProviderKit
 
     include Buildable
 
+    ATTRIBUTE_QUERY = /^(?<attribute>[a-z0-9_]+)\?$/.freeze
+
     attr_reader :key
     attr_reader :record
     attr_reader :context
@@ -25,20 +27,35 @@ module ProviderKit
     end
 
     def method_missing(method_name, *args)
-      return nil unless provider.present?
+      return super unless provider.present?
 
       if provider.respond_to?(method_name)
         return provider.public_send(method_name, *args)
       end
 
       # self.amazon_selling_partner? ==> self.key == :amazon_selling_partner
-      if match = method_name.to_s.match(/^(?<attribute>[a-z0-9_]+)\?$/)
+      if match = method_name.to_s.match(ATTRIBUTE_QUERY)
         return match[:attribute].to_clean_sym == key
       end
 
       provider.with_context(**context).public_send(method_name, *args)
     end
 
+    def respond_to_missing?(method_name, include_private = false)
+      return super unless provider.present?
+
+      # Check if the provider responds to the method
+      return true if provider.respond_to?(method_name, include_private)
+
+      # Match dynamic `attribute?` methods
+      return true if method_name.to_s.match?(ATTRIBUTE_QUERY)
+
+      # Check if the provider with context responds to the method
+      return true if provider.with_context(**context).respond_to?(method_name, include_private)
+
+      super
+    end
+
     def label
       name
     end

data/lib/provider_kit/registerable.rb

@@ -5,7 +5,7 @@ module ProviderKit
   module Registerable
 
     def deregister(key)
-      if registration = registrations[key]
+      if registrations[key]
         config.registered_providers.delete(key)
       end
     end
@@ -20,6 +20,11 @@ module ProviderKit
       end
     end
 
+    # special provider for placeholders
+    def null
+      ProviderKit.registrations[:null].klass
+    end
+
     def providers(type: nil)
       registrations(type:).values.map(&:klass)
     end

data/lib/provider_kit/version.rb

@@ -2,7 +2,7 @@
 
 module ProviderKit
 
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 
   module Version
 

data/lib/provider_kit.rb

@@ -35,6 +35,7 @@ module ProviderKit
   end
 
   ## Core
+  autoload :Attribute
   autoload :Callbacks
   autoload :EncryptedSettings
   autoload :Encryptor
@@ -42,6 +43,7 @@ module ProviderKit
   autoload :JsonClient
   autoload :JsonRequest
   autoload :Logging
+  autoload :NullProvider
   autoload :Provideable
   autoload :Provider
   autoload :ProviderAttribute
@@ -58,4 +60,7 @@ module ProviderKit
   extend Registerable
   extend Buildable
 
+  # this is just a placeholder for integrations that do not need a custom provider
+  register :null, class_name: "ProviderKit::NullProvider"
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: provider_kit
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - John D. Tornow
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-23 00:00:00.000000000 Z
+date: 2025-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -155,6 +155,7 @@ files:
 - lib/generators/provider/templates/provider.rb.tt
 - lib/generators/provider/templates/spec.rb.tt
 - lib/provider_kit.rb
+- lib/provider_kit/attribute.rb
 - lib/provider_kit/buildable.rb
 - lib/provider_kit/callbacks.rb
 - lib/provider_kit/capability.rb
@@ -169,6 +170,7 @@ files:
 - lib/provider_kit/json_client.rb
 - lib/provider_kit/json_request.rb
 - lib/provider_kit/logging.rb
+- lib/provider_kit/null_provider.rb
 - lib/provider_kit/provideable.rb
 - lib/provider_kit/provider.rb
 - lib/provider_kit/provider_attribute.rb