camille 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 901863ce3680f14f101ac00cac0ef9f6b64b84413f483e52e90583149eb54d80
-  data.tar.gz: 309265868f68ea69fa5b5b3af60d43813ec8f8602abb8fc8f49c089c7c94fea1
+  metadata.gz: a6293de3ef709101a5410b308f140bd654e38e81905eefff034eaff831da03d7
+  data.tar.gz: d8224fc21dd1c63e7f5a93a65ff6452d841da44c12ef7eccb2a9b713d34211cb
 SHA512:
-  metadata.gz: e6f3f740d1bbdd532760262e74594e19853b51950c47c9222bea76264b0bf6b4a6839cc0963a3b70778203f34ee867a5c77aa1685232719490c1a47ec939de39
-  data.tar.gz: 79655aa7f4adf210cd0884655f445e9d094f218624fd2be62fedea30e6a5a82fc900a222a4337d28c88c46034ef264d8cfdfb0b01f985a25d83068962f4807ae
+  metadata.gz: ca46b44d6ee87b156d066e1d9e3736fb74b9c0b1ed2df4634a62bbc879fc23aaa9fb42b4dd6857eda5a47a4968fe8c157b384044da1cda65fd20a45b4071bbc2
+  data.tar.gz: 1e52c60928f864586e7361ec0a63419d6763f3f8b6339395157750ffd78a2cd672179aa9028d83db26be79351e68625243c052c6001b1f07f3acac6dc4fbb728

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.6.0
+
+### Added
+
+* Added `response.data` test helper (require `'camille/testing'`). Validates the response body against the endpoint's response type and returns the snake_case body as a `HashWithIndifferentAccess`. Works with RSpec and Minitest integration / request tests.
+
 ## 1.5.0
 
 ### Fixed

data/CLAUDE.md

@@ -0,0 +1,3 @@
+# Testing
+
+Run the test suite with `bundle exec rake` (not `bundle exec rspec` directly).

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    camille (1.4.0)
+    camille (1.6.0)
       rails (>= 6.1, < 8.1)
 
 GEM

data/README.md

@@ -263,6 +263,25 @@ object:
 
 Everything in `config/camille/types` and `config/camille/schemas` will automatically reload after changes in development environment, just like other files in Rails.
 
+### Test helper
+
+Camille ships an optional `response.data` helper for Rails integration / request tests. It looks up the endpoint from the current request, validates `response.parsed_body` against the endpoint's response type, and returns the snake_case body as a `HashWithIndifferentAccess` so you can use either string or symbol keys in assertions.
+
+In your `rails_helper.rb` (RSpec) or `test_helper.rb` (Minitest):
+
+```ruby
+require 'camille/testing'
+```
+
+Then in a test:
+
+```ruby
+get '/products/data'
+expect(response.data[:product][:available_stock]).to eq(1)
+```
+
+If the response body fails the type check the helper raises `Camille::Testing::ResponseTypeError`. If the route has no Camille endpoint it raises `Camille::Testing::MissingEndpointError`.
+
 ## Versioning
 
 This project uses [Semantic Versioning](https://semver.org/).

data/lib/camille/testing.rb

@@ -0,0 +1,51 @@
+require 'action_dispatch'
+
+module Camille
+  module Testing
+    class ResponseTypeError < ::StandardError; end
+    class MissingEndpointError < ::StandardError; end
+
+    module ResponseExtension
+      def data
+        controller_path = request && request.path_parameters[:controller]
+        action          = request && request.path_parameters[:action]
+
+        unless controller_path && action
+          raise Camille::Testing::MissingEndpointError,
+            "No camille endpoint for this response (request did not match a controller action)."
+        end
+
+        controller_class_name = "#{controller_path.camelize}Controller"
+        schema   = Camille::Loader.controller_name_to_schema_map[controller_class_name]
+        endpoint = schema && schema.endpoints[action.to_sym]
+
+        unless endpoint
+          raise Camille::Testing::MissingEndpointError,
+            "No camille endpoint for #{controller_class_name}##{action}."
+        end
+
+        result = endpoint.response_type.check_params(parsed_body)
+        if result.type_error?
+          io = StringIO.new
+          Camille::TypeErrorPrinter.new(result).print(io)
+          raise Camille::Testing::ResponseTypeError,
+            "\nResponse type check failed.\n#{io.string}"
+        end
+
+        deep_indifferent(result.value)
+      end
+
+      private
+
+      def deep_indifferent value
+        case value
+        when Hash  then value.with_indifferent_access
+        when Array then value.map { |v| deep_indifferent(v) }
+        else value
+        end
+      end
+    end
+  end
+end
+
+ActionDispatch::TestResponse.prepend(Camille::Testing::ResponseExtension)

data/lib/camille/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Camille
-  VERSION = "1.5.0"
+  VERSION = "1.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: camille
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - merely
@@ -38,6 +38,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - CHANGELOG.md
+- CLAUDE.md
 - Gemfile
 - Gemfile.lock
 - README.md
@@ -79,6 +80,7 @@ files:
 - lib/camille/schema_literal_generator.rb
 - lib/camille/schemas.rb
 - lib/camille/syntax.rb
+- lib/camille/testing.rb
 - lib/camille/type.rb
 - lib/camille/type_error.rb
 - lib/camille/type_error_printer.rb