namo 0.31.4 → 0.31.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a5b005cb03bb42a9a9319632833f382a8ae2480ce04160f326a831f534da50a
-  data.tar.gz: f344e285a0d457af4ad633c98a33aab02cefe49fd273251ad9bdc7bdd3d98afa
+  metadata.gz: 77e56d154536ec5ebde8dbb2d660277007a76d4ec108c6b669ff96399f9991d7
+  data.tar.gz: 79baaf53cfd3417b5db049b7c2ea6701c60580e97f41235bcafb91538c49d427
 SHA512:
-  metadata.gz: 8025bdb29748fc3076649dc59a38139075c03a9692c5c684295cb5060334e8e8c0c45dea9001dd942d68d0e3302910464c9141157a42d61af85eb751420bf0d8
-  data.tar.gz: 8fc50fc83aab71b68cb6e70dc4178e95dc8e2f3e6983480ccbcc4553915b61dde52f00cf8d2f1570988d5129df7e0534b13db8b3dc7413602d1fefc64b694613
+  metadata.gz: ffa93bb4ad5f35eaffcefa76778dbffc843bc24a95130327d4da88e8ae8e3103fdc6a28a2eabaf0f38b996b768e6125f7e1538612ac8c922e0bb7c495870f128
+  data.tar.gz: 24e8d924c61152922e757ab30b87662cede03e6dcb85dbb2cd964de4b9230ee4d65617e74760b7e37a3d8831dd332c3f46e829adfbaa82cf275f2a9108528558

data/CHANGELOG

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+## 20260826
+
+0.31.5: ~ Namo::Collection#detail, #as_detail: the detail view carries the members' formulae.
+
+1. ~ Namo::Collection#detail: the returned Namo carries the members' formulae, folded in member order so that a later member wins a name collision, as a later member wins a collision of names in <<. It had been built with none, so the view documented at 0.18.0 as the lossless union of the members' rows dropped every derived dimension: group_by hands each member the source's formulae, and detail handed them back stripped.
+2. ~ Namo::Collection#as_detail: merges the detail view's formulae into the Collection's own, the Collection having become that view. Without it the round trip still lost them, as_detail having taken only the data.
+3. ~ script/demo: the collections section checks the round trip with === rather than ==, == comparing row multisets alone and so unable to see the formulae go missing, which is why this stood.
+4. ~ README.md: the four views, on which of them carries formulae and why.
+5. ~ ROADMAP.md: + 0.31.5.
+6. ~ Namo::VERSION: /0.31.4/0.31.5/
+
+
 ## 20260826
 
 0.31.4: ~ Namo::Collection#inspect: the members are rendered, nested under their names.

data/README.md

@@ -1121,6 +1121,8 @@ Detail is the lazy view because a Collection's rows simply *are* its members' ro
 
 #### Four view methods
 
+`detail` carries the members' formulae, its rows being the members' rows — folded in member order, so a later member wins a name collision as it wins a collision of names in `<<`. A `summary`'s rows are reductions, holding neither the dimensions those formulae read nor the rows they read them from, so it carries none.
+
 The views come in a non-mutating pair and a mutating pair:
 
 - `summary(dimension = nil, by:, reducer:, &block)` and `detail(by:)` are **non-mutating** — each returns a fresh `Namo` derived from the members, leaving the Collection untouched. Use these when you want a view to keep: assign the result to a variable and operate on it independently.

data/lib/Namo/Collection.rb

@@ -42,7 +42,7 @@ class Namo
           member.data.map{|row| row.key?(by) ? row : row.merge(by => member.name)}
         end
       )
-      Namo.new(rows)
+      Namo.new(rows, formulae: member_formulae)
     end
 
     def as_summary(dimension = nil, by: :member, reducer: :sum, &block)
@@ -52,7 +52,9 @@ class Namo
 
     def as_detail(positional_by = nil, by: :member)
       by = positional_by || by
-      @data = detail(by).data
+      view = detail(by)
+      @data = view.data
+      @formulae = @formulae.merge(view.formulae)
       self
     end
 
@@ -70,6 +72,15 @@ class Namo
 
     private
 
+    # The members' formulae, folded in member order so that a later member wins a
+    # name collision, as a later member wins a collision of names in <<.  The
+    # detail view is the members' rows, so it must be able to answer what the
+    # members can answer of them; group_by hands every member the same formulae,
+    # so only an assembled Collection can have members which disagree.
+    def member_formulae
+      @members.map(&:formulae).reduce(Formulae.new){|merged, formulae| merged.merge(formulae)}
+    end
+
     def inspected_members
       return '[]' if @members.empty?
       shown = [@members.length, INSPECTED_ROWS].min

data/lib/Namo/VERSION.rb

@@ -2,5 +2,5 @@
 # Namo::VERSION
 
 class Namo
-  VERSION = '0.31.4'
+  VERSION = '0.31.5'
 end

data/test/Namo/Collection_test.rb

@@ -347,6 +347,48 @@ describe Namo::Collection do
     end
   end
 
+  describe "the detail view and its formulae" do
+    def readings
+      namo = Namo.new([
+        {station: "Melbourne", month: "2025-01", high_temp: 26.4, mean_temp: 25.9},
+        {station: "Perth", month: "2025-01", high_temp: 32.0, mean_temp: 30.0}])
+      namo[:anomaly] = proc{|row| (row[:high_temp] - row[:mean_temp]).round(1)}
+      namo
+    end
+
+    it "carries the members' formulae, the view being the members' rows" do
+      _(readings.group_by(:station).detail(:station).derived_dimensions).must_equal [:anomaly]
+    end
+
+    it "answers a derived dimension through the detail view" do
+      _(readings.group_by(:station).detail(:station).values(:anomaly)).must_equal [0.5, 2.0]
+    end
+
+    # == compares row multisets and cannot see a formula go missing, so it called
+    # the partition exact while the derived dimensions were being dropped.  === is
+    # the operator which compares the formula names too.
+    it "inverts the partition exactly, formulae and all" do
+      source = readings
+      _(source.group_by(:station).as_detail(:station)).must_be :===, source
+    end
+
+    it "folds the members' formulae, a later member winning the name" do
+      first = Namo.new([{a: 1}], name: :first)
+      first[:b] = proc{|row| :from_first}
+      second = Namo.new([{a: 2}], name: :second)
+      second[:b] = proc{|row| :from_second}
+      collection = Namo::Collection.new
+      collection << first << second
+      _(collection.detail.values(:b)).must_equal [:from_second, :from_second]
+    end
+
+    # A summary's rows are reductions, holding neither the dimensions the members'
+    # formulae read nor the rows they read them from, so it carries none.
+    it "leaves the summary without them" do
+      _(readings.group_by(:station).summary(:high_temp).derived_dimensions).must_equal []
+    end
+  end
+
   describe "#inspect" do
     def collection_of(members, rows_each)
       rows = (1..members).flat_map{|member| (1..rows_each).map{|row| {group: "g#{member}", n: row}}}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namo
 version: !ruby/object:Gem::Version
-  version: 0.31.4
+  version: 0.31.5
 platform: ruby
 authors:
 - thoran