dox 1.1.0 → 2.0.0

data/lib/dox/printers/resource_group_printer.rb

@@ -3,7 +3,7 @@ module Dox
     class ResourceGroupPrinter < BasePrinter
       def print(resource_group)
         self.resource_group = resource_group
-        @output.puts resource_group_title
+        add_resource_group
 
         resource_group.resources.each do |_, resource|
           resource_printer.print(resource)
@@ -14,16 +14,16 @@ module Dox
 
       attr_accessor :resource_group
 
-      def resource_group_title
-        <<-HEREDOC
+      def add_resource_group
+        spec['x-tagGroups'].push(name: resource_group.name, 'tags' => []) unless group_included?
+      end
 
-# Group #{resource_group.name}
-#{print_desc(resource_group.desc)}
-        HEREDOC
+      def group_included?
+        spec['x-tagGroups'].find { |group| group[:name] == resource_group.name }
       end
 
       def resource_printer
-        @resource_printer ||= ResourcePrinter.new(@output)
+        @resource_printer ||= ResourcePrinter.new(spec)
       end
     end
   end

data/lib/dox/printers/resource_printer.rb

@@ -3,7 +3,7 @@ module Dox
     class ResourcePrinter < BasePrinter
       def print(resource)
         self.resource = resource
-        @output.puts resource_title
+        add_resources
 
         resource.actions.each do |_, action|
           action_printer.print(action)
@@ -14,16 +14,21 @@ module Dox
 
       attr_accessor :resource
 
-      def resource_title
-        <<-HEREDOC
+      def add_resources
+        add_to_tags
+        add_to_groups
+      end
+
+      def add_to_tags
+        spec['tags'] = spec['tags'].push(name: resource.name, description: format_desc(resource.desc)).uniq
+      end
 
-## #{resource.name} [#{resource.endpoint}]
-#{print_desc(resource.desc)}
-        HEREDOC
+      def add_to_groups
+        spec['x-tagGroups'].find { |group| group[:name] == resource.group }['tags'].push(resource.name)
       end
 
       def action_printer
-        @action_printer ||= ActionPrinter.new(@output)
+        @action_printer ||= ActionPrinter.new(spec['paths'])
       end
     end
   end

data/lib/dox/util/http.rb

@@ -2,6 +2,70 @@ module Dox
   module Util
     module Http
       VERB = ['POST', 'GET', 'PUT', 'PATCH', 'DELETE', 'HEAD'].freeze
+      HTTP_STATUS_CODES = {
+        100 => 'Continue',
+        101 => 'Switching Protocols',
+        102 => 'Processing',
+        103 => 'Early Hints',
+        200 => 'OK',
+        201 => 'Created',
+        202 => 'Accepted',
+        203 => 'Non-Authoritative Information',
+        204 => 'No Content',
+        205 => 'Reset Content',
+        206 => 'Partial Content',
+        207 => 'Multi-Status',
+        208 => 'Already Reported',
+        226 => 'IM Used',
+        300 => 'Multiple Choices',
+        301 => 'Moved Permanently',
+        302 => 'Found',
+        303 => 'See Other',
+        304 => 'Not Modified',
+        305 => 'Use Proxy',
+        307 => 'Temporary Redirect',
+        308 => 'Permanent Redirect',
+        400 => 'Bad Request',
+        401 => 'Unauthorized',
+        402 => 'Payment Required',
+        403 => 'Forbidden',
+        404 => 'Not Found',
+        405 => 'Method Not Allowed',
+        406 => 'Not Acceptable',
+        407 => 'Proxy Authentication Required',
+        408 => 'Request Timeout',
+        409 => 'Conflict',
+        410 => 'Gone',
+        411 => 'Length Required',
+        412 => 'Precondition Failed',
+        413 => 'Payload Too Large',
+        414 => 'URI Too Long',
+        415 => 'Unsupported Media Type',
+        416 => 'Range Not Satisfiable',
+        417 => 'Expectation Failed',
+        421 => 'Misdirected Request',
+        422 => 'Unprocessable Entity',
+        423 => 'Locked',
+        424 => 'Failed Dependency',
+        425 => 'Too Early',
+        426 => 'Upgrade Required',
+        428 => 'Precondition Required',
+        429 => 'Too Many Requests',
+        431 => 'Request Header Fields Too Large',
+        451 => 'Unavailable for Legal Reasons',
+        500 => 'Internal Server Error',
+        501 => 'Not Implemented',
+        502 => 'Bad Gateway',
+        503 => 'Service Unavailable',
+        504 => 'Gateway Timeout',
+        505 => 'HTTP Version Not Supported',
+        506 => 'Variant Also Negotiates',
+        507 => 'Insufficient Storage',
+        508 => 'Loop Detected',
+        509 => 'Bandwidth Limit Exceeded',
+        510 => 'Not Extended',
+        511 => 'Network Authentication Required'
+      }.freeze
 
       def self.verb?(value)
         VERB.include?(value.upcase)

data/lib/dox/version.rb

@@ -1,3 +1,3 @@
 module Dox
-  VERSION = '1.1.0'
+  VERSION = '2.0.0'
 end

metadata

@@ -1,60 +1,60 @@
 --- !ruby/object:Gem::Specification
 name: dox
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Melita Kokot
 - Vedran Hrnčić
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2018-02-19 00:00:00.000000000 Z
+date: 2021-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: codeclimate-test-reporter
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: pry-nav
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -68,7 +68,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: pry-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -82,7 +82,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: codeclimate-test-reporter
+  name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -96,34 +96,90 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec-core
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.0'
   type: :runtime
   prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
-description: 
+        version: '0'
+description:
 email:
 - melita.kokot@gmail.com
 - vrabac266@gmail.com
@@ -166,10 +222,16 @@ files:
 - lib/dox/errors/invalid_resource_error.rb
 - lib/dox/errors/invalid_resource_group_error.rb
 - lib/dox/formatter.rb
+- lib/dox/formatters/base.rb
+- lib/dox/formatters/json.rb
+- lib/dox/formatters/multipart.rb
+- lib/dox/formatters/plain.rb
+- lib/dox/formatters/xml.rb
 - lib/dox/printers/action_printer.rb
 - lib/dox/printers/base_printer.rb
 - lib/dox/printers/document_printer.rb
-- lib/dox/printers/example_printer.rb
+- lib/dox/printers/example_request_printer.rb
+- lib/dox/printers/example_response_printer.rb
 - lib/dox/printers/resource_group_printer.rb
 - lib/dox/printers/resource_printer.rb
 - lib/dox/util/http.rb
@@ -179,7 +241,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -194,9 +256,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
-summary: Generates API documentation for rspec in api blueprint format.
+summary: Generates API documentation for rspec in OpenAPI format.
 test_files: []

data/lib/dox/printers/example_printer.rb

@@ -1,132 +0,0 @@
-require 'rexml/document'
-
-module Dox
-  module Printers
-    class ExamplePrinter < BasePrinter
-      def print(example)
-        self.example = example
-        print_example_request
-        print_example_response
-      end
-
-      private
-
-      attr_accessor :example
-
-      def print_example_request
-        @output.puts example_request_title
-        @output.puts example_request_headers
-        return unless example.request_body.present?
-
-        @output.puts example_request_body
-      end
-
-      def print_example_response
-        @output.puts example_response_title
-
-        if example.response_headers.present?
-          @output.puts example_response_headers
-        end
-
-        return unless example.response_body.present?
-        @output.puts example_response_body
-      end
-
-      def example_request_title
-        <<-HEREDOC
-
-+ Request #{example.request_identifier}
-**#{example.request_method.upcase}**&nbsp;&nbsp;`#{CGI.unescape(example.request_fullpath)}`
-        HEREDOC
-      end
-
-      def example_request_headers
-        <<-HEREDOC
-
-    + Headers
-
-#{indent_lines(12, print_headers(example.request_headers))}
-        HEREDOC
-      end
-
-      def example_request_body
-        <<-HEREDOC
-
-    + Body
-
-#{indent_lines(12, formatted_body(example.request_body, example.request_content_type))}
-        HEREDOC
-      end
-
-      def example_response_title
-        <<-HEREDOC
-
-+ Response #{example.response_status}
-        HEREDOC
-      end
-
-      def example_response_headers
-        <<-HEREDOC
-
-    + Headers
-
-#{indent_lines(12, print_headers(example.response_headers))}
-        HEREDOC
-      end
-
-      def example_response_body
-        <<-HEREDOC
-
-    + Body
-
-#{indent_lines(12, formatted_body(example.response_body, example.response_content_type))}
-        HEREDOC
-      end
-
-      def formatted_body(body_str, content_type)
-        case content_type
-        when %r{application\/.*json}
-          pretty_json(safe_json_parse(body_str))
-        when /xml/
-          pretty_xml(body_str)
-        else
-          body_str
-        end
-      end
-
-      def safe_json_parse(json_string)
-        json_string.length >= 2 ? JSON.parse(json_string) : nil
-      end
-
-      def pretty_json(json_string)
-        if json_string.present?
-          JSON.pretty_generate(json_string)
-        else
-          ''
-        end
-      end
-
-      def pretty_xml(xml_string)
-        doc = REXML::Document.new(xml_string)
-        formatter = REXML::Formatters::Pretty.new
-        formatter.compact = true
-        result = ''
-        formatter.write(doc, result)
-        result
-      end
-
-      def print_headers(headers)
-        headers.map do |key, value|
-          "#{key}: #{value}"
-        end.join("\n")
-      end
-
-      def indent_lines(number_of_spaces, string)
-        string
-          .split("\n")
-          .map { |a| a.prepend(' ' * number_of_spaces) }
-          .join("\n")
-      end
-    end
-  end
-end