betterdocs 0.6.4 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b72c9031a9c65d2a521d8bf7f17d10d129045b38f64a34f3f8a7ec101e78cc76
-  data.tar.gz: 37cda0506b30141bbaa3c6718e0c0bdec8845eef22458a8ea4da65e55b3cbd82
+  metadata.gz: 20d027edf16ddf9005dff698681bae303072e35551a38a31e6fcadd869470bd1
+  data.tar.gz: fbe5f701b86f60136fb37b3e86086bcaa149d17b75fe13e1cba04ae1b3cc372e
 SHA512:
-  metadata.gz: ceb308776379d1cf4f6afa24ca1773e13ff3a90ce6b2cbf61b4e806bb3334742a2f61901c9308d56e7f9429ce8042cb7629f38b949d47cc13b8df3b4149a1b4e
-  data.tar.gz: aef1fac10d1a584a0e9d95e8894822e6ddfa1d060052bf5da233c7730d60c8a6323194cd476fc6d3982cd172e34af2eeb08effa1249bfdc4281067889d84b575
+  metadata.gz: e2c3a40eb2c01ddbbd35d55aacc475e17b1353103eb9f7fbe70a58d9e42dd0cc5c1749c73631a29b8b76ef7ac83fe964c177c718085899cbfd5690d413e4d24f
+  data.tar.gz: 267d789259bc464b96e6fd53e320da4b8b0406b1efd7c544d665658fc4d44aeb888775f03009880f9179782ca8d25354009d54fe9a6f8ac83262785bff6dcd7c

data/.semaphore/semaphore.yml

@@ -0,0 +1,26 @@
+version: v1.0
+name: Betterdocs pipeline
+agent:
+  machine:
+    type: e1-standard-2
+    os_image: ubuntu1804
+
+blocks:
+  - name: "Unit Tests"
+    task:
+      env_vars:
+        # Matches the configuration used in sem-service
+        - name: RAILS_ENV
+          value: test
+      jobs:
+      - name: RSpec
+        commands:
+          - checkout
+
+          # Setup ruby
+          - sem-version ruby $(awk '/^ruby/ { print $2 }' .tool-versions)
+
+          # Setup gems
+          - bundle config set path 'vendor/bundle'
+          - bundle install
+          - bundle exec rake spec

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.0.1

data/README.md

@@ -6,7 +6,7 @@ Betterdocs API Documentation
 DESCRIPTION
 -----------
 
-This library can be used to document a rails based API.
+This library can be used to document a Rails-based API.
 
 LICENSE
 -------
@@ -40,12 +40,12 @@ This api generator requires that you follow the [representer pattern](http://nic
         end
 
         response do
-          generate_fake_result_with_representer 
+          generate_fake_result_with_representer
         end
       end
       # :nocov:
       def index
-        render json: real_result_with_representer 
+        render json: real_result_with_representer
       end
 
       # :nocov: Documentation
@@ -68,7 +68,7 @@ This api generator requires that you follow the [representer pattern](http://nic
       end
       # :nocov:
       def show
-        render json: real_result_with_representer 
+        render json: real_result_with_representer
       end
     end
 

data/Rakefile

@@ -17,7 +17,7 @@ GemHadar do
   title       "#{name.camelize}"
 
   dependency 'tins',           '~>1.3', '>=1.3.5'
-  dependency 'rails',          '>=3', '<6'
+  dependency 'rails',          '>=3', '<7'
   dependency 'term-ansicolor', '~>1.3'
   dependency 'complex_config', '~>0.5'
   dependency 'infobar'

data/VERSION

@@ -1 +1 @@
-0.6.4
+0.7.0

data/betterdocs.gemspec

@@ -1,57 +1,46 @@
 # -*- encoding: utf-8 -*-
-# stub: betterdocs 0.6.4 ruby lib
+# stub: betterdocs 0.7.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "betterdocs".freeze
-  s.version = "0.6.4"
+  s.version = "0.7.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["betterplace Developers".freeze]
-  s.date = "2018-10-10"
+  s.date = "2021-05-21"
   s.description = "This library provides tools to generate API documention for a web site's REST-ful JSON API.".freeze
   s.email = "developers@betterplace.org".freeze
   s.extra_rdoc_files = ["README.md".freeze, "lib/betterdocs.rb".freeze, "lib/betterdocs/controller_collector.rb".freeze, "lib/betterdocs/dsl.rb".freeze, "lib/betterdocs/dsl/common.rb".freeze, "lib/betterdocs/dsl/controller.rb".freeze, "lib/betterdocs/dsl/controller/action.rb".freeze, "lib/betterdocs/dsl/controller/action/param.rb".freeze, "lib/betterdocs/dsl/controller/action/response.rb".freeze, "lib/betterdocs/dsl/controller/controller.rb".freeze, "lib/betterdocs/dsl/controller/controller_base.rb".freeze, "lib/betterdocs/dsl/json_params.rb".freeze, "lib/betterdocs/dsl/json_params/param.rb".freeze, "lib/betterdocs/dsl/json_type_mapper.rb".freeze, "lib/betterdocs/dsl/naming.rb".freeze, "lib/betterdocs/dsl/representer.rb".freeze, "lib/betterdocs/dsl/result.rb".freeze, "lib/betterdocs/dsl/result/collection_property.rb".freeze, "lib/betterdocs/dsl/result/link.rb".freeze, "lib/betterdocs/dsl/result/property.rb".freeze, "lib/betterdocs/generator/config_shortcuts.rb".freeze, "lib/betterdocs/generator/markdown.rb".freeze, "lib/betterdocs/global.rb".freeze, "lib/betterdocs/json_params_representer.rb".freeze, "lib/betterdocs/json_params_representer_collector.rb".freeze, "lib/betterdocs/json_time_with_zone.rb".freeze, "lib/betterdocs/mix_into_controller.rb".freeze, "lib/betterdocs/railtie.rb".freeze, "lib/betterdocs/rake_tasks.rb".freeze, "lib/betterdocs/representer.rb".freeze, "lib/betterdocs/result_representer.rb".freeze, "lib/betterdocs/result_representer_collector.rb".freeze, "lib/betterdocs/sanitizer.rb".freeze, "lib/betterdocs/section.rb".freeze, "lib/betterdocs/version.rb".freeze]
-  s.files = [".codeclimate.yml".freeze, ".gitignore".freeze, ".rspec".freeze, ".travis.yml".freeze, "COPYING".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "betterdocs.gemspec".freeze, "lib/betterdocs.rb".freeze, "lib/betterdocs/controller_collector.rb".freeze, "lib/betterdocs/dsl.rb".freeze, "lib/betterdocs/dsl/common.rb".freeze, "lib/betterdocs/dsl/controller.rb".freeze, "lib/betterdocs/dsl/controller/action.rb".freeze, "lib/betterdocs/dsl/controller/action/param.rb".freeze, "lib/betterdocs/dsl/controller/action/response.rb".freeze, "lib/betterdocs/dsl/controller/controller.rb".freeze, "lib/betterdocs/dsl/controller/controller_base.rb".freeze, "lib/betterdocs/dsl/json_params.rb".freeze, "lib/betterdocs/dsl/json_params/param.rb".freeze, "lib/betterdocs/dsl/json_type_mapper.rb".freeze, "lib/betterdocs/dsl/naming.rb".freeze, "lib/betterdocs/dsl/representer.rb".freeze, "lib/betterdocs/dsl/result.rb".freeze, "lib/betterdocs/dsl/result/collection_property.rb".freeze, "lib/betterdocs/dsl/result/link.rb".freeze, "lib/betterdocs/dsl/result/property.rb".freeze, "lib/betterdocs/generator/config_shortcuts.rb".freeze, "lib/betterdocs/generator/markdown.rb".freeze, "lib/betterdocs/generator/markdown/templates/README.md.erb".freeze, "lib/betterdocs/generator/markdown/templates/section.md.erb".freeze, "lib/betterdocs/global.rb".freeze, "lib/betterdocs/json_params_representer.rb".freeze, "lib/betterdocs/json_params_representer_collector.rb".freeze, "lib/betterdocs/json_time_with_zone.rb".freeze, "lib/betterdocs/mix_into_controller.rb".freeze, "lib/betterdocs/railtie.rb".freeze, "lib/betterdocs/rake_tasks.rb".freeze, "lib/betterdocs/representer.rb".freeze, "lib/betterdocs/result_representer.rb".freeze, "lib/betterdocs/result_representer_collector.rb".freeze, "lib/betterdocs/sanitizer.rb".freeze, "lib/betterdocs/section.rb".freeze, "lib/betterdocs/tasks/doc.rake".freeze, "lib/betterdocs/version.rb".freeze, "spec/assets/app/assets/images/logos/logo.png".freeze, "spec/assets/app/controllers/api/foos_controller.rb".freeze, "spec/assets/app/views/api_v4/documentation/assets/CHANGELOG.md".freeze, "spec/assets/config/betterdocs.yml".freeze, "spec/betterdocs/dsl/controller/action/param_spec.rb".freeze, "spec/betterdocs/dsl/controller/action/response_spec.rb".freeze, "spec/betterdocs/dsl/json_type_mapper_spec.rb".freeze, "spec/betterdocs/dsl/result/collection_property_spec.rb".freeze, "spec/betterdocs/dsl/result/link_spec.rb".freeze, "spec/betterdocs/dsl/result/property_spec.rb".freeze, "spec/betterdocs/generator/markdown_spec.rb".freeze, "spec/betterdocs/global_spec.rb".freeze, "spec/betterdocs/json_params_representer_spec.rb".freeze, "spec/betterdocs/result_representer_spec.rb".freeze, "spec/betterdocs/sanitizer_spec.rb".freeze, "spec/controller_dsl_spec.rb".freeze, "spec/result_representer_dsl_spec.rb".freeze, "spec/spec_helper.rb".freeze]
+  s.files = [".codeclimate.yml".freeze, ".gitignore".freeze, ".rspec".freeze, ".semaphore/semaphore.yml".freeze, ".tool-versions".freeze, "COPYING".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "betterdocs.gemspec".freeze, "lib/betterdocs.rb".freeze, "lib/betterdocs/controller_collector.rb".freeze, "lib/betterdocs/dsl.rb".freeze, "lib/betterdocs/dsl/common.rb".freeze, "lib/betterdocs/dsl/controller.rb".freeze, "lib/betterdocs/dsl/controller/action.rb".freeze, "lib/betterdocs/dsl/controller/action/param.rb".freeze, "lib/betterdocs/dsl/controller/action/response.rb".freeze, "lib/betterdocs/dsl/controller/controller.rb".freeze, "lib/betterdocs/dsl/controller/controller_base.rb".freeze, "lib/betterdocs/dsl/json_params.rb".freeze, "lib/betterdocs/dsl/json_params/param.rb".freeze, "lib/betterdocs/dsl/json_type_mapper.rb".freeze, "lib/betterdocs/dsl/naming.rb".freeze, "lib/betterdocs/dsl/representer.rb".freeze, "lib/betterdocs/dsl/result.rb".freeze, "lib/betterdocs/dsl/result/collection_property.rb".freeze, "lib/betterdocs/dsl/result/link.rb".freeze, "lib/betterdocs/dsl/result/property.rb".freeze, "lib/betterdocs/generator/config_shortcuts.rb".freeze, "lib/betterdocs/generator/markdown.rb".freeze, "lib/betterdocs/generator/markdown/templates/README.md.erb".freeze, "lib/betterdocs/generator/markdown/templates/section.md.erb".freeze, "lib/betterdocs/global.rb".freeze, "lib/betterdocs/json_params_representer.rb".freeze, "lib/betterdocs/json_params_representer_collector.rb".freeze, "lib/betterdocs/json_time_with_zone.rb".freeze, "lib/betterdocs/mix_into_controller.rb".freeze, "lib/betterdocs/railtie.rb".freeze, "lib/betterdocs/rake_tasks.rb".freeze, "lib/betterdocs/representer.rb".freeze, "lib/betterdocs/result_representer.rb".freeze, "lib/betterdocs/result_representer_collector.rb".freeze, "lib/betterdocs/sanitizer.rb".freeze, "lib/betterdocs/section.rb".freeze, "lib/betterdocs/tasks/doc.rake".freeze, "lib/betterdocs/version.rb".freeze, "spec/assets/app/assets/images/logos/logo.png".freeze, "spec/assets/app/controllers/api/foos_controller.rb".freeze, "spec/assets/app/views/api_v4/documentation/assets/CHANGELOG.md".freeze, "spec/assets/config/betterdocs.yml".freeze, "spec/betterdocs/dsl/controller/action/param_spec.rb".freeze, "spec/betterdocs/dsl/controller/action/response_spec.rb".freeze, "spec/betterdocs/dsl/json_type_mapper_spec.rb".freeze, "spec/betterdocs/dsl/result/collection_property_spec.rb".freeze, "spec/betterdocs/dsl/result/link_spec.rb".freeze, "spec/betterdocs/dsl/result/property_spec.rb".freeze, "spec/betterdocs/generator/markdown_spec.rb".freeze, "spec/betterdocs/global_spec.rb".freeze, "spec/betterdocs/json_params_representer_spec.rb".freeze, "spec/betterdocs/result_representer_spec.rb".freeze, "spec/betterdocs/sanitizer_spec.rb".freeze, "spec/controller_dsl_spec.rb".freeze, "spec/result_representer_dsl_spec.rb".freeze, "spec/spec_helper.rb".freeze]
   s.homepage = "http://github.com/betterplace/betterdocs".freeze
   s.rdoc_options = ["--title".freeze, "Betterdocs".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "2.7.7".freeze
+  s.rubygems_version = "3.2.15".freeze
   s.summary = "Betterplace API documentation library".freeze
   s.test_files = ["spec/assets/app/controllers/api/foos_controller.rb".freeze, "spec/betterdocs/dsl/controller/action/param_spec.rb".freeze, "spec/betterdocs/dsl/controller/action/response_spec.rb".freeze, "spec/betterdocs/dsl/json_type_mapper_spec.rb".freeze, "spec/betterdocs/dsl/result/collection_property_spec.rb".freeze, "spec/betterdocs/dsl/result/link_spec.rb".freeze, "spec/betterdocs/dsl/result/property_spec.rb".freeze, "spec/betterdocs/generator/markdown_spec.rb".freeze, "spec/betterdocs/global_spec.rb".freeze, "spec/betterdocs/json_params_representer_spec.rb".freeze, "spec/betterdocs/result_representer_spec.rb".freeze, "spec/betterdocs/sanitizer_spec.rb".freeze, "spec/controller_dsl_spec.rb".freeze, "spec/result_representer_dsl_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
   if s.respond_to? :specification_version then
     s.specification_version = 4
+  end
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.9.1"])
-      s.add_development_dependency(%q<rake>.freeze, [">= 0"])
-      s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
-      s.add_development_dependency(%q<rspec>.freeze, [">= 0"])
-      s.add_runtime_dependency(%q<tins>.freeze, [">= 1.3.5", "~> 1.3"])
-      s.add_runtime_dependency(%q<rails>.freeze, ["< 6", ">= 3"])
-      s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.3"])
-      s.add_runtime_dependency(%q<complex_config>.freeze, ["~> 0.5"])
-      s.add_runtime_dependency(%q<infobar>.freeze, [">= 0"])
-      s.add_runtime_dependency(%q<mize>.freeze, [">= 0"])
-    else
-      s.add_dependency(%q<gem_hadar>.freeze, ["~> 1.9.1"])
-      s.add_dependency(%q<rake>.freeze, [">= 0"])
-      s.add_dependency(%q<simplecov>.freeze, [">= 0"])
-      s.add_dependency(%q<rspec>.freeze, [">= 0"])
-      s.add_dependency(%q<tins>.freeze, [">= 1.3.5", "~> 1.3"])
-      s.add_dependency(%q<rails>.freeze, ["< 6", ">= 3"])
-      s.add_dependency(%q<term-ansicolor>.freeze, ["~> 1.3"])
-      s.add_dependency(%q<complex_config>.freeze, ["~> 0.5"])
-      s.add_dependency(%q<infobar>.freeze, [">= 0"])
-      s.add_dependency(%q<mize>.freeze, [">= 0"])
-    end
+  if s.respond_to? :add_runtime_dependency then
+    s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.11.0"])
+    s.add_development_dependency(%q<rake>.freeze, [">= 0"])
+    s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
+    s.add_development_dependency(%q<rspec>.freeze, [">= 0"])
+    s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.3", ">= 1.3.5"])
+    s.add_runtime_dependency(%q<rails>.freeze, [">= 3", "< 7"])
+    s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.3"])
+    s.add_runtime_dependency(%q<complex_config>.freeze, ["~> 0.5"])
+    s.add_runtime_dependency(%q<infobar>.freeze, [">= 0"])
+    s.add_runtime_dependency(%q<mize>.freeze, [">= 0"])
   else
-    s.add_dependency(%q<gem_hadar>.freeze, ["~> 1.9.1"])
+    s.add_dependency(%q<gem_hadar>.freeze, ["~> 1.11.0"])
     s.add_dependency(%q<rake>.freeze, [">= 0"])
     s.add_dependency(%q<simplecov>.freeze, [">= 0"])
     s.add_dependency(%q<rspec>.freeze, [">= 0"])
-    s.add_dependency(%q<tins>.freeze, [">= 1.3.5", "~> 1.3"])
-    s.add_dependency(%q<rails>.freeze, ["< 6", ">= 3"])
+    s.add_dependency(%q<tins>.freeze, ["~> 1.3", ">= 1.3.5"])
+    s.add_dependency(%q<rails>.freeze, [">= 3", "< 7"])
     s.add_dependency(%q<term-ansicolor>.freeze, ["~> 1.3"])
     s.add_dependency(%q<complex_config>.freeze, ["~> 0.5"])
     s.add_dependency(%q<infobar>.freeze, [">= 0"])

data/lib/betterdocs/dsl/json_params/param.rb

@@ -25,9 +25,7 @@ class Betterdocs::Dsl::JsonParams::Param < Betterdocs::Dsl::Representer
 
   def compute_value(object)
     value = object.__send__(name)
-    if ActiveSupport::TimeWithZone === value
-      value.extend Betterdocs::JsonTimeWithZone
-    end
+    value.respond_to?(:iso8601) and value.extend Betterdocs::JsonTimeWithZone
     value
   end
 

data/lib/betterdocs/dsl/result/property.rb

@@ -46,7 +46,7 @@ class Betterdocs::Dsl::Result::Property < Betterdocs::Dsl::Representer
     value.nil? and return
     if represent_with
       represent_with.hashify(value)
-    elsif ActiveSupport::TimeWithZone === value
+    elsif value.respond_to?(:iso8601)
       value.extend Betterdocs::JsonTimeWithZone
     else
       sanitizer.sanitize(value)

data/lib/betterdocs/generator/markdown/templates/section.md.erb

@@ -60,7 +60,15 @@ are optional.
     <th align="left"><%= param.name %></th>
     <td><code><%= param.value %></code></td>
     <td><code><%= param.types * ?| -%></code></td>
-    <td><%= param.required ? 'yes' : 'no' %></td>
+    <td>
+      <%=
+        case param.required
+        when String then param.required
+        when true then 'yes'
+        else 'no'
+        end
+      %>
+    </td>
 <td>
 
 <%= param.description %>

data/lib/betterdocs/representer.rb

@@ -30,7 +30,7 @@ module Betterdocs::Representer
     end
 
     def doc(type, name, **options, &block)
-      docs.add_element(self, type, name, options, &block)
+      docs.add_element(self, type, name, **options, &block)
     end
 
     def object_name(*) end

data/lib/betterdocs/result_representer.rb

@@ -15,7 +15,7 @@ module Betterdocs::ResultRepresenter
     end
 
     def doc(type, name, **options, &block)
-      docs.add_element(self, type, name, options, &block)
+      docs.add_element(self, type, name, **options, &block)
     end
 
     def docs

data/lib/betterdocs/version.rb

@@ -1,6 +1,6 @@
 module Betterdocs
   # Betterdocs version
-  VERSION         = '0.6.4'
+  VERSION         = '0.7.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: betterdocs
 version: !ruby/object:Gem::Version
-  version: 0.6.4
+  version: 0.7.0
 platform: ruby
 authors:
 - betterplace Developers
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-10-10 00:00:00.000000000 Z
+date: 2021-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.1
+        version: 1.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.1
+        version: 1.11.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -95,7 +95,7 @@ dependencies:
         version: '3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '6'
+        version: '7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -105,7 +105,7 @@ dependencies:
         version: '3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '6'
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: term-ansicolor
   requirement: !ruby/object:Gem::Requirement
@@ -207,7 +207,8 @@ files:
 - ".codeclimate.yml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
+- ".semaphore/semaphore.yml"
+- ".tool-versions"
 - COPYING
 - Gemfile
 - LICENSE
@@ -273,7 +274,7 @@ files:
 homepage: http://github.com/betterplace/betterdocs
 licenses: []
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options:
 - "--title"
 - Betterdocs
@@ -292,9 +293,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Betterplace API documentation library
 test_files:

data/.travis.yml

@@ -1,9 +0,0 @@
-before_install:
-  - gem update --system
-  - gem update bundler
-
-rvm:
-  - 2.4.3
-  - 2.5.0
-
-sudo: false