namo 0.31.1 → 0.31.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5235177577fcae1dd01a8a3172fc3933e77a5483f123ba6f436bd58a6eca68e
-  data.tar.gz: b2c023063fa95cca3f6ec38f324a116bf013339003d4051338a7c84b57251944
+  metadata.gz: 820a3c18db30a81cef333ad6b6bd95cd3129610d8d237a0a4f14554d23bdd2e9
+  data.tar.gz: 8b0c94985ae46c47e8b129eecd7fe7eba7d30f499aea917b2c9e80b1edf2ad7c
 SHA512:
-  metadata.gz: 3278fdcba0888a5899930abb399c3cc3b1aff49d7bb27ceefc223524c4247cb4c85ca0274ba58254965229e9cec131c014a544fce61444e8d6e34221896047e5
-  data.tar.gz: 94cdb60c0bc852b456ded744a63f8e7fda0dbf884d2ff085b0908cfb80d26f48588b4254b7d389cb68b4bce0f668d3a528ce5eeba22bd80ea4a50331c6ccb2e8
+  metadata.gz: a5631205eb63c196e4ba9d6b8cf5bf54807e61a462e55645e216aeb5515d767934413c226a0cb567ae0637002e6c3a80a3490c6db7c94397ae17da2c42ae8c8f
+  data.tar.gz: 829d09221f044a4572ff7b97bc76c3a84cd7c8ce8e9e2ee8656b2ac5c82a3753d2f793223bdf3125a0e22d925bf86e19078680b78d6dcde7077248aef7488740

data/CHANGELOG

@@ -2,6 +2,14 @@
 
 ## 20260824
 
+0.31.2: ~ Namo#inspect: the derived: suffix names only what the rows do not carry.
+
+1. ~ Namo#inspect: the derived: suffix names only the derived dimensions the rendered rows do not already carry, and is omitted where they all do. A formula which raises, a parameterised one which cannot be materialised without its arguments, and any formula on a Namo with no rows to render, are named as before, being nowhere else in the output. Namo::Collection renders no rows and so names every one of its own. Namo::Row is unchanged, naming its formulae in every case.
+2. ~ README.md: the Inspection output section, and the block whose suffix goes.
+3. ~ ROADMAP.md: + 0.31.2.
+4. ~ Namo::VERSION: /0.31.1/0.31.2/
+
+
 0.31.1: ~ Namo#inspect, Namo::Row#inspect: derived dimensions render their values.
 
 1. ~ Namo#inspect: a derived dimension renders with its value, in among the stored ones, rather than being named only. Where there is no value to show it is omitted and the derived: suffix names it alone: a formula which raises, and a parameterised one which cannot be materialised without its arguments.

data/README.md

@@ -972,7 +972,7 @@ sales[:product, :quarter, :revenue].to_h
 
 ### Inspection output
 
-`inspect` renders the class, the stored rows with any derived dimensions among them, and the names of those derived dimensions:
+`inspect` renders the class and the stored rows, with any derived dimensions among them:
 
 ```ruby
 sales.inspect
@@ -981,18 +981,20 @@ sales.inspect
 #   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150, revenue: 1500.0},
 #   {product: "Gadget", quarter: "Q1", price: 25.0, quantity: 40, revenue: 1000.0},
 #   {product: "Gadget", quarter: "Q2", price: 25.0, quantity: 60, revenue: 1500.0}
-# ] derived: [:revenue]>
+# ]>
 ```
 
 A name, where the Namo carries one, follows the class: `#<Namo :sales [`. A subclass reports its own name in place of `Namo`.
 
-A derived dimension shows its value, in among the stored ones, and the `derived:` suffix names which of the keys are computed. Where there is no value to show it is omitted rather than the rendering failing: a formula which raises, and a parameterised one which cannot be materialised without its arguments, each render nothing and are named by the suffix alone.
+A derived dimension shows its value, in among the stored ones, so a computed dimension renders exactly as a stored one does — which is the claim the library makes about it. Where there is no value to show, the rendering omits it rather than failing, and the `derived:` suffix names it: a formula which raises, a parameterised one which cannot be materialised without its arguments, and any formula at all on a Namo with no rows to render.
+
+The suffix carries only those. Where every derived dimension rendered a value it has nothing left to say and does not appear. Ask `derived_dimensions` when you want the distinction named.
 
 Evaluation is bounded by the row cap rather than by the data — at most ten rows are rendered, so at most ten evaluations per formula. A collection-scoped formula makes each of those a pass over the Namo, so inspecting a large one that carries such a formula is not free.
 
 Rows beyond `Namo::INSPECTED_ROWS` — ten — are elided with a count of the remainder, so the output stays bounded however large the data: a thousand-row Namo renders its first ten rows and then `... 990 more rows`.
 
-A `Row` renders itself, its derived values and its formula names, never the Namo it came from. A `Collection` renders its member names and its row count, the members being its substance and the data view derived from them.
+A `Row` renders itself, its derived values and its formula names in every case, having no `derived_dimensions` of its own to be asked, and never the Namo it came from. A `Collection` renders its member names and its row count, the members being its substance and the data view derived from them.
 
 ```ruby
 sales.first

data/lib/Namo/VERSION.rb

@@ -2,5 +2,5 @@
 # Namo::VERSION
 
 class Namo
-  VERSION = '0.31.1'
+  VERSION = '0.31.2'
 end

data/lib/namo.rb

@@ -250,7 +250,8 @@ class Namo
   end
 
   def inspect
-    "#<#{self.class}#{inspected_name}#{inspected_rows}#{inspected_derived}>"
+    rendered = @data.first(INSPECTED_ROWS).map{|row| [row, inspected_derivations(row)]}
+    "#<#{self.class}#{inspected_name}#{inspected_rows(rendered)}#{inspected_derived(rendered)}>"
   end
 
   protected
@@ -278,17 +279,13 @@ class Namo
   # The rows as they are stored, never the derived values: inspect is called
   # for every result in a console, and evaluating a formula there would cost a
   # pass over the data per access and raise whatever the formula raises.
-  def inspected_rows
+  def inspected_rows(rendered)
     return ' []' if @data.empty?
-    shown = @data.first(INSPECTED_ROWS).map{|row| "  #{inspected_row(row)}"}.join(",\n")
+    shown = rendered.map{|row, derived| "  #{row.merge(derived).inspect}"}.join(",\n")
     shown += "\n  ... #{@data.length - INSPECTED_ROWS} more rows" if @data.length > INSPECTED_ROWS
     " [\n#{shown}\n]"
   end
 
-  def inspected_row(row)
-    row.merge(inspected_derivations(row)).inspect
-  end
-
   # A derived dimension is shown with its value, in among the stored ones.  A
   # formula wanting arguments has no value to show without them, and one which
   # raises has none to show either; the derived list still names both.
@@ -302,8 +299,15 @@ class Namo
     end
   end
 
-  def inspected_derived
-    derived_dimensions.empty? ? '' : " derived: #{derived_dimensions.inspect}"
+  # Only those the rows above do not already carry.  A formula which raises, and a
+  # parameterised one which cannot be materialised without its arguments, render
+  # no value and would otherwise be nowhere in the output at all.  A Collection
+  # renders no rows and so passes none, naming every one of them.
+  def inspected_derived(rendered = [])
+    unshown = derived_dimensions.reject do |dimension|
+      rendered.any? && rendered.all?{|_, derived| derived.key?(dimension)}
+    end
+    unshown.empty? ? '' : " derived: #{unshown.inspect}"
   end
 
   def initialize(positional_data = nil, data: [], formulae: {}, name: nil)

data/test/namo_test.rb

@@ -3234,13 +3234,19 @@ describe Namo do
     it "shows a derived dimension with its value, in among the stored ones" do
       namo = Namo.new([{a: 1}])
       namo[:b] = proc{|row| row[:a] + 1}
-      _(namo.inspect).must_equal "#<Namo [\n  {a: 1, b: 2}\n] derived: [:b]>"
+      _(namo.inspect).must_equal "#<Namo [\n  {a: 1, b: 2}\n]>"
     end
 
     it "shows a collection-scoped derived value" do
       namo = Namo.new([{a: 1}, {a: 2}])
       namo[:total] = proc{|row, namo| namo.values(:a).sum}
-      _(namo.inspect).must_equal "#<Namo [\n  {a: 1, total: 3},\n  {a: 2, total: 3}\n] derived: [:total]>"
+      _(namo.inspect).must_equal "#<Namo [\n  {a: 1, total: 3},\n  {a: 2, total: 3}\n]>"
+    end
+
+    it "names a derived dimension on a Namo with no rows, there being nowhere else to learn of it" do
+      namo = Namo.new([])
+      namo[:b] = proc{|row| row[:a] + 1}
+      _(namo.inspect).must_equal "#<Namo [] derived: [:b]>"
     end
 
     it "names a derived dimension whose formula raises, without a value" do

metadata

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