namo 0.30.1 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11155d79565895733cba5947380c1995003ab8e3916dcc2a5b22a55053d804a7
-  data.tar.gz: 5e983ddf2f3881195692df604fa9d61005f817cec18c87c960b837353fc094be
+  metadata.gz: 1241332321c6f9d7643932d1b53949bfb12eb8596b1e388c206a9fad705efaf7
+  data.tar.gz: 00c558afd1fe979599820a39539f3216b496557a69f94229a59fc45c48cfd062
 SHA512:
-  metadata.gz: 2143589ce12079aab10ee8e84bf2c77e94db8459bace1c2c1d45e71c538e8328fd088c3b8ae08490d292968890fec3b8e16d5384173374b3668b1acbeeb4ca49
-  data.tar.gz: 2113f5063b2ae16863e4672bf8ec69bdc99d33ad561000068c19099950d7a25a3f4aecabbfed68f444dfe14677d61076793ed13754f8c48180e56f32ec8d56c5
+  metadata.gz: 74b61473e59179fcd559d52eb98435ab9127499c17403174c1505f5076d1c6d2dd1f829ea8a69403da948709d047d42603bb1fd6bc32205bfb1bb3b0459d47c8
+  data.tar.gz: c9690afd20a5ab0de834d9dcca3b2a310e4da3e4811b0a29545e60290f1cb62f7571e8c177bacd405b380e8bfe6f78358a075c9c2eb5a4519654843c90ddaf5a

data/CHANGELOG

@@ -1,5 +1,18 @@
 # 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.

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.1'
+  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/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.1
+  version: 0.31.0
 platform: ruby
 authors:
 - thoran