praxis 2.0.pre.3 → 2.0.pre.8

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: praxis
 version: !ruby/object:Gem::Version
-  version: 2.0.pre.3
+  version: 2.0.pre.8
 platform: ruby
 authors:
 - Josep M. Blanquer
 - Dane Jensen
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-07-15 00:00:00.000000000 Z
+date: 2020-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -79,28 +79,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.5'
 - !ruby/object:Gem::Dependency
   name: attributor
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.4'
+        version: '5.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.4'
+        version: '5.5'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -147,30 +147,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: rake-notes
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -353,20 +339,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.20
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.20
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
@@ -409,7 +381,7 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: '4'
-description: 
+description:
 email:
 - blanquer@gmail.com
 - dane.jensen@gmail.com
@@ -420,6 +392,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".ruby-version"
 - ".simplecov"
 - ".travis.yml"
 - CHANGELOG.md
@@ -431,6 +404,7 @@ files:
 - MAINTAINERS.md
 - README.md
 - Rakefile
+- TODO.md
 - bin/praxis
 - lib/api_browser/.bowerrc
 - lib/api_browser/.editorconfig
@@ -516,6 +490,7 @@ files:
 - lib/api_browser/app/views/types/standalone/default.html
 - lib/api_browser/app/views/types/standalone/struct.html
 - lib/api_browser/bower_template.json
+- lib/api_browser/package-lock.json
 - lib/api_browser/package.json
 - lib/praxis.rb
 - lib/praxis/action_definition.rb
@@ -540,6 +515,18 @@ files:
 - lib/praxis/dispatcher.rb
 - lib/praxis/docs/generator.rb
 - lib/praxis/docs/link_builder.rb
+- lib/praxis/docs/open_api_generator.rb
+- lib/praxis/docs/openapi/info_object.rb
+- lib/praxis/docs/openapi/media_type_object.rb
+- lib/praxis/docs/openapi/operation_object.rb
+- lib/praxis/docs/openapi/parameter_object.rb
+- lib/praxis/docs/openapi/paths_object.rb
+- lib/praxis/docs/openapi/request_body_object.rb
+- lib/praxis/docs/openapi/response_object.rb
+- lib/praxis/docs/openapi/responses_object.rb
+- lib/praxis/docs/openapi/schema_object.rb
+- lib/praxis/docs/openapi/server_object.rb
+- lib/praxis/docs/openapi/tag_object.rb
 - lib/praxis/error_handler.rb
 - lib/praxis/exception.rb
 - lib/praxis/exceptions/config.rb
@@ -550,7 +537,13 @@ files:
 - lib/praxis/exceptions/invalid_trait.rb
 - lib/praxis/exceptions/stage_not_found.rb
 - lib/praxis/exceptions/validation.rb
+- lib/praxis/extensions/attribute_filtering.rb
 - lib/praxis/extensions/attribute_filtering/active_record_filter_query_builder.rb
+- lib/praxis/extensions/attribute_filtering/active_record_patches.rb
+- lib/praxis/extensions/attribute_filtering/active_record_patches/5x.rb
+- lib/praxis/extensions/attribute_filtering/active_record_patches/6_0.rb
+- lib/praxis/extensions/attribute_filtering/active_record_patches/6_1_plus.rb
+- lib/praxis/extensions/attribute_filtering/filter_tree_node.rb
 - lib/praxis/extensions/attribute_filtering/filtering_params.rb
 - lib/praxis/extensions/attribute_filtering/sequel_filter_query_builder.rb
 - lib/praxis/extensions/field_expansion.rb
@@ -558,6 +551,13 @@ files:
 - lib/praxis/extensions/field_selection/active_record_query_selector.rb
 - lib/praxis/extensions/field_selection/field_selector.rb
 - lib/praxis/extensions/field_selection/sequel_query_selector.rb
+- lib/praxis/extensions/pagination.rb
+- lib/praxis/extensions/pagination/active_record_pagination_handler.rb
+- lib/praxis/extensions/pagination/header_generator.rb
+- lib/praxis/extensions/pagination/ordering_params.rb
+- lib/praxis/extensions/pagination/pagination_handler.rb
+- lib/praxis/extensions/pagination/pagination_params.rb
+- lib/praxis/extensions/pagination/sequel_pagination_handler.rb
 - lib/praxis/extensions/rails_compat.rb
 - lib/praxis/extensions/rails_compat/request_methods.rb
 - lib/praxis/extensions/rendering.rb
@@ -565,7 +565,7 @@ files:
 - lib/praxis/handlers/json.rb
 - lib/praxis/handlers/plain.rb
 - lib/praxis/handlers/www_form.rb
-- lib/praxis/handlers/xml.rb
+- lib/praxis/handlers/xml-sample.rb
 - lib/praxis/links.rb
 - lib/praxis/mapper/active_model_compat.rb
 - lib/praxis/mapper/resource.rb
@@ -580,6 +580,7 @@ files:
 - lib/praxis/plugin.rb
 - lib/praxis/plugin_concern.rb
 - lib/praxis/plugins/mapper_plugin.rb
+- lib/praxis/plugins/pagination_plugin.rb
 - lib/praxis/plugins/rails_plugin.rb
 - lib/praxis/request.rb
 - lib/praxis/request_stages/action.rb
@@ -637,17 +638,19 @@ files:
 - spec/praxis/config_spec.rb
 - spec/praxis/controller_spec.rb
 - spec/praxis/dispatcher_spec.rb
+- spec/praxis/extensions/attribute_filtering/active_record_filter_query_builder_spec.rb
+- spec/praxis/extensions/attribute_filtering/filter_tree_node_spec.rb
+- spec/praxis/extensions/attribute_filtering/filtering_params_spec.rb
 - spec/praxis/extensions/field_expansion_spec.rb
 - spec/praxis/extensions/field_selection/active_record_query_selector_spec.rb
 - spec/praxis/extensions/field_selection/field_selector_spec.rb
 - spec/praxis/extensions/field_selection/sequel_query_selector_spec.rb
-- spec/praxis/extensions/field_selection/support/spec_resources_active_model.rb
-- spec/praxis/extensions/field_selection/support/spec_resources_sequel.rb
+- spec/praxis/extensions/pagination/active_record_pagination_handler_spec.rb
 - spec/praxis/extensions/rendering_spec.rb
+- spec/praxis/extensions/support/spec_resources_active_model.rb
+- spec/praxis/extensions/support/spec_resources_sequel.rb
 - spec/praxis/file_group_spec.rb
 - spec/praxis/handlers/json_spec.rb
-- spec/praxis/handlers/xml_spec.rb
-- spec/praxis/links_spec.rb
 - spec/praxis/mapper/resource_spec.rb
 - spec/praxis/mapper/selector_generator_spec.rb
 - spec/praxis/media_type_identifier_spec.rb
@@ -740,7 +743,7 @@ homepage: https://github.com/praxis/praxis
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -755,9 +758,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.14
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Building APIs the way you want it.
 test_files: []

data/spec/praxis/handlers/xml_spec.rb

@@ -1,177 +0,0 @@
-require 'spec_helper'
-
-describe Praxis::Handlers::XML do
-
-  describe '#parse' do
-    shared_examples 'xml something' do
-      it 'works' do
-        expect(subject.parse(parsed.to_xml)).to eq(parsed)
-      end
-    end
-
-    #  XML_TYPE_NAMES = {
-    #    "Symbol"     => "symbol",
-    #    "Fixnum"     => "integer",
-    #    "Bignum"     => "integer",
-    #    "BigDecimal" => "decimal",
-    #    "Float"      => "float",
-    #    "TrueClass"  => "boolean",
-    #    "FalseClass" => "boolean",
-    #    "Date"       => "date",
-    #    "DateTime"   => "dateTime",
-    #    "Time"       => "dateTime"
-    #  }
-
-    context "Parsing symbols" do
-      let(:xml){ '<objects type="array"><object type="symbol">a_symbol</object></objects>' }
-      let(:parsed){ [:a_symbol] }
-      it_behaves_like 'xml something'
-    end
-
-    context "Parsing integers" do
-      let(:xml){ '<objects type="array"><object type="integer">1234</object></objects>' }
-      let(:parsed){ [1234] }
-      it_behaves_like 'xml something'
-    end
-
-    context "Parsing decimals" do
-      let(:xml){ '<objects type="array"><object type="decimal">0.1</object></objects>' }
-      let(:parsed){ [0.1] }
-      it_behaves_like 'xml something'
-    end
-
-    context "Parsing floats" do
-      let(:xml){ '<objects type="array"><object type="float">0.1</object></objects>' }
-      let(:parsed){ [0.1] }
-      it_behaves_like 'xml something'
-    end
-
-    context "Parsing booleans" do
-      context "that are true" do
-        let(:xml){ '<objects type="array"><object type="boolean">true</object></objects>' }
-        let(:parsed){ [true] }
-        it_behaves_like 'xml something'
-      end
-      context "that are false" do
-        let(:xml){ '<objects type="array"><object type="boolean">false</object></objects>' }
-        let(:parsed){ [false] }
-        it_behaves_like 'xml something'
-
-      end
-    end
-
-    context "Parsing dates" do
-      let(:xml){ '<objects type="array"><object type="date">2001-01-01</object></objects>' }
-      let(:parsed){ [Date.parse("2001-01-01")] }
-      it_behaves_like 'xml something'
-    end
-
-    context "Parsing dateTimes" do
-      let(:xml){ '<objects type="array"><object type="dateTime">2015-03-13T19:34:40-07:00</object></objects>' }
-      let(:parsed){ [DateTime.parse("2015-03-13T19:34:40-07:00")] }
-      it_behaves_like 'xml something'
-    end
-
-    context "Parsing hashes" do
-      context "that are empty" do
-        let(:xml){ "<hash></hash>" }
-
-        it 'get converted to empty strings' do
-          expect(subject.parse(xml)).to eq('')
-        end
-      end
-
-      context "with a couple of elements" do
-        let(:xml){ '<hash><one type="integer">1</one><two type="integer">2</two></hash>' }
-        let(:parsed){ {"one"=>1, "two"=>2} }
-        it_behaves_like 'xml something'
-      end
-      context "with hyphenated elements" do
-        let(:xml){ '<hash><part-one type="integer">1</part-one><part-two type="integer">2</part-two></hash>' }
-        let(:parsed){ {"part_one"=>1, "part_two"=>2} }
-        it_behaves_like 'xml something'
-      end
-      context "with a nested hash" do
-        let(:xml){ '<hash><one type="integer">1</one><sub_hash><first>hello</first></sub_hash></hash>' }
-        let(:parsed){ {"one"=>1, "sub_hash"=>{"first"=>"hello"} } }
-        it_behaves_like 'xml something'
-      end
-      context "with a nested array" do
-        let(:xml){ '<hash><one type="integer">1</one><two type="array"><object>just text</object></two></hash>' }
-        let(:parsed){ {"one"=>1, "two" => ["just text"] } }
-        it_behaves_like 'xml something'
-      end
-
-    end
-
-    context "Parsing an Array" do
-      context 'with a couple of simple elements in it' do
-        let(:xml){ '<objects type="array"><object>just text</object><object type="integer">1</object></objects>' }
-        let(:parsed){ ["just text", 1] }
-        it_behaves_like 'xml something'
-      end
-      context "with a nested hash" do
-        let(:xml){ '<objects type="array"><object>just text</object><object><one type="integer">1</one></object></objects>' }
-        let(:parsed){ ["just text", { "one" => 1}] }
-        it_behaves_like 'xml something'
-      end
-    end
-
-    context "Parsing XML strings created with .to_xml" do
-      let(:xml){ parsed.to_xml }
-      context 'array with a couple of simple elements in it' do
-        let(:parsed){ ["just text", 1] }
-        it_behaves_like 'xml something'
-      end
-      context 'a hash with a couple of simple elements in it' do
-        let(:parsed){ { "one"=>"just text", "two"=> 1 } }
-        it_behaves_like 'xml something'
-      end
-      context 'a array with elements of all types' do
-        let(:parsed){ ["just text",:a,1,BigDecimal(100),0.1,true,Date.new] }
-        it_behaves_like 'xml something'
-      end
-      context 'a hash with a complex substructure' do
-        let(:parsed) do
-          Hash(
-            "text" => "just text",
-            "symbol" => :a,
-            "num" => 1,
-            "bd" => BigDecimal(100),
-            "float" => 0.1,
-            "truthyness" => true,
-            "day" => Date.new,
-            "empty_string" => ""
-          )
-        end
-        it_behaves_like 'xml something'
-      end
-
-      context "transformed characters when using .to_xml" do
-        context 'underscores become dashes' do
-          let(:xml){ {"one_thing"=>1, "two_things"=>2}.to_xml  }
-          it do
-            doc = Nokogiri::XML(xml)
-
-            expect(doc.search('one-thing')).to_not be_empty
-            expect(doc.search('two-things')).to_not be_empty
-          end
-        end
-        context 'spaces become dashes' do
-          let(:xml){ {"one thing"=>1, "two things"=>2}.to_xml  }
-          let(:parsed){ {"one-thing"=>1, "two-things"=>2} }
-          it do
-            doc = Nokogiri::XML(xml)
-
-            expect(doc.search('one-thing')).to_not be_empty
-            expect(doc.search('two-things')).to_not be_empty
-          end
-        end
-      end
-    end
-
-    describe '#generate' do
-      it 'has tests'
-    end
-  end
-end

data/spec/praxis/links_spec.rb

@@ -1,68 +0,0 @@
-require 'spec_helper'
-
-describe Praxis::Links do
-  let(:owner_resource) do
-    double('owner', id: 100, name: /[:name:]/.gen, href: '/')
-  end
-
-  let(:manager_resource) do
-    double('manager', id: 101, name: /[:name:]/.gen, href: '/')
-  end
-
-  let(:resource) do
-    double('address', id: 1, name: 'Home', owner: owner_resource, manager: manager_resource)
-  end
-
-  subject(:link) { described_class.for(Address) }
-
-  it 'returns the link class for the media type if defined' do
-    expect(link.for(Address)).to eq(link)
-  end
-
-  it 'are marked as anonymous' do
-    described = link.for(Address).describe
-    expect(described[:anonymous]).to be(true)
-  end
-
-  context 'contents' do
-    subject(:view) { link.view(:default) }
-
-    its(:name)      { should eq(:default) }
-    its(:schema)    { should eq(Address::Links) }
-    its(:contents)  { should have_key(:owner) }
-    its(:contents)  { should have_key(:super) }
-  end
-
-  context 'rendering' do
-    let(:example){ Address.example }
-    context 'for :default' do
-      subject(:rendered_links){ example.render(view: :default)[:links] }
-
-      it 'should use the :link for rendering its attributes' do
-        example.render(view: :default)[:links]
-        expect(rendered_links[:owner]).to eq( example.owner.render(view: :link))
-      end
-    end
-    context 'for :master' do
-      subject(:rendered_links){ example.render(view: :master)[:links] }
-      it 'should use the :link for rendering its attributes' do
-        expect(rendered_links[:owner]).to eq( example.owner.render(view: :link))
-      end
-    end
-  end
-
-  context '.example' do
-    subject(:example) { Address.example }
-
-    its('links.owner') { should be(example.owner) }
-    its('links.super') { should be(example.object.manager) }
-
-    it 'does not respond to non-top-level attributes from links' do
-      expect { example.super }.to raise_error(NoMethodError)
-    end
-
-    it 'responds to non-top-level attributes from links on its inner Struct' do
-      expect(example.links.super).to be(example.object.manager)
-    end
-  end
-end