nrser 0.3.9 → 0.3.10

data/spec/lib/nrser/labs/config_spec.rb

@@ -0,0 +1,22 @@
+require 'nrser/labs/config'
+
+describe_spec_file(
+  spec_path: __FILE__,
+  class: NRSER::Config,
+  labs: true, # run with `LABS=1 rspec ...` to include
+) do
+
+  
+  describe_section "basic shit" do
+  # ========================================================================
+    
+    subject { described_class.new( {x: 1, y: 2}, {y: 3, z: 4} ) }
+
+    it do
+      is_expected.to include x: 1, y: 3, z: 4
+    end
+    
+  end # section basic shit
+  # ************************************************************************
+
+end

data/spec/lib/nrser/labs/i8/struct_spec.rb

@@ -0,0 +1,39 @@
+require 'nrser/labs/i8/struct'
+
+require 'nrser/refinements/types'
+using NRSER::Types
+
+SPEC_FILE(
+  spec_path:        __FILE__,
+  module:           I8::Struct,
+) do
+  
+  CASE "Extend a {I8::Struct} and add methods" do
+    SETUP "Create a rectangle class based on an {I8::Struct}" do
+
+      class NRSER::TestFixtures::I8StructRectangle \
+        < I8::Struct.new( width: t.non_neg_int, length: t.non_neg_int )
+
+        def area
+          width * length
+        end
+
+      end # class NRSER::TestFixtures::I8StructRectangle
+
+      CLASS NRSER::TestFixtures::I8StructRectangle do
+
+        it "is a subclass of {I8::Struct::Hash}" do
+          expect( I8::Struct::Hash > subject ).to be true; end
+        
+        it "includes {I8::Struct}" do
+          expect( I8::Struct > subject ).to be true; end
+
+        INSTANCE width: 2, length: 3 do
+          it { is_expected.
+            to have_attributes width: 2, length: 3, area: 6 }; end
+      end
+
+    end # SETUP
+  end # CASE
+
+end # SPEC FILE

data/spec/lib/nrser/types/display_spec.rb

@@ -0,0 +1,50 @@
+require 'commonmarker'
+
+SPEC_FILE(
+  spec_path:        __FILE__,
+  module:           NRSER::Types,
+  description:      "Check examples in //lib/nrser/types/doc/display_table.md",
+) do
+  
+  path = NRSER::ROOT.join 'lib', 'nrser', 'types', 'doc', 'display_table.md'
+  source = path.read
+  doc = CommonMarker.render_doc source, :DEFAULT, [ :table ]
+
+  table_node = doc.walk.find { |node| node.type == :table }
+  
+  table_contents = table_node.each.map do |row|
+    row.each.map do |col|
+      col.first.string_content
+    end
+  end
+
+  table_header = table_contents[0]
+  table_body = table_contents[1..-1]
+
+  hashes = table_body.map { |row|
+    row.each_with_index.map { |contents, index|
+      [ table_header[index], contents ]
+    }.to_h
+  }
+
+  def t
+    NRSER::Types
+  end
+
+  hashes.each do |hash|
+    describe hash["source"] do
+      subject { eval hash["source"] }
+
+      hash.each do |col_name, value|
+        if col_name.start_with? '#'
+          method_name = col_name[1..-1].to_sym
+
+          describe_attr method_name do
+            it { is_expected.to eq value }
+          end
+        end
+      end
+    end
+  end
+
+end # SPEC_FILE

data/spec/lib/nrser/types/paths_spec.rb

@@ -1,10 +1,10 @@
-describe_spec_file(
+SPEC_FILE(
   spec_path: __FILE__,
   source_file: 'nrser/types/paths.rb',
   module: NRSER::Types,
 ) do
 
-  describe_method :dir_path do
+  METHOD :dir_path do
     include_examples 'make type',
       accepts: [
         '.',
@@ -20,10 +20,10 @@ describe_spec_file(
         Pathname.getwd => Pathname.getwd.to_s,
       }
       
-  end # method .dir_path
+  end # METHOD .dir_path
   
   
-  describe_method :file_path do
+  METHOD :file_path do
     
     include_examples 'make type',
       accepts: [
@@ -44,7 +44,7 @@ describe_spec_file(
         }
       }
     
-    context "custom name" do
+    WHEN "custom name" do
       include_examples 'make type',
         args: [ name: 'CustomType' ],
         
@@ -65,12 +65,12 @@ describe_spec_file(
             }
           }
         }
-    end # custom name
+    end # WHEN custom name
       
-  end # method .dir_path
+  end # METHOD .dir_path
   
   
-  describe_method :path_seg do
+  METHOD :path_seg do
     include_examples 'make type',
       accepts: [
         'hey',
@@ -89,6 +89,12 @@ describe_spec_file(
         }
       }
     
-  end # method .path_seg
+  end # METHOD .path_seg
+
+  
+  METHOD :tilde_path do
+    
+  end # METHOD .tilde_path Description
+
   
-end
+end # SPEC_FILE

data/spec/lib/nrser/types/selector_spec.rb

@@ -0,0 +1,125 @@
+require 'nrser/core_ext/symbol'
+
+require 'nrser/refinements/types'
+using NRSER::Types
+
+
+SPEC_FILE \
+  spec_path: __FILE__,
+  module: NRSER::Types,
+  method: :selector,
+  description: "Using selector types in Enumerable#select" \
+do
+  
+  data = [
+    {
+      item: "journal",
+      qty: 25,
+      size: { h: 14, w: 21, uom: "cm" },
+      status: "A",
+      groups: [ 'a', 'b' ]
+    },
+
+    {
+      item: "notebook",
+      qty: 50,
+      size: { h: 8.5, w: 11, uom: "in" },
+      status: "A",
+      groups: [ 'b', 'c' ],
+    },
+
+    {
+      item: "paper",
+      qty: 100,
+      size: { h: 8.5, w: 11, uom: "in" },
+      status: "D",
+      groups: [ 'a', 'c' ],
+    },
+
+    {
+      item: "planner",
+      qty: 75,
+      size: { h: 22.85, w: 30, uom: "cm" },
+      status: "D",
+      groups: [ 'd', 'e' ],
+    },
+
+    {
+      item: "postcard",
+      qty: 45,
+      size: { h: 10, w: 15.25, uom: "cm" },
+      status: "A",
+      groups: [ 'a' ],
+    },
+  ]
+
+  subject { data.select( &selector ).map( &[:item] ).to_set }
+
+  CASE "querying for group membership" do
+
+    WHEN "querying a single group",
+          selector: t[ groups: 'b' ] do
+      it { is_expected.to \
+            eq %w(journal notebook).to_set }; end
+  
+
+    # This *works*, but I don't think it's totally what I want...
+    WHEN "querying for members of any of a list of groups",
+          selector: \
+            t[ groups: ( t.has( 'b' ) | t.has( 'c' ) ) ] do
+      it { is_expected.to \
+            eq %w(journal notebook paper).to_set }; end
+
+
+    # Mongo style..? hard to find docs...
+    # 
+    # https://stackoverflow.com/a/34244908/
+    # https://docs.mongodb.com/manual/reference/operator/query/in/#use-the-in-operator-to-match-values-in-an-array
+    # 
+    # How it seems you would do it there:
+    # 
+    #     { groups: { $in: [ 'b', 'c', ] } }
+    # 
+    # but we already used "in" for the opposite thing.
+    # so for us how about:
+    # 
+    #     t[ groups: t.has_any( 'b', 'c' ) ]
+    # 
+    # Another possible name:
+    # 
+    #     t[ groups: t.intersects( 'b', 'c' ) ]
+    # 
+    # Variations:
+    # 
+    #     t[ groups: t.has_all( 'b', 'c' ) ]
+    #     
+    # To me right now this reads to me like you're asking if `groups` is "in"
+    # [ 'b', 'c' ] - which it's not.
+    # 
+    #     t[ groups: t.in( 'b', 'c' ) ]
+    #
+    WHEN "querying for members of any of a list of groups",
+          selector: \
+            t[ groups: t.has_any( 'b', 'c' ) ] do
+      it { is_expected.to \
+            eq %w(journal notebook paper).to_set }; end
+
+  end # USE CASE *************************************************************
+
+
+  WHEN selector: t[ status: 'D' ] do
+    it { is_expected.to eq %w(paper planner).to_set }; end
+
+
+  WHEN selector: t[ item: /^p/ ] do
+    it { is_expected.to eq Set[ 'paper', 'planner', 'postcard' ] }; end
+
+
+  WHEN "trying out a more complicated selector",
+        selector: \
+          ( t[ status: 'A' ] | t[ size: t[ w: 11 ] ] ) do
+    it { is_expected.to \
+          eq Set[ 'notebook', 'paper', 'journal', 'postcard' ] }; end
+
+
+end # SPEC FILE

data/spec/spec_helper.rb

@@ -25,6 +25,9 @@ require 'nrser/rspex'
 require_relative './support/shared'
 
 
+NRSER::Log.setup_for_rspec!
+
+
 RSpec.configure do |config|
   unless ENV['LABS']
     config.filter_run_excluding labs: true
@@ -44,11 +47,7 @@ end
 
 # Dumping ground for classes and modules that we need to create for tests.
 # 
-module NRSER::TestFixtures
-  
-  # module definition...
-  
-end # module NRSER::TestFixtures
+module NRSER::TestFixtures; end
 
 
 # Was a part of old {NRSER::Logger} testing, keeping for a minute to see if

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nrser
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.3.10
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-20 00:00:00.000000000 Z
+date: 2018-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hamster
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.7
+        version: 0.17.9
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.7
+        version: 0.17.9
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -162,76 +162,126 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.12
+        version: 0.9.15
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.12
+        version: 0.9.15
 - !ruby/object:Gem::Dependency
   name: github-markup
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: 2.0.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: 2.0.1
 - !ruby/object:Gem::Dependency
   name: yard-commonmarker
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.5.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.4
+        version: 0.11.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.4
+        version: 0.11.3
+- !ruby/object:Gem::Dependency
+  name: pry-rescue
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.5
+- !ruby/object:Gem::Dependency
+  name: pry-stack_explorer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.9
 - !ruby/object:Gem::Dependency
   name: cmds
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
-    - - ">="
+        version: 0.2.11
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.11
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.4
+        version: 1.8.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
-    - - ">="
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: mongo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.6.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.4
+        version: 2.6.1
 description: 
 email:
 - neil@neilsouza.com
@@ -266,11 +316,13 @@ files:
 - lib/nrser/core_ext/object/lazy_var.rb
 - lib/nrser/core_ext/open_struct.rb
 - lib/nrser/core_ext/pathname.rb
+- lib/nrser/core_ext/pathname/subpath.rb
 - lib/nrser/core_ext/string.rb
 - lib/nrser/core_ext/symbol.rb
 - lib/nrser/core_ext/time.rb
 - lib/nrser/core_ext/unbound_method/full_name.rb
 - lib/nrser/errors.rb
+- lib/nrser/errors/README.md
 - lib/nrser/errors/abstract_method_error.rb
 - lib/nrser/errors/argument_error.rb
 - lib/nrser/errors/attr_error.rb
@@ -301,11 +353,14 @@ files:
 - lib/nrser/functions/object/truthy.rb
 - lib/nrser/functions/open_struct.rb
 - lib/nrser/functions/path.rb
+- lib/nrser/functions/path/normalized.rb
 - lib/nrser/functions/proc.rb
 - lib/nrser/functions/string.rb
 - lib/nrser/functions/string/looks_like.rb
 - lib/nrser/functions/string/style.rb
 - lib/nrser/functions/text.rb
+- lib/nrser/functions/text/README.md
+- lib/nrser/functions/text/format.rb
 - lib/nrser/functions/text/indentation.rb
 - lib/nrser/functions/text/lines.rb
 - lib/nrser/functions/text/word_wrap.rb
@@ -317,6 +372,7 @@ files:
 - lib/nrser/functions/tree/map_leaves.rb
 - lib/nrser/functions/tree/map_tree.rb
 - lib/nrser/functions/tree/transform.rb
+- lib/nrser/gem_ext/README.md
 - lib/nrser/gem_ext/hamster.rb
 - lib/nrser/gem_ext/hamster/hash.rb
 - lib/nrser/gem_ext/hamster/set.rb
@@ -324,9 +380,15 @@ files:
 - lib/nrser/gem_ext/hamster/vector.rb
 - lib/nrser/graph/tsorter.rb
 - lib/nrser/labs.rb
+- lib/nrser/labs/README.md
+- lib/nrser/labs/config.rb
 - lib/nrser/labs/core_ext/binding.rb
 - lib/nrser/labs/globlin.rb
 - lib/nrser/labs/i8.rb
+- lib/nrser/labs/i8/struct.rb
+- lib/nrser/labs/i8/struct/hash.rb
+- lib/nrser/labs/i8/struct/vector.rb
+- lib/nrser/labs/i8/surjection.rb
 - lib/nrser/labs/index.rb
 - lib/nrser/labs/lots/consumer.rb
 - lib/nrser/labs/lots/parser.rb
@@ -345,6 +407,7 @@ files:
 - lib/nrser/mean_streak/document.rb
 - lib/nrser/message.rb
 - lib/nrser/meta.rb
+- lib/nrser/meta/README.md
 - lib/nrser/meta/class_attrs.rb
 - lib/nrser/meta/lazy_attr.rb
 - lib/nrser/meta/source/location.rb
@@ -395,12 +458,15 @@ files:
 - lib/nrser/sys/env.rb
 - lib/nrser/sys/env/path.rb
 - lib/nrser/types.rb
-- lib/nrser/types/any.rb
+- lib/nrser/types/README.md
 - lib/nrser/types/arrays.rb
-- lib/nrser/types/attrs.rb
+- lib/nrser/types/attributes.rb
 - lib/nrser/types/booleans.rb
 - lib/nrser/types/bounded.rb
+- lib/nrser/types/collections.rb
 - lib/nrser/types/combinators.rb
+- lib/nrser/types/doc/display_table.md
+- lib/nrser/types/eqiuvalent.rb
 - lib/nrser/types/errors/check_error.rb
 - lib/nrser/types/errors/from_string_error.rb
 - lib/nrser/types/factory.rb
@@ -416,10 +482,11 @@ files:
 - lib/nrser/types/pairs.rb
 - lib/nrser/types/paths.rb
 - lib/nrser/types/responds.rb
+- lib/nrser/types/selector.rb
 - lib/nrser/types/shape.rb
 - lib/nrser/types/strings.rb
 - lib/nrser/types/symbols.rb
-- lib/nrser/types/trees.rb
+- lib/nrser/types/top.rb
 - lib/nrser/types/tuples.rb
 - lib/nrser/types/type.rb
 - lib/nrser/types/when.rb
@@ -432,7 +499,10 @@ files:
 - spec/lib/nrser/core_ext/hash/short_transform_keys_spec.rb
 - spec/lib/nrser/core_ext/hash_spec.rb
 - spec/lib/nrser/core_ext/method/full_name_spec.rb
+- spec/lib/nrser/core_ext/pathname/subpath_spec.rb
 - spec/lib/nrser/errors/abstract_method_error_spec.rb
+- spec/lib/nrser/errors/attr_error_spec.rb
+- spec/lib/nrser/errors/count_error_spec.rb
 - spec/lib/nrser/functions/enumerable/associate_spec.rb
 - spec/lib/nrser/functions/enumerable/find_all_map_spec.rb
 - spec/lib/nrser/functions/enumerable/find_bounded_spec.rb
@@ -444,6 +514,7 @@ files:
 - spec/lib/nrser/functions/merge_by_spec.rb
 - spec/lib/nrser/functions/object/truthy_spec.rb
 - spec/lib/nrser/functions/open_struct_spec.rb
+- spec/lib/nrser/functions/path/normalize_path_spec.rb
 - spec/lib/nrser/functions/string/common_prefix_spec.rb
 - spec/lib/nrser/functions/string/looks_like_spec.rb
 - spec/lib/nrser/functions/text/dedent/gotchas_spec.rb
@@ -458,7 +529,9 @@ files:
 - spec/lib/nrser/functions/tree/transformer_spec.rb
 - spec/lib/nrser/gem_ext/hamster/json_spec.rb
 - spec/lib/nrser/gem_ext/hamster/to_mutable_spec.rb
+- spec/lib/nrser/labs/config_spec.rb
 - spec/lib/nrser/labs/globlin_spec.rb
+- spec/lib/nrser/labs/i8/struct_spec.rb
 - spec/lib/nrser/labs/index_spec.rb
 - spec/lib/nrser/mean_streak/design_spec.rb
 - spec/lib/nrser/mean_streak/identity_instance_spec.rb
@@ -482,9 +555,11 @@ files:
 - spec/lib/nrser/types/array_spec.rb
 - spec/lib/nrser/types/attrs_spec.rb
 - spec/lib/nrser/types/combinators_spec.rb
+- spec/lib/nrser/types/display_spec.rb
 - spec/lib/nrser/types/is_spec.rb
 - spec/lib/nrser/types/pairs_spec.rb
 - spec/lib/nrser/types/paths_spec.rb
+- spec/lib/nrser/types/selector_spec.rb
 - spec/lib/nrser/types/strings_spec.rb
 - spec/lib/nrser/types/symbols_spec.rb
 - spec/lib/nrser/types/tuples_spec.rb
@@ -513,7 +588,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.2
+rubygems_version: 2.5.2.3
 signing_key: 
 specification_version: 4
 summary: basic ruby utils i use in a lot of stuff.
@@ -525,7 +600,10 @@ test_files:
 - spec/lib/nrser/core_ext/hash/short_transform_keys_spec.rb
 - spec/lib/nrser/core_ext/hash_spec.rb
 - spec/lib/nrser/core_ext/method/full_name_spec.rb
+- spec/lib/nrser/core_ext/pathname/subpath_spec.rb
 - spec/lib/nrser/errors/abstract_method_error_spec.rb
+- spec/lib/nrser/errors/attr_error_spec.rb
+- spec/lib/nrser/errors/count_error_spec.rb
 - spec/lib/nrser/functions/enumerable/associate_spec.rb
 - spec/lib/nrser/functions/enumerable/find_all_map_spec.rb
 - spec/lib/nrser/functions/enumerable/find_bounded_spec.rb
@@ -537,6 +615,7 @@ test_files:
 - spec/lib/nrser/functions/merge_by_spec.rb
 - spec/lib/nrser/functions/object/truthy_spec.rb
 - spec/lib/nrser/functions/open_struct_spec.rb
+- spec/lib/nrser/functions/path/normalize_path_spec.rb
 - spec/lib/nrser/functions/string/common_prefix_spec.rb
 - spec/lib/nrser/functions/string/looks_like_spec.rb
 - spec/lib/nrser/functions/text/dedent/gotchas_spec.rb
@@ -551,7 +630,9 @@ test_files:
 - spec/lib/nrser/functions/tree/transformer_spec.rb
 - spec/lib/nrser/gem_ext/hamster/json_spec.rb
 - spec/lib/nrser/gem_ext/hamster/to_mutable_spec.rb
+- spec/lib/nrser/labs/config_spec.rb
 - spec/lib/nrser/labs/globlin_spec.rb
+- spec/lib/nrser/labs/i8/struct_spec.rb
 - spec/lib/nrser/labs/index_spec.rb
 - spec/lib/nrser/mean_streak/design_spec.rb
 - spec/lib/nrser/mean_streak/identity_instance_spec.rb
@@ -575,9 +656,11 @@ test_files:
 - spec/lib/nrser/types/array_spec.rb
 - spec/lib/nrser/types/attrs_spec.rb
 - spec/lib/nrser/types/combinators_spec.rb
+- spec/lib/nrser/types/display_spec.rb
 - spec/lib/nrser/types/is_spec.rb
 - spec/lib/nrser/types/pairs_spec.rb
 - spec/lib/nrser/types/paths_spec.rb
+- spec/lib/nrser/types/selector_spec.rb
 - spec/lib/nrser/types/strings_spec.rb
 - spec/lib/nrser/types/symbols_spec.rb
 - spec/lib/nrser/types/tuples_spec.rb