spec_forge 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 658fd0830ce9179c1fe7ea880e2ed8196ccbc47bc8b244f6fc40c458ca900cca
-  data.tar.gz: 3658379f52f23ffa362ded1c50b28e052911b6602ac3a3bed02b1fd9c8ee334c
+  metadata.gz: 6b2d5790d4797a63b8fbad4dd296b9c9beb657b30a98bda5fab8ca7c635abd5a
+  data.tar.gz: b22a8f664dd676846e703f5312383c9c9b1b9cabab52b2cc3c8a8d28830490c0
 SHA512:
-  metadata.gz: ebcdfd4e02d965049cabd1a18b7897665800dc8081149aa4554433e7083296f0121d76f4ec474b527fdd8df0da1c71170c9c10c5cff1a108f8704b7f14e7104f
-  data.tar.gz: ad3b84d27b9e7ab62dc902ad2a5d41a77670286aaba9a635ccebf5735061fa725e8d46daf62fd75562a35688d62b3dc595a597b9e38ec965f5273fdc27a2aabb
+  metadata.gz: 858e7dfd4546bc34e7dd8f899d99b5cf03d26cfbe9042f238de44566e2981a82bcd06803a0319f6d937d7c509dc3c02e8a962415c8e6fbb8e3c515c693c5e176
+  data.tar.gz: 3b246fda2d4bbbc5ce12fa0f683e27e1cb0e2950fe3b7c03b978f6d88662d1b65b0037b00931fe598415ee3d3c8477f7f76fd3f523547e061f86ac000e617d52

data/.standard.yml

@@ -1,3 +1,7 @@
 # For available configuration options, see:
 #   https://github.com/standardrb/standard
 ruby_version: 3.3
+ignore:
+- ".direnv/**/*"
+- "vendor/**/*"
+- "spec/integration/vendor/**/*"

data/CHANGELOG.md

@@ -5,6 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+<!--
 ## [Unreleased]
 
 ### Added
@@ -12,6 +13,148 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 ### Removed
+-->
+
+## [Unreleased]
+
+### Added
+
+- Added new context system for managing shared state between tests
+  - Introduced `SpecForge.context` global accessor for accessing test context
+  - Created `Context` class with modular components:
+    - `Context::Global` for file-level shared variables
+    - `Context::Variables` for managing variables with overlay support
+    - `Context::Store` for storing the results of the tests
+- Added support for defining and referencing global variables
+  ```yaml
+  global:
+    variables:
+      api_version: "v2"
+      environment: "test"
+
+  index_user:
+    path: "/{api_version}/users"
+    query:
+      api_version: "global.variables.api_version"
+  ```
+- Added compound matcher support via `matcher.and` for combining multiple matchers
+  ```yaml
+  email:
+    matcher.and:
+    - kind_of.string
+    - /@/
+    - matcher.end_with: ".com"
+  ```
+- Added custom RSpec matcher `have_size` for checking an object's size via `matcher.have_size`
+- Added new `Loader` class for improved spec file processing
+- Added new `Filter` class for more flexible test filtering
+- Added normalizer for global context validation
+- Added line number tracking for specs and expectations
+- Added support for defining and referencing callbacks
+  ```ruby
+  # Configuration level
+  SpecForge.configure do |config|
+    config.register_callback("callback_name") { |context| }
+    # These are aliases
+    # config.define_callback("callback_name") { |context| }
+    # config.callback("callback_name") { |context| }
+  end
+
+  # Module level (no aliases)
+  SpecForge.register_callback("callback_name") { |context| }
+  ```
+  Once defined, callbacks can be referenced in spec files via the global context
+  ```yaml
+  global:
+    callbacks:
+    - before: callback_name
+      after: cleanup_database_state
+  ```
+- Added support for storing and retrieving test data via the `store_as` directive and `store` attribute
+  ```yaml
+  create_user:
+    path: "/users"
+    method: "post"
+    expectations:
+    - variables:
+        name: "John"
+        email: "john@example.com"
+      store_as: "created_user"
+      expect:
+        status: 200
+
+  show_user:
+    path: "/users/:id"
+    query:
+      id: store.created_user.response.id
+    - expect:
+        status: 200
+  ```
+- Added `UndefinedMatcherError` for clearer error messaging when invalid matchers are used
+- Enhanced debugging capabilities with improved DebugProxy methods and store access
+- Added HTTP status descriptions for better error messages
+- Added support for string values in `query`, `body`, and `variables` attributes
+- Added print statement when filtering tests for better visibility
+
+### Changed
+
+- Renamed `SpecForge.forge` to `SpecForge.forge_path`
+- Renamed attribute `http_method` to `http_verb` (`http_method` is now an alias)
+- Refactored attribute resolution methods:
+  - Renamed `Attribute#resolve` to `#resolved` (memoized version)
+  - Renamed `Attribute#resolve_value` to `#resolve` (immediate resolution)
+  - Added `Attribute#resolve_as_matcher` for resolving attributes into RSpec matchers
+- Refactored variable resolution to use the new context system
+- Updated `Runner` to properly initialize and manage context between tests
+- Improved error messages with more contextual information about the execution environment
+- Updated YARD comments with better API descriptions and examples
+- Restructured internal architecture for better separation of concerns
+- Moved all error classes under `SpecForge::Error`
+- Fixed issue where nesting expanded matchers (such as `matcher.include`) would cause an error
+- Improved response body validation for hash expectations:
+  - Each root-level key is now checked individually for more precise error messages
+  - Nested hashes still use the `include` matcher for flexibility
+- Adjusted `Attribute::Matcher` to accept either `matcher` or `matchers` namespace
+- Changed empty array matcher from using `contain_exactly` to `eq([])`
+- Changed empty hash matcher from using `include` to `eq({})`
+- Changed `forge_and` description from "matches all of:" to "match all:"
+- Improved error handling for chainable attributes with better descriptions for various object types
+- Limited error backtrace to 50 lines for cleaner output
+- Enhanced spec loading error messages with more detailed information
+- Improved RSpec example descriptions for better test output
+- Added support for overwriting headers at the request level
+
+## Removed
+
+- Removed `Configuration.overlay_options`
+
+## [0.5.0] - 12025-02-28
+
+### Added
+
+- Added support for testing array responses via `json`
+- Added check to block RSpec overwrites from running with internal tests
+- Added debugging access to `expected_json_class` variable.
+- Added support for FactoryBot list strategies through the new `size` attribute
+  ```yaml
+  variables:
+    users:
+      factory.user:
+        size: 10  # Creates 10 user records
+  ```
+  - All FactoryBot list methods now supported:
+    - `create_list` (default)
+    - `build_list`
+    - `build_stubbed_list`
+    - `attributes_for_list`
+    - `build_pair`
+    - `create_pair`
+  - Comprehensive documentation available in the [Factory Lists wiki](https://github.com/itsthedevman/spec_forge/wiki/Factory-Lists)
+
+### Changed
+
+- Updated `Constraint` to use `include` for testing Hashes and `contains_exactly` for testing Arrays
+- Better handling of positional and keyword argument passing for `Matcher` and `Faker` attributes
 
 ## [0.4.0] - 12025-02-22
 
@@ -88,7 +231,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial commit
 
-[unreleased]: https://github.com/itsthedevman/spec_forge/compare/v0.4.0...HEAD
+[unreleased]: https://github.com/itsthedevman/spec_forge/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/itsthedevman/spec_forge/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/itsthedevman/spec_forge/compare/v0.3.2...v0.4.0
 [0.3.2]: https://github.com/itsthedevman/spec_forge/compare/v0.3.0...v0.3.2
 [0.3.0]: https://github.com/itsthedevman/spec_forge/compare/v0.2.0...v0.3.0