swagger_autogenerate 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a79f228421fcf8a16a00e06ca839087079f3682a75b59a60db6b80711010958
-  data.tar.gz: f8ee425bfb9d3a65905ebd1a03c527b2d55b52590f217b5e2a400760f964d373
+  metadata.gz: 0b52220aecae46c5818f0640a1ca979f59d38fba0720e2d5a35685fbb6c06bbd
+  data.tar.gz: 995666a3bd4de256824656420231be0c38d564aa236a6bfca10659d1474908ff
 SHA512:
-  metadata.gz: b5867cf7d6d7dd713a5eb84eb2a1f9f222ad7c9e299a99a572fdad5596ddb181d9a47c217cc32345b4cae98aac8af09c9684738cd526d4b481f8282ae932bc90
-  data.tar.gz: 4e58b9f677e91a2811bbbd866ab948f0a5976312e5c7a8df1584337c4dc32d149cb6dd7bac946210abaf4fc14058bcde3ca76419055704d467ff965e830e23d4
+  metadata.gz: c966988c943c3d108a30fa1abc38cef2295679e8f02b2f1dd302a64eedca45d5c97f37ff2c30f7ca35c516b92fa797ea6a0670a25ef1c587cef97ab22433f569
+  data.tar.gz: a6e6c285bdad27980d524f221c8ae5204e06a3ed222de805c2c5a6ebcda637c5e312712f395aa9247bae4002182fad5d264056c0b837a9a38c7ff5dd0d105d1c

data/CHANGELOG.md

@@ -1,6 +1,5 @@
 ## [Unreleased]
 
 ## [0.1.1] - 2024-05-27
-## [1.0.1] - 2024-05-31
-
+## [1.0.2] - 2024-05-31
 - Initial release

data/README.md

@@ -7,6 +7,12 @@ automating Swagger YAML generation in Ruby on Rails offers a range of benefits f
 
 The gem automatically observes the request/response patterns during the execution of test scenarios, generating accurate Swagger YAML files that reflect the API's behavior. developers and consumers can better understand and interact with the APIs.
 
+## Dependencies
+
+The SwaggerAutogenerate gem depends on the rspec-rails gem, which brings the RSpec testing framework to Ruby on Rails.
+Please install rspec-rails first: https://github.com/rspec/rspec-rails
+Then continue the installation process.
+
 ## Installation
 
 1) Open your Gemfile located at ./Gemfile
@@ -18,7 +24,9 @@ The gem automatically observes the request/response patterns during the executio
     end
     ```
 3) Install the gem and add to the application's Gemfile by executing:
-    $ bundle install
+   ```
+   bundle install
+   ```
 
 ## Configuration
 
@@ -31,6 +39,11 @@ To configure the swagger_autogenerate gem in your Rails application, follow thes
 ```
     include SwaggerAutogenerate if Rails.env.test? && ENV['SWAGGER'].present?
 ```
+in the #Example-step you will set the ENV['SWAGGER'], 
+
+By setting the ENV['SWAGGER'] environment variable, you can specify the path to the new file,
+whether it's a specific file (e.g., ../myfile.yaml) or a directory (e.g., ../docs).
+This flexibility ensures that the documentation can be easily integrated into your project's structure and workflow.
 
 ### Step 2 (optional)
 1) Create a file called swagger_autogenerate.rb in the ./config/initializers
@@ -56,7 +69,7 @@ To generate Swagger YAML documentation for the APIs implemented in the Employees
 $ spec/your_path/employees_controller_spec.rb
 This file should contain the test scenarios for each action (e.g., index, show, create) of the controller.
 
-3)Run the spec code using the rspec command and set the environment variable SWAGGER to the desired YAML file name. For example:
+3) Run the spec code using the rspec command and set the environment variable SWAGGER to the desired YAML file name. For example:
 ```
 SWAGGER='employee_apis.yaml' rspec spec/your_path/employees_controller_spec.rb
 ```
@@ -69,7 +82,3 @@ that the generated documentation will depend on the test scenarios defined in yo
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the SwaggerAutogenerate project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/swagger_autogenerate/blob/master/CODE_OF_CONDUCT.md).

data/lib/swagger_autogenerate/swagger_trace.rb

@@ -13,7 +13,7 @@ module SwaggerAutogenerate
     def initialize(request, response)
       @request = request
       @response = response
-      @paths = {}
+      @@paths = {}
     end
 
     def call
@@ -51,13 +51,13 @@ module SwaggerAutogenerate
         }
 
       hash[method].except!('requestBody') if hash[method]['requestBody'].blank?
-      @paths[path.to_s] ||= {}
-      @paths[path.to_s].merge!(hash)
+      paths[path.to_s] ||= {}
+      paths[path.to_s].merge!(hash)
     end
 
     def write_swagger_trace
-      if @paths[current_path][request.method.downcase].present?
-        @paths[current_path][request.method.downcase]['responses'] = swagger_response
+      if paths[current_path][request.method.downcase].present?
+        paths[current_path][request.method.downcase]['responses'] = swagger_response
       end
 
       if File.exist?(swagger_location)
@@ -70,7 +70,7 @@ module SwaggerAutogenerate
     def create_file
       File.open(swagger_location, 'w') do |file|
         data = WITH_CONFIG ? swagger_config : {}
-        data['paths'] = @paths
+        data['paths'] = paths
         organize_result(data['paths'])
         data = data.to_hash
         result = add_quotes_to_dates(YAML.dump(data))
@@ -85,15 +85,15 @@ module SwaggerAutogenerate
         permitted_classes: [Symbol, Date, ActiveSupport::HashWithIndifferentAccess]
       )
 
-      return create_file if @yaml_file.nil? || @yaml_file['paths'].nil?
+      return create_file if yaml_file.nil? || yaml_file['paths'].nil?
 
-      @yaml_file.merge!(swagger_config) if WITH_CONFIG
+      yaml_file.merge!(swagger_config) if WITH_CONFIG
 
       apply_yaml_file_changes
-      organize_result(@yaml_file['paths'])
-      @yaml_file = convert_to_hash(@yaml_file)
+      organize_result(yaml_file['paths'])
+      @yaml_file = convert_to_hash(yaml_file)
       File.open(swagger_location, 'w') do |file|
-        result = add_quotes_to_dates(YAML.dump(@yaml_file))
+        result = add_quotes_to_dates(YAML.dump(yaml_file))
         file.write(result)
       end
     end
@@ -298,7 +298,7 @@ module SwaggerAutogenerate
     # Static
 
     def paths
-      @paths ||= {}
+      @@paths ||= {}
     end
 
     def security
@@ -420,7 +420,7 @@ module SwaggerAutogenerate
 
     def check_path
       unless old_paths.key?(current_path)
-        yaml_file['paths'].merge!({ current_path => @paths[current_path] })
+        yaml_file['paths'].merge!({ current_path => paths[current_path] })
       end
     end
 
@@ -444,29 +444,29 @@ module SwaggerAutogenerate
 
     def check_parameters
       if old_paths[current_path][request.method.downcase]['parameters'].blank?
-        yaml_file['paths'][current_path][request.method.downcase]['parameters'] = @paths[current_path][request.method.downcase]['parameters']
+        yaml_file['paths'][current_path][request.method.downcase]['parameters'] = paths[current_path][request.method.downcase]['parameters']
       end
     end
 
     def check_parameter
-      param_names = @paths[current_path][request.method.downcase]['parameters'].pluck('name') - yaml_file['paths'][current_path][request.method.downcase]['parameters'].pluck('name')
+      param_names = paths[current_path][request.method.downcase]['parameters'].pluck('name') - yaml_file['paths'][current_path][request.method.downcase]['parameters'].pluck('name')
       param_names.each do |param_name|
-        param = @paths[current_path][request.method.downcase]['parameters'].find { |parameter| parameter['name'] == param_name }
+        param = paths[current_path][request.method.downcase]['parameters'].find { |parameter| parameter['name'] == param_name }
         yaml_file['paths'][current_path][request.method.downcase]['parameters'].push(param)
       end
     end
 
     def check_request_bodys
-      if @paths[current_path][request.method.downcase]['requestBody'].present? && old_paths[current_path][request.method.downcase]['requestBody'].nil?
-        yaml_file['paths'][current_path][request.method.downcase]['requestBody'] = @paths[current_path][request.method.downcase]['requestBody']
+      if paths[current_path][request.method.downcase]['requestBody'].present? && old_paths[current_path][request.method.downcase]['requestBody'].nil?
+        yaml_file['paths'][current_path][request.method.downcase]['requestBody'] = paths[current_path][request.method.downcase]['requestBody']
       end
     end
 
     def check_request_body
-      if @paths[current_path][request.method.downcase]['requestBody'].present?
-        param_names = @paths[current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].keys - yaml_file['paths'][current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].keys
+      if paths[current_path][request.method.downcase]['requestBody'].present?
+        param_names = paths[current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].keys - yaml_file['paths'][current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].keys
         param_names.each do |param_name|
-          param = @paths[current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].select { |parameter| parameter == param_name }
+          param = paths[current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].select { |parameter| parameter == param_name }
           yaml_file['paths'][current_path][request.method.downcase]['requestBody']['content']['multipart/form-data']['schema']['properties'].merge!(param)
         end
       end

data/lib/swagger_autogenerate/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SwaggerAutogenerate
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swagger_autogenerate
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - MohammedBuraiah