namo 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6841b3921358ce7eefdbfbdba3a62eafd74857223d9df86038f9cc8087bbb947
-  data.tar.gz: bf05398ce78ea49683fbb7adb0b9989c6d6df86864a9bdf2373b156b14d8d5e7
+  metadata.gz: a0cb29939a05de5108211f0d9f89b8c6b3cd0826433199f3f4014f1201a28fee
+  data.tar.gz: d628a872b860561da5c9f02867123864508c34c3311e7d9962457146226d1071
 SHA512:
-  metadata.gz: 2887c9dee76341b5e4ee75d50a1416475bd8c579d52117f67dcab81c9fe7c8cb1c50c08be7295db74aaf1f2d8727aa678b95d231d4c2e1d82a25b1ca050de61e
-  data.tar.gz: d5c5a35ac078d60dcd1baf43e73b5be1aa1bf02ed27a65071fd146223402a812a8b9ff9b88e6be5e4e62b5b47966460df613994d79215405439cde96c1a63278
+  metadata.gz: 72b7db10583b8316b0e727b4af8404c2069533049c40e83a3974841b8a1822139898922492f721e31328632b32582c8795a50fb9a53262bee04fa5bc75672713
+  data.tar.gz: b269559c27dd1999ba2c3fb638c85abc0ee22530d984ffe620b2ac9e3fa1726655ac7c7d26c96273baf1bd1396df6ff0eeaeaf7c4e71753aee588eabdb09417f

data/CHANGELOG

@@ -1,6 +1,17 @@
 CHANGELOG
 _________
 
+20260415
+0.3.0: + contraction
+
+1. + Namo::NegatedDimension: Wrapper for negated dimension names used in contraction.
+2. + Symbol#-@: Produce a NegatedDimension, enabling -:date syntax.
+3. ~ Namo#[]: Extend to recognise NegatedDimension for contraction (remove named dimensions, keep everything else). Raise ArgumentError when mixing projection and contraction.
+4. > Namo::Row: Extract to Namo/Row.rb.
+5. ~ namo_test.rb: Add tests for contraction, mixed-mode error, and contraction with selection and formulae. Split tests into one file per class: Row_test.rb, NegatedDimension_test.rb, Symbol_test.rb.
+6. ~ README.md: + Contraction section
+7. ~ Namo::VERSION: /0.2.0/0.3.0/
+
 20260414
 0.2.0: Include Enumerable.
 

data/README.md

@@ -111,7 +111,47 @@ sales[:quarter, :price, product: 'Widget']
 # ]>
 ```
 
-Selection and projection always return a new Namo instance, so everything chains.
+### Contraction
+
+Contraction is the complement of projection. Projection says "keep these dimensions"; contraction says "remove these dimensions, keep everything else":
+
+```ruby
+sales[-:price, -:quantity]
+# => #<Namo [
+#   {product: 'Widget', quarter: 'Q1'},
+#   {product: 'Widget', quarter: 'Q2'},
+#   {product: 'Gadget', quarter: 'Q1'},
+#   {product: 'Gadget', quarter: 'Q2'}
+# ]>
+```
+
+The `-:price` syntax uses unary minus on Symbol to produce a negated dimension. Mixing projection and contraction in the same call is an error — the two modes are mutually exclusive:
+
+```ruby
+sales[:product, -:price]  # => ArgumentError
+```
+
+Selection and contraction can be chained:
+
+```ruby
+sales[product: 'Widget'][-:price, -:quantity]
+# => #<Namo [
+#   {product: 'Widget', quarter: 'Q1'},
+#   {product: 'Widget', quarter: 'Q2'}
+# ]>
+```
+
+Or combined in a single call (names before selectors):
+
+```ruby
+sales[-:price, -:quantity, product: 'Widget']
+# => #<Namo [
+#   {product: 'Widget', quarter: 'Q1'},
+#   {product: 'Widget', quarter: 'Q2'}
+# ]>
+```
+
+Selection, projection, and contraction always return a new Namo instance, so everything chains.
 
 ### Formulae
 

data/lib/Namo/NegatedDimension.rb

@@ -0,0 +1,14 @@
+# Namo/NegatedDimension.rb
+# Namo::NegatedDimension
+
+class Namo
+  class NegatedDimension
+    attr_reader :name
+
+    private
+
+    def initialize(name)
+      @name = name
+    end
+  end
+end

data/lib/Namo/Row.rb

@@ -0,0 +1,36 @@
+# Namo/Row.rb
+# Namo::Row
+
+class Namo
+  class Row
+    def [](name)
+      if @formulae.key?(name)
+        @formulae[name].call(self)
+      else
+        @row[name]
+      end
+    end
+
+    def match?(selections)
+      selections.all? do |dimension, coordinate|
+        case coordinate
+        when Array, Range
+          coordinate.include?(self[dimension])
+        else
+          self[dimension] == coordinate
+        end
+      end
+    end
+
+    def to_h
+      @row
+    end
+
+    private
+
+    def initialize(row, formulae)
+      @row = row
+      @formulae = formulae
+    end
+  end
+end

data/lib/Namo/VERSION.rb

@@ -2,5 +2,5 @@
 # Namo::VERSION
 
 class Namo
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/Symbol.rb

@@ -0,0 +1,8 @@
+# Symbol.rb
+# Symbol#-@
+
+class Symbol
+  def -@
+    Namo::NegatedDimension.new(self)
+  end
+end

data/lib/namo.rb

@@ -1,41 +1,13 @@
 # namo.rb
 # Namo
 
+require_relative 'Namo/NegatedDimension'
+require_relative 'Namo/Row'
+require_relative 'Symbol'
+
 class Namo
   include Enumerable
 
-  class Row
-    def [](name)
-      if @formulae.key?(name)
-        @formulae[name].call(self)
-      else
-        @row[name]
-      end
-    end
-
-    def match?(selections)
-      selections.all? do |dimension, coordinate|
-        case coordinate
-        when Array, Range
-          coordinate.include?(self[dimension])
-        else
-          self[dimension] == coordinate
-        end
-      end
-    end
-
-    def to_h
-      @row
-    end
-
-    private
-
-    def initialize(row, formulae)
-      @row = row
-      @formulae = formulae
-    end
-  end
-
   attr_accessor :data
   attr_accessor :formulae
 
@@ -53,16 +25,26 @@ class Namo
 
   def [](*names, **selections)
     rows = selections.any? ? select{|row| row.match?(selections)} : entries
-    data = (
-      if names.any?
+    negated, positive = names.partition{|n| n.is_a?(NegatedDimension)}
+    if negated.any? && positive.any?
+      raise ArgumentError, "cannot mix projection and contraction in a single call"
+    end
+    projected = (
+      if negated.any?
+        excluded = negated.map(&:name)
+        kept = dimensions - excluded
+        rows.map do |row|
+          kept.each_with_object({}){|name, hash| hash[name] = row[name]}
+        end
+      elsif positive.any?
         rows.map do |row|
-          names.each_with_object({}){|name, hash| hash[name] = row[name]}
+          positive.each_with_object({}){|name, hash| hash[name] = row[name]}
         end
       else
         rows.map(&:to_h)
       end
     )
-    self.class.new(data, formulae: @formulae.dup)
+    self.class.new(projected, formulae: @formulae.dup)
   end
 
   def []=(name, proc)

data/namo.gemspec

@@ -1,5 +1,11 @@
 require_relative './lib/Namo/VERSION'
 
+class Gem::Specification
+  def development_dependencies=(gems)
+    gems.each{|gem| add_development_dependency(*gem)}
+  end
+end
+
 Gem::Specification.new do |spec|
   spec.name = 'namo'
   spec.version = Namo::VERSION
@@ -13,20 +19,23 @@ Gem::Specification.new do |spec|
   spec.license = 'MIT'
 
   spec.required_ruby_version = '>= 2.7'
+
   spec.require_paths = ['lib']
 
   spec.files = [
+    'namo.gemspec',
     'CHANGELOG',
     'Gemfile',
-    Dir['lib/**/*.rb'],
     'LICENSE',
-    'namo.gemspec',
     'Rakefile',
     'README.md',
+    Dir['lib/**/*.rb'],
     Dir['test/**/*.rb'],
   ].flatten
 
-  spec.add_development_dependency 'minitest'
-  spec.add_development_dependency 'minitest-spec-context'
-  spec.add_development_dependency 'rake'
+  spec.development_dependencies = %w{
+    minitest
+    minitest-spec-context
+    rake
+  }
 end

data/test/Namo/NegatedDimension_test.rb

@@ -0,0 +1,13 @@
+require 'minitest/autorun'
+require 'minitest-spec-context'
+
+require_relative '../../lib/namo'
+
+describe Namo::NegatedDimension do
+  describe "#name" do
+    it "returns the original symbol" do
+      nd = Namo::NegatedDimension.new(:price)
+      _(nd.name).must_equal :price
+    end
+  end
+end

data/test/Namo/Row_test.rb

@@ -0,0 +1,69 @@
+require 'minitest/autorun'
+require 'minitest-spec-context'
+
+require_relative '../../lib/namo'
+
+describe Namo::Row do
+  let(:row_data) do
+    {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100}
+  end
+
+  let(:formulae) do
+    {}
+  end
+
+  let(:row) do
+    Namo::Row.new(row_data, formulae)
+  end
+
+  describe "#[]" do
+    it "returns raw data by dimension name" do
+      _(row[:product]).must_equal 'Widget'
+      _(row[:price]).must_equal 10.0
+    end
+
+    it "returns nil for missing dimensions" do
+      _(row[:missing]).must_be_nil
+    end
+
+    it "resolves formulae over raw data" do
+      formulae[:revenue] = proc{|r| r[:price] * r[:quantity]}
+      _(row[:revenue]).must_equal 1000.0
+    end
+
+    it "composes formulae" do
+      formulae[:revenue] = proc{|r| r[:price] * r[:quantity]}
+      formulae[:cost] = proc{|r| r[:quantity] * 4.0}
+      formulae[:profit] = proc{|r| r[:revenue] - r[:cost]}
+      _(row[:profit]).must_equal 600.0
+    end
+  end
+
+  describe "#match?" do
+    it "matches a single value" do
+      _(row.match?(product: 'Widget')).must_equal true
+      _(row.match?(product: 'Gadget')).must_equal false
+    end
+
+    it "matches an array of values" do
+      _(row.match?(product: ['Widget', 'Gadget'])).must_equal true
+      _(row.match?(product: ['Gadget'])).must_equal false
+    end
+
+    it "matches a range" do
+      _(row.match?(price: 5.0..15.0)).must_equal true
+      _(row.match?(price: 20.0..30.0)).must_equal false
+    end
+
+    it "matches multiple dimensions" do
+      _(row.match?(product: 'Widget', quarter: 'Q1')).must_equal true
+      _(row.match?(product: 'Widget', quarter: 'Q2')).must_equal false
+    end
+  end
+
+  describe "#to_h" do
+    it "returns the underlying row hash" do
+      _(row.to_h).must_equal row_data
+    end
+  end
+end

data/test/{namo_test.rb → Namo_test.rb}

@@ -85,6 +85,53 @@ describe Namo do
         _(result.to_a).must_equal [{price: 10.0}, {price: 10.0}]
       end
     end
+
+    context "contraction" do
+      it "removes named dimensions" do
+        result = sales[-:price, -:quantity]
+        _(result.dimensions).must_equal [:product, :quarter]
+        _(result.to_a.count).must_equal 4
+        _(result.to_a.first).must_equal({product: 'Widget', quarter: 'Q1'})
+      end
+
+      it "removes a single dimension" do
+        result = sales[-:price]
+        _(result.dimensions).must_equal [:product, :quarter, :quantity]
+        _(result.to_a.count).must_equal 4
+      end
+
+      it "raises when mixing projection and contraction" do
+        _ { sales[:product, -:price] }.must_raise ArgumentError
+      end
+
+      it "carries formulae through contraction" do
+        sales[:label] = proc{|r| "#{r[:product]}-#{r[:quarter]}"}
+        result = sales[-:price, -:quantity]
+        _(result.map{|row| row[:label]}).must_equal [
+          'Widget-Q1', 'Widget-Q2', 'Gadget-Q1', 'Gadget-Q2'
+        ]
+      end
+    end
+
+    context "selection and contraction" do
+      it "can use them together" do
+        result = sales[-:price, -:quantity, product: 'Widget']
+        _(result.to_a.count).must_equal 2
+        _(result.to_a).must_equal [
+          {product: 'Widget', quarter: 'Q1'},
+          {product: 'Widget', quarter: 'Q2'}
+        ]
+      end
+
+      it "can chain them" do
+        result = sales[product: 'Widget'][-:price, -:quantity]
+        _(result.to_a.count).must_equal 2
+        _(result.to_a).must_equal [
+          {product: 'Widget', quarter: 'Q1'},
+          {product: 'Widget', quarter: 'Q2'}
+        ]
+      end
+    end
   end
 
   describe "#[]= formulae" do

data/test/Symbol_test.rb

@@ -0,0 +1,16 @@
+require 'minitest/autorun'
+require 'minitest-spec-context'
+
+require_relative '../lib/namo'
+
+describe Symbol do
+  describe "#-@" do
+    it "returns a NegatedDimension" do
+      _(-:price).must_be_kind_of Namo::NegatedDimension
+    end
+
+    it "preserves the symbol name" do
+      _((-:price).name).must_equal :price
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namo
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - thoran
@@ -64,10 +64,16 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- lib/Namo/NegatedDimension.rb
+- lib/Namo/Row.rb
 - lib/Namo/VERSION.rb
+- lib/Symbol.rb
 - lib/namo.rb
 - namo.gemspec
-- test/namo_test.rb
+- test/Namo/NegatedDimension_test.rb
+- test/Namo/Row_test.rb
+- test/Namo_test.rb
+- test/Symbol_test.rb
 homepage: https://github.com/thoran/namo
 licenses:
 - MIT