resteze 0.3.0 → 0.4.0

data/lib/resteze/client.rb

@@ -1,6 +1,7 @@
 module Resteze
   class Client
     include Resteze::ApiModule
+    prepend Resteze::Instrumentation
 
     def self.user_agent
       [

data/lib/resteze/instrumentation.rb

@@ -0,0 +1,14 @@
+module Resteze
+  module Instrumentation
+    def execute_request(method, path, ...)
+      payload = { method: method, path: path, api_module: api_module.name }
+
+      ActiveSupport::Notifications.instrument("request.#{api_module::INSTRUMENTATION_KEY}", payload) do
+        super.tap do |response|
+          payload[:status]     = response.http_status
+          payload[:request_id] = response.request_id
+        end
+      end
+    end
+  end
+end

data/lib/resteze/testing/minitest/configuration.rb

@@ -0,0 +1,18 @@
+module Resteze
+  module Testing
+    module Configuration
+      extend ActiveSupport::Concern
+
+      # Assert that a config property is supported and can be assigned
+      def assert_config_property(property, value = nil, subject: nil)
+        subject ||= (defined?(@subject) && @subject) || subject()
+        original_value = subject.send(property)
+
+        assert_equal value, subject.send(property), "config property #{property} value did not match expectation"
+      ensure
+        # Make sure to set the original value at the end
+        subject.send("#{property}=", original_value)
+      end
+    end
+  end
+end

data/lib/resteze/testing/minitest/object.rb

@@ -0,0 +1,58 @@
+module Resteze
+  module Testing
+    module Minitest
+      module Object
+        include ActiveSupport::Concern
+
+        private
+
+        # rubocop:disable Metrics/AbcSize
+        # rubocop:disable Naming/PredicatePrefix
+        def has_property(name, **options)
+          assert subject.property?(name.to_sym), "Expected #{subject} to have property: #{name}"
+          assert_property_default(name, options[:default]) if options.key?(:default)
+          assert_property_translation(name, options[:from]) if options.key?(:from)
+          assert_property_transformed(name, transformed: options[:transformed]) if options.key?(:transformed)
+          assert_property_required(name, required: options[:required]) if options.key?(:required)
+        end
+        # rubocop:enable Metrics/AbcSize
+        # rubocop:enable Naming/PredicatePrefix
+
+        def assert_property_transformed(name, transformed: true)
+          translation = subject.translations_hash.dig(subject.translations.key(name.to_sym), name.to_sym)
+          transformation_defined = translation.is_a?(Proc) || subject.transformation_exists?(name.to_sym)
+
+          if transformed
+            assert transformation_defined, "Expected #{subject} to transform property: #{name}"
+          else
+            refute transformation_defined, "Expected #{subject} not to transform property: #{name}"
+          end
+        end
+
+        def assert_property_required(name, required: true)
+          if required
+            assert subject.required?(name.to_sym), "Expected #{subject} to require property: #{name}"
+          else
+            refute subject.required?(name.to_sym), "Expected #{subject} not to require property: #{name}"
+          end
+        end
+
+        def assert_property_translation(name, from)
+          assert_equal(
+            from.to_sym,
+            subject.translations.key(name.to_sym),
+            "Expected #{subject} to map property #{name} from #{from}"
+          )
+        end
+
+        def assert_property_default(name, default)
+          assert_equal(
+            default,
+            subject.defaults[name.to_sym],
+            "Expected #{subject} to have default for property #{name}"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/resteze/testing/minitest.rb

@@ -0,0 +1,10 @@
+require_relative "minitest/configuration"
+require_relative "minitest/object"
+
+module Resteze
+  module Testing
+    module Minitest
+      # Namespace for Minitest-specific testing helpers
+    end
+  end
+end

data/lib/resteze/testing/rspec/configure.rb

@@ -0,0 +1,16 @@
+module Resteze
+  module Testing
+    module Configuration
+      # Assert that a config property is supported and can be assigned
+      def assert_config_property(property, value = nil, subject: nil)
+        subject ||= (defined?(@subject) && @subject) || self.subject
+        original_value = subject.send(property)
+
+        expect(subject.send(property)).to eq(value), "config property #{property} value did not match expectation"
+      ensure
+        # Make sure to set the original value at the end
+        subject.send("#{property}=", original_value)
+      end
+    end
+  end
+end

data/lib/resteze/testing/rspec/object.rb

@@ -0,0 +1,49 @@
+module Resteze
+  module Testing
+    module RSpec
+      module Object
+        extend RSpec::Matchers
+
+        # rubocop:disable Metrics/AbcSize
+        # rubocop:disable Naming/PredicatePrefix
+        def has_property(name, **options)
+          expect(subject.property?(name.to_sym)).to be(true), "Expected #{subject} to have property: #{name}"
+          assert_property_default(name, options[:default]) if options.key?(:default)
+          assert_property_translation(name, options[:from]) if options.key?(:from)
+          assert_property_transformed(name, transformed: options[:transformed]) if options.key?(:transformed)
+          assert_property_required(name, required: options[:required]) if options.key?(:required)
+        end
+        # rubocop:enable Naming/PredicatePrefix
+
+        def assert_property_transformed(name, transformed: true)
+          translation = subject.translations_hash.dig(subject.translations.key(name.to_sym), name.to_sym)
+          transformation_defined = translation.is_a?(Proc) || subject.transformation_exists?(name.to_sym)
+
+          if transformed
+            expect(transformation_defined).to be(true), "Expected #{subject} to transform property: #{name}"
+          else
+            expect(transformation_defined).to be(false), "Expected #{subject} not to transform property: #{name}"
+          end
+        end
+        # rubocop:enable Metrics/AbcSize
+
+        def assert_property_required(name, required: true)
+          if required
+            expect(subject.required?(name.to_sym)).to be(true), "Expected #{subject} to require property: #{name}"
+          else
+            expect(subject.required?(name.to_sym)).to be(false), "Expected #{subject} not to require property: #{name}"
+          end
+        end
+
+        def assert_property_translation(name, from)
+          expect(subject.translations.key(name.to_sym)).to eq(from.to_sym),
+                                                           "Expected #{subject} to map property #{name} from #{from}"
+        end
+
+        def assert_property_default(name, default)
+          expect(subject.defaults[name.to_sym]).to eq(default), "Expected #{subject} to have default for property #{name}"
+        end
+      end
+    end
+  end
+end

data/lib/resteze/testing/rspec.rb

@@ -0,0 +1,10 @@
+require_relative "rspec/configure"
+require_relative "rspec/object"
+
+module Resteze
+  module Testing
+    module RSpec
+      # Namespace for RSpec-specific testing helpers
+    end
+  end
+end

data/lib/resteze/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resteze
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/resteze.rb

@@ -18,6 +18,7 @@ require "resteze/save"
 require "resteze/object"
 
 # API Classes
+require "resteze/instrumentation"
 require "resteze/client"
 require "resteze/errors"
 require "resteze/list_object"
@@ -79,6 +80,7 @@ module Resteze
     end
 
     # Setup magic constants
+    const_set :INSTRUMENTATION_KEY, name.underscore.tr("/", "_") unless const_defined?("#{self}::INSTRUMENTATION_KEY")
     const_set :Object,      Class.new(Resteze::Object)
     const_set :Client,      Class.new(Resteze::Client)
     const_set :Response,    Class.new(Resteze::Response)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: resteze
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - JD Hendrickson
 bindir: bin
 cert_chain: []
-date: 2025-08-12 00:00:00.000000000 Z
+date: 2026-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -75,17 +75,25 @@ files:
 - ".rubocop"
 - ".rubocop.yml"
 - ".ruby-version"
+- CHANGELOG.md
+- CLAUDE.md
 - Guardfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - assets/resteze.png
 - assets/resteze.svg
+- docs/ADVANCED_USAGE.md
+- docs/API.md
+- docs/CONFIGURATION.md
+- docs/ERROR_HANDLING.md
+- docs/TESTING.md
 - lib/resteze.rb
 - lib/resteze/api_module.rb
 - lib/resteze/api_resource.rb
 - lib/resteze/client.rb
 - lib/resteze/errors.rb
+- lib/resteze/instrumentation.rb
 - lib/resteze/list.rb
 - lib/resteze/list_object.rb
 - lib/resteze/middleware/raise_error.rb
@@ -93,6 +101,12 @@ files:
 - lib/resteze/request.rb
 - lib/resteze/response.rb
 - lib/resteze/save.rb
+- lib/resteze/testing/minitest.rb
+- lib/resteze/testing/minitest/configuration.rb
+- lib/resteze/testing/minitest/object.rb
+- lib/resteze/testing/rspec.rb
+- lib/resteze/testing/rspec/configure.rb
+- lib/resteze/testing/rspec/object.rb
 - lib/resteze/util.rb
 - lib/resteze/version.rb
 - sig/resteze.rbs