openapi-ruby 3.0.0 → 3.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d33ec2601c1341f8afb455e3b2f0f1daa594aa96ddf3daebb8b6c6675a1f3723
-  data.tar.gz: 44827b7a0f446ed51c1de676b8e777437ccfe8408b7166b731f1b55842b96fb2
+  metadata.gz: c80ade10ad457a2ce7b09f51f788c9bad884da32e462071349a3a3cac7627573
+  data.tar.gz: f26291466286fe326b0aa0e4223d50e6e6f4864c85d0cfec10e0f53cde8689a9
 SHA512:
-  metadata.gz: 5d52dce6834c33e78cd9b8666291b35c289da0981eba2cadfad5c48b10d63a45c65a8d7e959dc09438ec64b9883e0a15ccea96af1c955892901096e0f1172075
-  data.tar.gz: 6c99f505c721c19bc5be989f4d6d0b0e4a5f7dfe794d688286040b89fd5146dc3aa73ef1c2fbe65fc418785644686bf4d65bf23c98185ddc5814e244f8d1b7b0
+  metadata.gz: d2fe17e3e72da93b6b50fef93dd2641f2814d1aaf964364d9cf324f1b9562336956b1706d264baf6515f1d9d8ceee07abf830f83c83117594adb5f2806313981
+  data.tar.gz: 61780c593073693c446d64f5088d495b0083c246989d5799f97b780945351a8f07aeee3e55d5cf1b87bc5c018e21bb4625029d108aed50a1172db9a54be09f5b

data/README.md

@@ -379,9 +379,9 @@ Generate OpenAPI spec files without running tests:
 rake openapi_ruby:generate
 ```
 
-This uses RSpec `--dry-run` (or loads Minitest files) to collect API definitions and write schemas. It auto-detects the test framework, or you can set `FRAMEWORK=rspec` or `FRAMEWORK=minitest`. Custom patterns: `PATTERN="packs/*/spec/**/*_spec.rb"`.
+This loads spec/test files to collect API definitions and writes schemas without running any tests. It auto-detects the test framework, or you can set `FRAMEWORK=rspec` or `FRAMEWORK=minitest`. Custom patterns: `PATTERN="packs/*/spec/**/*_spec.rb"`.
 
-Schemas are also generated automatically after running the full test suite via `after(:suite)` / `Minitest.after_run` hooks.
+Schemas are **only** written by the rake task — running tests (`bundle exec rspec`, `rails test`) does not generate or overwrite schema files. This prevents partial schema overwrites when running a subset of specs.
 
 ## Runtime Middleware
 

data/lib/openapi_ruby/components/loader.rb

@@ -63,7 +63,7 @@ module OpenapiRuby
           expanded = File.expand_path(path)
           next unless Dir.exist?(expanded)
 
-          Dir.glob(File.join(expanded, "**/")).each do |dir_path|
+          Dir.glob(File.join(expanded, "**/")).sort.each do |dir_path|
             relative = dir_path.sub("#{expanded}/", "").chomp("/")
             next if relative.empty?
 

data/lib/openapi_ruby/components/registry.rb

@@ -111,6 +111,9 @@ module OpenapiRuby
           end
           result.delete(type_key) if result[type_key].empty?
         end
+        # Sort component names alphabetically within each type for deterministic output
+        # regardless of file system ordering or load order.
+        result.each { |type_key, entries| result[type_key] = entries.sort_by { |k, _| k }.to_h }
         result
       end
     end

data/lib/openapi_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenapiRuby
-  VERSION = "3.0.0"
+  VERSION = "3.0.2"
 end

data/lib/tasks/openapi_ruby.rake

@@ -2,17 +2,18 @@
 
 namespace :openapi_ruby do
   desc "Generate OpenAPI schema files from spec definitions and components"
-  task generate: :environment do
+  task :generate do
     framework = ENV.fetch("FRAMEWORK", detect_test_framework).to_s
+    pattern = ENV.fetch("PATTERN", default_pattern_for(framework))
 
-    case framework
-    when "rspec"
-      generate_with_rspec
-    when "minitest"
-      generate_with_minitest
-    else
-      abort "Unknown test framework '#{framework}'. Set FRAMEWORK=rspec or FRAMEWORK=minitest."
-    end
+    # Spawn a subprocess so RAILS_ENV defaults to "test" cleanly,
+    # just like rswag did with RSpec::Core::RakeTask.
+    env = {"RAILS_ENV" => ENV.fetch("RAILS_ENV", "test")}
+    script = generate_script(framework, pattern)
+    command = "bundle exec ruby -e #{Shellwords.escape(script)}"
+
+    puts "Generating OpenAPI schemas (#{framework})..."
+    system(env, command) || abort("Schema generation failed")
   end
 end
 
@@ -26,43 +27,29 @@ def detect_test_framework
   end
 end
 
-def generate_with_rspec
-  pattern = ENV.fetch("PATTERN", "spec/**/*_spec.rb")
-  puts "Generating OpenAPI schemas (RSpec)..."
-
-  # Load rspec-core first — normally RSpec's runner does this before spec_helper,
-  # but since we're loading specs via require we need it explicitly.
-  require "rspec/core"
-
-  # Add spec/ to the load path so require "openapi_helper" / "rails_helper" works,
-  # matching what RSpec does when it runs.
-  $LOAD_PATH.unshift(File.expand_path("spec")) unless $LOAD_PATH.include?(File.expand_path("spec"))
-
-  # Load all spec files to trigger DSL context registrations.
-  # RSpec's describe/context blocks are evaluated at load time,
-  # so requiring the files registers paths and operations without
-  # running any tests. Spec files pull in RSpec and the openapi_ruby
-  # adapter via their own require chains (e.g. require "openapi_helper").
-  pattern.split(",").each do |p|
-    Dir.glob(p.strip).each { |f| require File.expand_path(f) }
+def default_pattern_for(framework)
+  case framework
+  when "rspec" then "spec/**/*_spec.rb"
+  when "minitest" then "test/**/*_test.rb"
   end
-
-  # Generate schemas from the registered contexts
-  OpenapiRuby::Generator::SchemaWriter.generate_all!
 end
 
-def generate_with_minitest
-  pattern = ENV.fetch("PATTERN", "test/**/*_test.rb")
-  puts "Generating OpenAPI schemas (Minitest)..."
-
-  # Load Rails environment and minitest adapter
-  require "openapi_ruby/minitest"
-
-  # Load all test files to trigger api_path registrations.
-  # Minitest's api_path registers DSL contexts at class load time,
-  # so simply requiring the files is enough.
-  Dir.glob(pattern).each { |f| require File.expand_path(f) }
-
-  # Generate schemas from the registered contexts
-  OpenapiRuby::Generator::SchemaWriter.generate_all!
+def generate_script(framework, pattern)
+  case framework
+  when "rspec"
+    <<~RUBY
+      require "rspec/core"
+      $LOAD_PATH.unshift(File.expand_path("spec")) unless $LOAD_PATH.include?(File.expand_path("spec"))
+      #{pattern.split(",").map { |p| %[Dir.glob(#{p.strip.inspect}).sort.each { |f| require File.expand_path(f) }] }.join("\n")}
+      OpenapiRuby::Generator::SchemaWriter.generate_all!
+    RUBY
+  when "minitest"
+    <<~RUBY
+      require "openapi_ruby/minitest"
+      #{pattern.split(",").map { |p| %[Dir.glob(#{p.strip.inspect}).sort.each { |f| require File.expand_path(f) }] }.join("\n")}
+      OpenapiRuby::Generator::SchemaWriter.generate_all!
+    RUBY
+  else
+    abort "Unknown test framework '#{framework}'."
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openapi-ruby
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.2
 platform: ruby
 authors:
 - Morten Hartvig