spec_forge 0.6.0 → 0.7.1

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spec_forge
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Bryan
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-24 00:00:00.000000000 Z
+date: 2025-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: factory_bot
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: openapi3_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -122,6 +136,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: sem_version
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -136,6 +164,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
 description: Write API tests in YAML without sacrificing power. SpecForge combines
   RSpec's matcher system, Faker's data generation, and factory patterns into a clean,
   declarative syntax that eliminates boilerplate while preserving control over your
@@ -179,9 +221,12 @@ files:
 - lib/spec_forge/cli.rb
 - lib/spec_forge/cli/actions.rb
 - lib/spec_forge/cli/command.rb
+- lib/spec_forge/cli/docs.rb
+- lib/spec_forge/cli/docs/generate.rb
 - lib/spec_forge/cli/init.rb
 - lib/spec_forge/cli/new.rb
 - lib/spec_forge/cli/run.rb
+- lib/spec_forge/cli/serve.rb
 - lib/spec_forge/configuration.rb
 - lib/spec_forge/context.rb
 - lib/spec_forge/context/callbacks.rb
@@ -189,7 +234,32 @@ files:
 - lib/spec_forge/context/store.rb
 - lib/spec_forge/context/variables.rb
 - lib/spec_forge/core_ext.rb
+- lib/spec_forge/core_ext/array.rb
 - lib/spec_forge/core_ext/rspec.rb
+- lib/spec_forge/documentation.rb
+- lib/spec_forge/documentation/builder.rb
+- lib/spec_forge/documentation/document.rb
+- lib/spec_forge/documentation/document/operation.rb
+- lib/spec_forge/documentation/document/parameter.rb
+- lib/spec_forge/documentation/document/request_body.rb
+- lib/spec_forge/documentation/document/response.rb
+- lib/spec_forge/documentation/document/response_body.rb
+- lib/spec_forge/documentation/generators.rb
+- lib/spec_forge/documentation/generators/base.rb
+- lib/spec_forge/documentation/generators/openapi.rb
+- lib/spec_forge/documentation/generators/openapi/base.rb
+- lib/spec_forge/documentation/generators/openapi/error_formatter.rb
+- lib/spec_forge/documentation/generators/openapi/v3_0.rb
+- lib/spec_forge/documentation/loader.rb
+- lib/spec_forge/documentation/loader/cache.rb
+- lib/spec_forge/documentation/openapi.rb
+- lib/spec_forge/documentation/openapi/base.rb
+- lib/spec_forge/documentation/openapi/v3_0/example.rb
+- lib/spec_forge/documentation/openapi/v3_0/media_type.rb
+- lib/spec_forge/documentation/openapi/v3_0/operation.rb
+- lib/spec_forge/documentation/openapi/v3_0/response.rb
+- lib/spec_forge/documentation/openapi/v3_0/schema.rb
+- lib/spec_forge/documentation/openapi/v3_0/tag.rb
 - lib/spec_forge/error.rb
 - lib/spec_forge/factory.rb
 - lib/spec_forge/filter.rb
@@ -202,14 +272,19 @@ files:
 - lib/spec_forge/loader.rb
 - lib/spec_forge/matchers.rb
 - lib/spec_forge/normalizer.rb
-- lib/spec_forge/normalizer/configuration.rb
-- lib/spec_forge/normalizer/constraint.rb
-- lib/spec_forge/normalizer/expectation.rb
-- lib/spec_forge/normalizer/factory.rb
-- lib/spec_forge/normalizer/factory_reference.rb
-- lib/spec_forge/normalizer/global_context.rb
-- lib/spec_forge/normalizer/spec.rb
+- lib/spec_forge/normalizer/default.rb
+- lib/spec_forge/normalizer/definition.rb
+- lib/spec_forge/normalizer/validators.rb
+- lib/spec_forge/normalizers/_shared.yml
+- lib/spec_forge/normalizers/configuration.yml
+- lib/spec_forge/normalizers/constraint.yml
+- lib/spec_forge/normalizers/expectation.yml
+- lib/spec_forge/normalizers/factory.yml
+- lib/spec_forge/normalizers/factory_reference.yml
+- lib/spec_forge/normalizers/global_context.yml
+- lib/spec_forge/normalizers/spec.yml
 - lib/spec_forge/runner.rb
+- lib/spec_forge/runner/adapter.rb
 - lib/spec_forge/runner/callbacks.rb
 - lib/spec_forge/runner/debug_proxy.rb
 - lib/spec_forge/runner/listener.rb
@@ -220,9 +295,12 @@ files:
 - lib/spec_forge/spec/expectation/constraint.rb
 - lib/spec_forge/type.rb
 - lib/spec_forge/version.rb
-- lib/templates/forge_helper.tt
-- lib/templates/new_factory.tt
-- lib/templates/new_spec.tt
+- lib/templates/forge_helper.rb.tt
+- lib/templates/new_factory.yml.tt
+- lib/templates/new_spec.yml.tt
+- lib/templates/openapi.yml.tt
+- lib/templates/redoc.html.tt
+- lib/templates/swagger.html.tt
 homepage: https://github.com/itsthedevman/spec_forge
 licenses:
 - MIT

data/lib/spec_forge/normalizer/configuration.rb

@@ -1,90 +0,0 @@
-# frozen_string_literal: true
-
-module SpecForge
-  class Normalizer
-    #
-    # Normalizes configuration hash structure for SpecForge
-    #
-    # Ensures that the global configuration has the correct structure
-    # and default values for all required settings.
-    #
-    class Configuration < Normalizer
-      #
-      # Defines the normalized structure for configuration validation
-      #
-      # Specifies validation rules for configuration attributes:
-      # - Enforces specific data types
-      # - Provides default values
-      # - Supports alternative key names
-      #
-      # @return [Hash] Configuration attribute validation rules
-      #
-      STRUCTURE = {
-        base_url: SHARED_ATTRIBUTES[:base_url].except(:default), # Make it required
-        headers: SHARED_ATTRIBUTES[:headers],
-        query: SHARED_ATTRIBUTES[:query],
-        factories: {
-          type: Hash,
-          default: {},
-          structure: {
-            auto_discover: {
-              type: [TrueClass, FalseClass],
-              default: true
-            },
-            paths: {
-              type: Array,
-              default: []
-            }
-          }
-        },
-        on_debug: {
-          type: Proc
-        }
-      }.freeze
-    end
-
-    # On Normalizer
-    class << self
-      #
-      # Generates an empty configuration hash
-      #
-      # @return [Hash] Default configuration hash
-      #
-      def default_configuration
-        Configuration.default
-      end
-
-      #
-      # Normalizes a configuration hash with validation
-      #
-      # @param input [Hash] The hash to normalize
-      #
-      # @return [Hash] A normalized hash with defaults applied
-      #
-      # @raise [Error::InvalidStructureError] If validation fails
-      #
-      def normalize_configuration!(input)
-        raise_errors! do
-          normalize_configuration(input)
-        end
-      end
-
-      #
-      # Normalize a configuration hash
-      #
-      # @param configuration [Hash] Configuration hash
-      #
-      # @return [Array] [normalized_hash, errors]
-      #
-      # @private
-      #
-      def normalize_configuration(configuration)
-        if !Type.hash?(configuration)
-          raise Error::InvalidTypeError.new(configuration, Hash, for: "configuration")
-        end
-
-        Normalizer::Configuration.new("configuration", configuration).normalize
-      end
-    end
-  end
-end

data/lib/spec_forge/normalizer/constraint.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-module SpecForge
-  class Normalizer
-    #
-    # Normalizes constraint hash structure for expectations
-    #
-    # Ensures that expectation constraints (status, json, etc.)
-    # have the correct structure and defaults.
-    #
-    class Constraint < Normalizer
-      #
-      # Defines the normalized structure for configuration validation
-      #
-      # Specifies validation rules for configuration attributes:
-      # - Enforces specific data types
-      # - Provides default values
-      # - Supports alternative key names
-      #
-      # @return [Hash] Configuration attribute validation rules
-      #
-      STRUCTURE = {
-        status: {
-          type: [Integer, String]
-        },
-        json: {
-          type: [Hash, Array],
-          default: {}
-        }
-      }.freeze
-    end
-
-    # On Normalizer
-    class << self
-      #
-      # Generates an empty constraint hash
-      #
-      # @return [Hash] Default constraint hash
-      #
-      def default_constraint
-        Constraint.default
-      end
-
-      #
-      # Normalize a constraint hash
-      #
-      # @param constraint [Hash] Constraint hash
-      #
-      # @return [Array] [normalized_hash, errors]
-      #
-      # @private
-      #
-      def normalize_constraint(constraint)
-        raise Error::InvalidTypeError.new(constraint, Hash, for: "expect") unless Type.hash?(constraint)
-
-        Normalizer::Constraint.new("expect", constraint).normalize
-      end
-    end
-  end
-end

data/lib/spec_forge/normalizer/expectation.rb

@@ -1,105 +0,0 @@
-# frozen_string_literal: true
-
-module SpecForge
-  class Normalizer
-    #
-    # Normalizes expectation hash structure
-    #
-    # Ensures that expectation definitions have the correct structure
-    # and default values for all required settings.
-    #
-    class Expectation < Normalizer
-      #
-      # Defines the normalized structure for configuration validation
-      #
-      # Specifies validation rules for configuration attributes:
-      # - Enforces specific data types
-      # - Provides default values
-      # - Supports alternative key names
-      #
-      # @return [Hash] Configuration attribute validation rules
-      #
-      STRUCTURE = {
-        # Internal
-        id: Normalizer::SHARED_ATTRIBUTES[:id],
-        line_number: Normalizer::SHARED_ATTRIBUTES[:line_number],
-
-        # User defined
-        name: Normalizer::SHARED_ATTRIBUTES[:name],
-        base_url: Normalizer::SHARED_ATTRIBUTES[:base_url],
-        url: Normalizer::SHARED_ATTRIBUTES[:url],
-        http_verb: Normalizer::SHARED_ATTRIBUTES[:http_verb],
-        headers: Normalizer::SHARED_ATTRIBUTES[:headers],
-        query: Normalizer::SHARED_ATTRIBUTES[:query],
-        body: Normalizer::SHARED_ATTRIBUTES[:body],
-        variables: Normalizer::SHARED_ATTRIBUTES[:variables],
-        debug: Normalizer::SHARED_ATTRIBUTES[:debug],
-        store_as: {type: String, default: ""},
-        expect: {type: Hash}
-      }.freeze
-    end
-
-    # On Normalizer
-    class << self
-      #
-      # Generates an empty expectation hash
-      #
-      # @return [Hash] Default expectation hash
-      #
-      def default_expectation
-        Expectation.default
-      end
-
-      #
-      # Normalize an array of expectation hashes
-      #
-      # @param input [Array<Hash>] The array to normalize
-      #
-      # @return [Array<Hash>] Normalized array of expectation hashes
-      #
-      # @raise [Error::InvalidStructureError] If validation fails
-      #
-      def normalize_expectations!(input)
-        raise_errors! do
-          normalize_expectations(input)
-        end
-      end
-
-      #
-      # Normalize an array of expectation hashes
-      #
-      # @param expectations [Array<Hash>] Array of expectation hashes
-      #
-      # @return [Array] [normalized_array, errors]
-      #
-      # @private
-      #
-      def normalize_expectations(expectations)
-        if !Type.array?(expectations)
-          raise Error::InvalidTypeError.new(expectations, Array, for: "\"expectations\" on spec")
-        end
-
-        final_errors = Set.new
-        final_output = expectations.map.with_index do |expectation, index|
-          normalizer = Normalizer::Expectation.new("expectation (item #{index})", expectation)
-          output, errors = normalizer.normalize
-
-          # If expect is not provided, skip the constraints
-          if (constraint = expectation[:expect])
-            constraint_output, constraint_errors = Normalizer::Constraint.new(
-              "expect (item #{index})", constraint
-            ).normalize
-
-            output[:expect] = constraint_output
-            errors.merge(constraint_errors) if constraint_errors.size > 0
-          end
-
-          final_errors.merge(errors) if errors.size > 0
-          output
-        end
-
-        [final_output, final_errors]
-      end
-    end
-  end
-end

data/lib/spec_forge/normalizer/factory.rb

@@ -1,78 +0,0 @@
-# frozen_string_literal: true
-
-module SpecForge
-  class Normalizer
-    #
-    # Normalizes factory hash structure
-    #
-    # Ensures that factory definitions have the correct structure
-    # and default values for all required settings.
-    #
-    class Factory < Normalizer
-      #
-      # Defines the normalized structure for configuration validation
-      #
-      # Specifies validation rules for configuration attributes:
-      # - Enforces specific data types
-      # - Provides default values
-      # - Supports alternative key names
-      #
-      # @return [Hash] Configuration attribute validation rules
-      #
-      STRUCTURE = {
-        model_class: {
-          type: String,
-          aliases: %i[class],
-          default: ""
-        },
-        variables: Normalizer::SHARED_ATTRIBUTES[:variables],
-        attributes: {
-          type: Hash,
-          default: {}
-        }
-      }.freeze
-    end
-
-    # On Normalizer
-    class << self
-      #
-      # Generates an empty factory hash
-      #
-      # @return [Hash] Default factory hash
-      #
-      def default_factory
-        Factory.default
-      end
-
-      #
-      # Normalizes a factory hash with validation
-      #
-      # @param input [Hash] The hash to normalize
-      #
-      # @return [Hash] A normalized hash with defaults applied
-      #
-      # @raise [Error::InvalidStructureError] If validation fails
-      #
-      def normalize_factory!(input)
-        raise_errors! do
-          normalize_factory(input)
-        end
-      end
-
-      #
-      # Normalize a factory hash
-      #
-      # @param factory [Hash] Factory hash
-      #
-      # @return [Array] [normalized_hash, errors]
-      #
-      # @private
-      #
-      def normalize_factory(factory)
-        raise Error::InvalidTypeError.new(factory, Hash, for: "factory") unless Type.hash?(factory)
-
-        Normalizer::Factory.new("factory", factory).normalize
-      end
-    end
-  end
-end

data/lib/spec_forge/normalizer/factory_reference.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-module SpecForge
-  class Normalizer
-    #
-    # Normalizes factory reference hash structure
-    #
-    # Ensures that factory references have the correct structure
-    # and default values for all required settings.
-    #
-    class FactoryReference < Normalizer
-      #
-      # Defines the normalized structure for configuration validation
-      #
-      # Specifies validation rules for configuration attributes:
-      # - Enforces specific data types
-      # - Provides default values
-      # - Supports alternative key names
-      #
-      # @return [Hash] Configuration attribute validation rules
-      #
-      STRUCTURE = {
-        attributes: {
-          type: Hash,
-          default: {}
-        },
-        build_strategy: {
-          type: String,
-          aliases: %i[strategy],
-          default: "create"
-        },
-        size: {
-          type: Integer,
-          aliases: %i[count],
-          default: 0
-        }
-      }.freeze
-    end
-
-    # On Normalizer
-    class << self
-      #
-      # Generates an empty factory reference hash
-      #
-      # @return [Hash] Default factory reference hash
-      #
-      def default_factory_reference
-        FactoryReference.default
-      end
-
-      #
-      # Normalizes a factory reference hash with validation
-      #
-      # @param input [Hash] The hash to normalize
-      #
-      # @return [Hash] A normalized hash with defaults applied
-      #
-      # @raise [Error::InvalidStructureError] If validation fails
-      #
-      def normalize_factory_reference!(input, **)
-        raise_errors! do
-          normalize_factory_reference(input, **)
-        end
-      end
-
-      #
-      # Normalize a factory reference hash
-      #
-      # @param factory [Hash] Factory reference hash
-      # @param label [String] Label for error messages
-      #
-      # @return [Array] [normalized_hash, errors]
-      #
-      # @private
-      #
-      def normalize_factory_reference(factory, label: "factory reference")
-        if !Type.hash?(factory)
-          raise Error::InvalidTypeError.new(factory, Hash, for: "factory reference")
-        end
-
-        Normalizer::FactoryReference.new(label, factory).normalize
-      end
-    end
-  end
-end

data/lib/spec_forge/normalizer/global_context.rb

@@ -1,88 +0,0 @@
-# frozen_string_literal: true
-
-module SpecForge
-  class Normalizer
-    #
-    # Normalizes global context hash structure
-    #
-    # Ensures that global context definitions have the correct structure
-    # and default values for all required settings.
-    #
-    class GlobalContext < Normalizer
-      #
-      # Defines the normalized structure for configuration validation
-      #
-      # Specifies validation rules for configuration attributes:
-      # - Enforces specific data types
-      # - Provides default values
-      # - Supports alternative key names
-      #
-      # @return [Hash] Configuration attribute validation rules
-      #
-      STRUCTURE = {
-        variables: Normalizer::SHARED_ATTRIBUTES[:variables],
-        callbacks: {
-          type: Array,
-          default: [],
-          structure: {
-            type: Hash,
-            default: {},
-            structure: {
-              before_file: Normalizer::SHARED_ATTRIBUTES[:callback],
-              before_spec: Normalizer::SHARED_ATTRIBUTES[:callback],
-              before_each: Normalizer::SHARED_ATTRIBUTES[:callback].merge(aliases: %i[before]),
-              around_each: Normalizer::SHARED_ATTRIBUTES[:callback].merge(aliases: %i[around]),
-              after_each: Normalizer::SHARED_ATTRIBUTES[:callback].merge(aliases: %i[after]),
-              after_spec: Normalizer::SHARED_ATTRIBUTES[:callback],
-              after_file: Normalizer::SHARED_ATTRIBUTES[:callback]
-            }
-          }
-        }
-      }.freeze
-    end
-
-    # On Normalizer
-    class << self
-      #
-      # Generates an empty global context hash
-      #
-      # @return [Hash] Default global context hash
-      #
-      def default_global_context
-        GlobalContext.default
-      end
-
-      #
-      # Normalizes a global context hash with validation
-      #
-      # @param input [Hash] The hash to normalize
-      #
-      # @return [Hash] A normalized hash with defaults applied
-      #
-      # @raise [Error::InvalidStructureError] If validation fails
-      #
-      def normalize_global_context!(input)
-        raise_errors! do
-          normalize_global_context(input)
-        end
-      end
-
-      #
-      # Normalize a global context hash
-      #
-      # @param global [Hash] Global context hash
-      #
-      # @return [Array] [normalized_hash, errors]
-      #
-      # @private
-      #
-      def normalize_global_context(global)
-        if !Type.hash?(global)
-          raise Error::InvalidTypeError.new(global, Hash, for: "global context")
-        end
-
-        Normalizer::GlobalContext.new("global context", global).normalize
-      end
-    end
-  end
-end