namo 0.30.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6f9ea9ed29bd86c309865e0c49d03122b7fa50460e34fd7a42a9a273bb220c0
-  data.tar.gz: 99d5e8191c3458b498c6fe297c2af8b94d8bb73aced942d9f3da67af94ace454
+  metadata.gz: 1241332321c6f9d7643932d1b53949bfb12eb8596b1e388c206a9fad705efaf7
+  data.tar.gz: 00c558afd1fe979599820a39539f3216b496557a69f94229a59fc45c48cfd062
 SHA512:
-  metadata.gz: 9e4aca2b13be76dc10a2fcf3eb7122045e600b1ed2410c2f6e82554c7dfc679249bf714fc52939fd4ee058fa6925b1958935bd91281dbf67f48634aec4cd4ea9
-  data.tar.gz: d3432cb0f092521adb1e2f60dccbc5b37aff2e4f91511189300b0693d374124e76cf1fde57d64709606ea504aae5db85d9c47e7aba99efcfdfa68b6fcbc38eef
+  metadata.gz: 74b61473e59179fcd559d52eb98435ab9127499c17403174c1505f5076d1c6d2dd1f829ea8a69403da948709d047d42603bb1fd6bc32205bfb1bb3b0459d47c8
+  data.tar.gz: c9690afd20a5ab0de834d9dcca3b2a310e4da3e4811b0a29545e60290f1cb62f7571e8c177bacd405b380e8bfe6f78358a075c9c2eb5a4519654843c90ddaf5a

data/CHANGELOG

@@ -1,5 +1,26 @@
 # CHANGELOG
 
+## 20260822
+
+0.31.0: + Namo#inspect, Namo::Collection#inspect, Namo::Row#inspect, and Namo::Formulae#inspect.
+
+1. + Namo#inspect: the class, the name where there is one, the stored rows, and the derived dimension names — the form the README has shown since 0.0.0 and the code has never produced. Rows beyond Namo::INSPECTED_ROWS are elided with a count of what is left, so the output no longer grows with the data.
+2. + Namo::Row#inspect: the row and its formula names. It had been rendering @namo, so asking a 1,000-row Namo for one row emitted more output than inspecting the whole Namo.
+3. + Namo::Collection#inspect: the member names and the row count, the members being the substance and the data view derived from them.
+4. + Namo::Formulae#inspect: the formula names, never the callables.
+5. + README.md: an Inspection output section, covering the rendered form, the naming of derived dimensions, and the row cap.
+6. ~ README.md: the inspect-output blocks requoted from single to double quotes, as Hash#inspect emits, and the two projections that carry formulae given their derived: suffix. The blocks had been hand-written before there was an inspect to copy from.
+7. ~ Namo::VERSION: /0.30.1/0.31.0/
+
+
+## 20260819
+
+0.30.1: ~ namo.gemspec: spec.files reordered, the globs first.
+
+1. ~ namo.gemspec: spec.files reordered, the two Dir globs first and the loose files alphabetically after them, as moby and measurand have it. The globs are what the gem is and the rest is paperwork, so adding a file to the paperwork now never disturbs them. This gemspec had been pinned first with the globs last, which http shared and impuri left at its 0.12.1. The same 21 files ship, in the same gem; only the order in the source changes.
+2. ~ Namo::VERSION: /0.30.0/0.30.1/
+
+
 ## 20260715
 
 0.30.0: Assemble Collection objects in a single pass when doing Namo::Enumerable#group_by.

data/README.md

@@ -66,42 +66,42 @@ Select by named dimension using keyword arguments:
 # Single value
 sales[product: 'Widget']
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150}
 # ]>
 
 # Multiple dimensions
 sales[product: 'Widget', quarter: 'Q1']
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100}
 # ]>
 
 # Range
 sales[price: 10.0..20.0]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150}
 # ]>
 
 # Array of values
 sales[quarter: ['Q1']]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Gadget', quarter: 'Q1', price: 25.0, quantity: 40}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Gadget", quarter: "Q1", price: 25.0, quantity: 40}
 # ]>
 
 # Proc predicate
 sales[price: ->(v){v < 20.0}]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150}
 # ]>
 
 # Regex predicate
 sales[product: /^W/]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150}
 # ]>
 ```
 
@@ -110,7 +110,7 @@ Procs receive the dimension value and select the row when they return truthy. Th
 ```ruby
 sales[price: ->(v){v < 20.0}, quantity: ->(v){v > 100}]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150}
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150}
 # ]>
 ```
 
@@ -131,10 +131,10 @@ Project to specific dimensions:
 ```ruby
 sales[:product, :price]
 # => #<Namo [
-#   {product: 'Widget', price: 10.0},
-#   {product: 'Widget', price: 10.0},
-#   {product: 'Gadget', price: 25.0},
-#   {product: 'Gadget', price: 25.0}
+#   {product: "Widget", price: 10.0},
+#   {product: "Widget", price: 10.0},
+#   {product: "Gadget", price: 25.0},
+#   {product: "Gadget", price: 25.0}
 # ]>
 ```
 
@@ -143,8 +143,8 @@ Selection and projection can be chained:
 ```ruby
 sales[product: 'Widget'][:quarter, :price]
 # => #<Namo [
-#   {quarter: 'Q1', price: 10.0},
-#   {quarter: 'Q2', price: 10.0}
+#   {quarter: "Q1", price: 10.0},
+#   {quarter: "Q2", price: 10.0}
 # ]>
 ```
 
@@ -153,8 +153,8 @@ Or combined in a single call (names before selectors):
 ```ruby
 sales[:quarter, :price, product: 'Widget']
 # => #<Namo [
-#   {quarter: 'Q1', price: 10.0},
-#   {quarter: 'Q2', price: 10.0}
+#   {quarter: "Q1", price: 10.0},
+#   {quarter: "Q2", price: 10.0}
 # ]>
 ```
 
@@ -165,10 +165,10 @@ Contraction is the complement of projection. Projection says "keep these dimensi
 ```ruby
 sales[-:price, -:quantity]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1'},
-#   {product: 'Widget', quarter: 'Q2'},
-#   {product: 'Gadget', quarter: 'Q1'},
-#   {product: 'Gadget', quarter: 'Q2'}
+#   {product: "Widget", quarter: "Q1"},
+#   {product: "Widget", quarter: "Q2"},
+#   {product: "Gadget", quarter: "Q1"},
+#   {product: "Gadget", quarter: "Q2"}
 # ]>
 ```
 
@@ -183,8 +183,8 @@ Selection and contraction can be chained:
 ```ruby
 sales[product: 'Widget'][-:price, -:quantity]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1'},
-#   {product: 'Widget', quarter: 'Q2'}
+#   {product: "Widget", quarter: "Q1"},
+#   {product: "Widget", quarter: "Q2"}
 # ]>
 ```
 
@@ -193,8 +193,8 @@ Or combined in a single call (names before selectors):
 ```ruby
 sales[-:price, -:quantity, product: 'Widget']
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1'},
-#   {product: 'Widget', quarter: 'Q2'}
+#   {product: "Widget", quarter: "Q1"},
+#   {product: "Widget", quarter: "Q2"}
 # ]>
 ```
 
@@ -219,10 +219,10 @@ q2_sales = Namo.new([
 
 all_sales = q1_sales + q2_sales
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Gadget', quarter: 'Q1', price: 25.0, quantity: 40},
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150},
-#   {product: 'Gadget', quarter: 'Q2', price: 25.0, quantity: 60}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Gadget", quarter: "Q1", price: 25.0, quantity: 40},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150},
+#   {product: "Gadget", quarter: "Q2", price: 25.0, quantity: 60}
 # ]>
 ```
 
@@ -247,8 +247,8 @@ discontinued = Namo.new([
 
 sales - discontinued
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Widget', quarter: 'Q2', price: 10.0, quantity: 150}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150}
 # ]>
 ```
 
@@ -273,8 +273,8 @@ confirmed = Namo.new([
 
 sales & confirmed
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Gadget', quarter: 'Q2', price: 25.0, quantity: 60}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Gadget", quarter: "Q2", price: 25.0, quantity: 60}
 # ]>
 ```
 
@@ -297,9 +297,9 @@ all_sales = Namo.new([
 
 q1_sales | all_sales
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', price: 10.0, quantity: 100},
-#   {product: 'Gadget', quarter: 'Q1', price: 25.0, quantity: 40},
-#   {product: 'Thingo', quarter: 'Q3', price: 5.0, quantity: 10}
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Gadget", quarter: "Q1", price: 25.0, quantity: 40},
+#   {product: "Thingo", quarter: "Q3", price: 5.0, quantity: 10}
 # ]>
 ```
 
@@ -322,8 +322,8 @@ set_b = Namo.new([
 
 set_a ^ set_b
 # => #<Namo [
-#   {product: 'Gadget', quarter: 'Q1', price: 25.0, quantity: 40},
-#   {product: 'Thingo', quarter: 'Q3', price: 5.0, quantity: 10}
+#   {product: "Gadget", quarter: "Q1", price: 25.0, quantity: 40},
+#   {product: "Thingo", quarter: "Q3", price: 5.0, quantity: 10}
 # ]>
 ```
 
@@ -346,8 +346,8 @@ fundamentals = Namo.new([
 
 ohlcv * fundamentals
 # => #<Namo [
-#   {symbol: 'BHP', date: '2025-01-01', close: 42.5, pe: 14.5},
-#   {symbol: 'RIO', date: '2025-01-01', close: 118.3, pe: 9.2}
+#   {symbol: "BHP", date: "2025-01-01", close: 42.5, pe: 14.5},
+#   {symbol: "RIO", date: "2025-01-01", close: 118.3, pe: 9.2}
 # ]>
 ```
 
@@ -376,8 +376,8 @@ prices.*(quarterly) do |row, candidates|
   candidates[quarter_end: ->(qe){qe <= row[:date]}].sort_by{|f| f[:quarter_end]}.last(1)
 end
 # => #<Namo [
-#   {symbol: 'BHP', date: '2025-02-15', close: 42.5, quarter_end: '2024-12-31', eps: 1.0},
-#   {symbol: 'BHP', date: '2025-05-20', close: 44.0, quarter_end: '2025-03-31', eps: 1.2}
+#   {symbol: "BHP", date: "2025-02-15", close: 42.5, quarter_end: "2024-12-31", eps: 1.0},
+#   {symbol: "BHP", date: "2025-05-20", close: 44.0, quarter_end: "2025-03-31", eps: 1.2}
 # ]>
 ```
 
@@ -395,10 +395,10 @@ quarters = Namo.new([{quarter: 'Q1'}, {quarter: 'Q2'}])
 
 products ** quarters
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1'},
-#   {product: 'Widget', quarter: 'Q2'},
-#   {product: 'Gadget', quarter: 'Q1'},
-#   {product: 'Gadget', quarter: 'Q2'}
+#   {product: "Widget", quarter: "Q1"},
+#   {product: "Widget", quarter: "Q2"},
+#   {product: "Gadget", quarter: "Q1"},
+#   {product: "Gadget", quarter: "Q2"}
 # ]>
 ```
 
@@ -429,9 +429,9 @@ orders.**(tiers) do |row, candidates|
   candidates[max_weight: ->(w){w >= row[:weight]}]
 end
 # => #<Namo [
-#   {order: 'A', weight: 5, tier: 'light', max_weight: 10},
-#   {order: 'A', weight: 5, tier: 'heavy', max_weight: 20},
-#   {order: 'B', weight: 15, tier: 'heavy', max_weight: 20}
+#   {order: "A", weight: 5, tier: "light", max_weight: 10},
+#   {order: "A", weight: 5, tier: "heavy", max_weight: 20},
+#   {order: "B", weight: 15, tier: "heavy", max_weight: 20}
 # ]>
 ```
 
@@ -454,8 +454,8 @@ fundamentals = Namo.new([
 
 combined / fundamentals
 # => #<Namo [
-#   {date: '2025-01-01', close: 42.5},
-#   {date: '2025-01-01', close: 118.3}
+#   {date: "2025-01-01", close: 42.5},
+#   {date: "2025-01-01", close: 118.3}
 # ]>
 ```
 
@@ -616,10 +616,10 @@ sales[:revenue] = proc{|row| row[:price] * row[:quantity]}
 
 sales[:product, :quarter, :revenue]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', revenue: 1000.0},
-#   {product: 'Widget', quarter: 'Q2', revenue: 1500.0},
-#   {product: 'Gadget', quarter: 'Q1', revenue: 1000.0},
-#   {product: 'Gadget', quarter: 'Q2', revenue: 1500.0}
+#   {product: "Widget", quarter: "Q1", revenue: 1000.0},
+#   {product: "Widget", quarter: "Q2", revenue: 1500.0},
+#   {product: "Gadget", quarter: "Q1", revenue: 1000.0},
+#   {product: "Gadget", quarter: "Q2", revenue: 1500.0}
 # ]>
 ```
 
@@ -633,11 +633,11 @@ sales[:profit] = proc{|row| row[:revenue] - row[:cost]}
 
 sales[:product, :quarter, :profit]
 # => #<Namo [
-#   {product: 'Widget', quarter: 'Q1', profit: 600.0},
-#   {product: 'Widget', quarter: 'Q2', profit: 900.0},
-#   {product: 'Gadget', quarter: 'Q1', profit: 840.0},
-#   {product: 'Gadget', quarter: 'Q2', profit: 1260.0}
-# ]>
+#   {product: "Widget", quarter: "Q1", profit: 600.0},
+#   {product: "Widget", quarter: "Q2", profit: 900.0},
+#   {product: "Gadget", quarter: "Q1", profit: 840.0},
+#   {product: "Gadget", quarter: "Q2", profit: 1260.0}
+# ] derived: [:revenue, :cost]>
 ```
 
 Formulae work with selection and projection:
@@ -645,9 +645,9 @@ Formulae work with selection and projection:
 ```ruby
 sales[product: 'Widget'][:revenue, :quarter]
 # => #<Namo [
-#   {revenue: 1000.0, quarter: 'Q1'},
-#   {revenue: 1500.0, quarter: 'Q2'}
-# ]>
+#   {revenue: 1000.0, quarter: "Q1"},
+#   {revenue: 1500.0, quarter: "Q2"}
+# ] derived: [:cost, :profit]>
 ```
 
 Formulae carry through selection — a filtered Namo instance remembers its formulae.
@@ -970,6 +970,36 @@ sales[:product, :quarter, :revenue].to_h
 # }
 ```
 
+### Inspection output
+
+`inspect` renders the class, the stored rows, and the names of any derived dimensions:
+
+```ruby
+sales.inspect
+# => #<Namo [
+#   {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100},
+#   {product: "Widget", quarter: "Q2", price: 10.0, quantity: 150},
+#   {product: "Gadget", quarter: "Q1", price: 25.0, quantity: 40},
+#   {product: "Gadget", quarter: "Q2", price: 25.0, quantity: 60}
+# ] derived: [:revenue]>
+```
+
+A name, where the Namo carries one, follows the class: `#<Namo :sales [`. A subclass reports its own name in place of `Namo`.
+
+Derived dimensions are *named*, not evaluated. A console calls `inspect` on every result, so evaluating there would cost a pass over the data on each one, would raise whatever a formula raises, and could not render a parameterised formula at all. Ask through `values`, `coordinates`, or a projection when you want the values.
+
+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 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.
+
+```ruby
+sales.first
+# => #<Namo::Row {product: "Widget", quarter: "Q1", price: 10.0, quantity: 100} derived: [:revenue]>
+
+sales.group_by(:quarter)
+# => #<Namo::Collection members: ["Q1", "Q2"], 4 rows>
+```
+
 ### Named Namos
 
 A Namo can carry a name, passed by the `name:` keyword and read or set through the `name` accessor:

data/lib/Namo/Collection.rb

@@ -53,6 +53,10 @@ class Namo
       self
     end
 
+    def inspect
+      "#<#{self.class}#{inspected_name} members: #{@members.map(&:name).inspect}, #{@data.length} rows#{inspected_derived}>"
+    end
+
     private
 
     def initialize(positional_data = nil, data: [], formulae: {}, name: nil)

data/lib/Namo/Formulae.rb

@@ -97,6 +97,10 @@ class Namo
       keys.sort.hash
     end
 
+    def inspect
+      "#<#{self.class} #{@store.keys.inspect}>"
+    end
+
     private
 
     def initialize(store = {})

data/lib/Namo/Row.rb

@@ -43,8 +43,16 @@ class Namo
       @row
     end
 
+    def inspect
+      "#<#{self.class} #{@row.inspect}#{inspected_derived}>"
+    end
+
     private
 
+    def inspected_derived
+      @formulae.keys.empty? ? '' : " derived: #{@formulae.keys.inspect}"
+    end
+
     def initialize(row, formulae, namo = nil)
       @row = row
       @formulae = formulae

data/lib/Namo/VERSION.rb

@@ -2,5 +2,5 @@
 # Namo::VERSION
 
 class Namo
-  VERSION = '0.30.0'
+  VERSION = '0.31.0'
 end

data/lib/namo.rb

@@ -17,6 +17,8 @@ class Namo
   attr_accessor :formulae
   attr_accessor :name
 
+  INSPECTED_ROWS = 10
+
   def dimensions
     data_dimensions + derived_dimensions
   end
@@ -247,6 +249,10 @@ class Namo
     end
   end
 
+  def inspect
+    "#<#{self.class}#{inspected_name}#{inspected_rows}#{inspected_derived}>"
+  end
+
   protected
 
   def row_multiset
@@ -265,6 +271,24 @@ class Namo
 
   private
 
+  def inspected_name
+    @name.nil? ? '' : " #{@name.inspect}"
+  end
+
+  # 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
+    return ' []' if @data.empty?
+    shown = @data.first(INSPECTED_ROWS).map{|row| "  #{row.inspect}"}.join(",\n")
+    shown += "\n  ... #{@data.length - INSPECTED_ROWS} more rows" if @data.length > INSPECTED_ROWS
+    " [\n#{shown}\n]"
+  end
+
+  def inspected_derived
+    derived_dimensions.empty? ? '' : " derived: #{derived_dimensions.inspect}"
+  end
+
   def initialize(positional_data = nil, data: [], formulae: {}, name: nil)
     @data = positional_data || data
     @formulae = formulae.is_a?(Formulae) ? formulae : Formulae.new(formulae)

data/namo.gemspec

@@ -22,14 +22,14 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.files = [
-    'namo.gemspec',
+    Dir['lib/**/*.rb'],
+    Dir['test/**/*.rb'],
     'CHANGELOG',
     'Gemfile',
     'LICENSE',
+    'namo.gemspec',
     'Rakefile',
     'README.md',
-    Dir['lib/**/*.rb'],
-    Dir['test/**/*.rb'],
   ].flatten
 
   spec.development_dependencies = %w{

data/test/Namo/Collection_test.rb

@@ -346,4 +346,17 @@ describe Namo::Collection do
       _(car.detail.values(:assembly)).must_equal [:powertrain, :powertrain, :chassis, :body]
     end
   end
+
+  describe "#inspect" do
+    it "renders the member names and the row count" do
+      collection = Namo::Collection.new
+      collection << Namo.new([{a: 1}], name: :first) << Namo.new([{a: 2}], name: :second)
+      _(collection.inspect).must_equal "#<Namo::Collection members: [:first, :second], 2 rows>"
+    end
+
+    it "renders an empty Collection" do
+      _(Namo::Collection.new.inspect).must_equal "#<Namo::Collection members: [], 0 rows>"
+    end
+  end
+
 end

data/test/Namo/Formulae_test.rb

@@ -440,4 +440,19 @@ describe Namo::Formulae do
       end
     end
   end
+
+  describe "#inspect" do
+    it "renders the formula names" do
+      formulae = Namo::Formulae.new
+      formulae[:revenue] = proc{|row| row[:price]}
+      _(formulae.inspect).must_equal "#<Namo::Formulae [:revenue]>"
+    end
+
+    it "does not render the callables" do
+      formulae = Namo::Formulae.new
+      formulae[:revenue] = proc{|row| row[:price]}
+      _(formulae.inspect).wont_match(/Proc/)
+    end
+  end
+
 end

data/test/Namo/Row_test.rb

@@ -459,4 +459,23 @@ describe Namo::Row do
       _([a, b, duplicate_of_a].uniq.length).must_equal 2
     end
   end
+
+  describe "#inspect" do
+    it "renders the row data" do
+      _(Namo::Row.new({a: 1}, Namo::Formulae.new).inspect).must_equal "#<Namo::Row {a: 1}>"
+    end
+
+    it "names derived dimensions without evaluating them" do
+      formulae = Namo::Formulae.new
+      formulae[:b] = proc{|row| raise 'never called'}
+      _(Namo::Row.new({a: 1}, formulae).inspect).must_equal "#<Namo::Row {a: 1} derived: [:b]>"
+    end
+
+    it "does not render the Namo the row came from" do
+      namo = Namo.new((1..1000).map{|i| {a: i}})
+      _(namo.first.inspect).wont_match(/\{a: 2\}/)
+      _(namo.first.inspect.length).must_be :<, 100
+    end
+  end
+
 end

data/test/namo_test.rb

@@ -3221,4 +3221,49 @@ describe Namo do
       end
     end
   end
+
+  describe "#inspect" do
+    it "renders the class and the rows" do
+      _(Namo.new([{a: 1}]).inspect).must_equal "#<Namo [\n  {a: 1}\n]>"
+    end
+
+    it "renders an empty Namo without a row block" do
+      _(Namo.new([]).inspect).must_equal "#<Namo []>"
+    end
+
+    it "names derived dimensions without evaluating them" do
+      namo = Namo.new([{a: 1}])
+      namo[:b] = proc{|row| raise 'never called'}
+      _(namo.inspect).must_equal "#<Namo [\n  {a: 1}\n] derived: [:b]>"
+    end
+
+    it "includes the name when there is one" do
+      _(Namo.new([{a: 1}], name: :sales).inspect).must_match(/\A#<Namo :sales \[/)
+    end
+
+    it "omits the name when there is none" do
+      _(Namo.new([{a: 1}]).inspect).must_match(/\A#<Namo \[/)
+    end
+
+    it "truncates beyond INSPECTED_ROWS and says how many are left" do
+      namo = Namo.new((1..25).map{|i| {a: i}})
+      _(namo.inspect.scan(/\{a: \d+\}/).length).must_equal Namo::INSPECTED_ROWS
+      _(namo.inspect).must_match(/\.\.\. 15 more rows/)
+    end
+
+    it "does not truncate at exactly INSPECTED_ROWS" do
+      namo = Namo.new((1..Namo::INSPECTED_ROWS).map{|i| {a: i}})
+      _(namo.inspect).wont_match(/more rows/)
+    end
+
+    it "reports the subclass rather than Namo" do
+      Object.const_set(:InspectedSubAssembly, Class.new(Namo)) unless defined?(InspectedSubAssembly)
+      _(InspectedSubAssembly.new([{a: 1}]).inspect).must_match(/\A#<InspectedSubAssembly \[/)
+    end
+
+    it "does not grow with the data beyond the truncation point" do
+      _(Namo.new((1..10_000).map{|i| {a: i}}).inspect.length).must_be :<, 500
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namo
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.31.0
 platform: ruby
 authors:
 - thoran
@@ -98,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.18
 specification_version: 4
 summary: Named dimensional data for Ruby.
 test_files: []