philiprehberger-csv_builder 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '05805d69dd63884ea67c3f84412133ff6f5075c2ff9cd934466802f317389062'
-  data.tar.gz: 248c052d0dee9d96495231e5e216fca068ede633c95bbf33d6080e0a4f10816e
+  metadata.gz: 9a4ffc869b5a686e7e0d33b193f309354328b4ea6aa12bd5421ff1d906aa8cce
+  data.tar.gz: 74f124f09a30ff6fd71f7caaaf13364c2bf63032adf8bf03b5d61dc1cf328caa
 SHA512:
-  metadata.gz: 9085df5c9958fa914420a433b3f9ee86ba13def21c945f3a164e985913dec2a5201c6f9daad47034908560dc9a1e310743eb6c23a1e48a4daeae354d09e15742
-  data.tar.gz: 224356b93dea42304b84c3afd787db33e933582da909d069f10562f3c1d1c88e51554b6d2d3771fdece65503cd54dbdccad81fcd31dfd76c51240ea5d0a81889
+  metadata.gz: fa82a727dacd0a8047b60a431045eeb40a99331346d96e5e2f9025137fbf83bce1ccbfb92e5bd502331943311e2543d6e7eb68d527ee61a9cc7bb79e9dbe8e36
+  data.tar.gz: 753166a7741b788a23133861c93d09441b7c8852b62bf1753d3b87565250aa017e38741c321a0388524d78885fa66a734ca112c63c27d8aba4c8c55b103ec37e

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-04-15
+
+### Added
+- `Builder#column_stats` — per-column statistics (count, unique, nil_count, sample) across filtered records
+
 ## [0.8.0] - 2026-04-15
 
 ### Added
@@ -102,6 +107,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for hash records with symbol and string keys
 - Proper CSV escaping for values with commas and quotes
 
+[0.9.0]: https://github.com/philiprehberger/rb-csv-builder/releases/tag/v0.9.0
+[0.8.0]: https://github.com/philiprehberger/rb-csv-builder/releases/tag/v0.8.0
 [0.7.0]: https://github.com/philiprehberger/rb-csv-builder/releases/tag/v0.7.0
 [0.6.0]: https://github.com/philiprehberger/rb-csv-builder/releases/tag/v0.6.0
 [0.5.0]: https://github.com/philiprehberger/rb-csv-builder/releases/tag/v0.5.0

data/README.md

@@ -384,6 +384,31 @@ builder.to_a
 # => [["name", "email"], ["Alice", "alice@example.com"], ["Bob", "bob@example.com"]]
 ```
 
+### Column Statistics
+
+Inspect per-column statistics without generating CSV output:
+
+```ruby
+records = [
+  { name: 'Alice', email: 'alice@example.com' },
+  { name: 'Bob', email: nil },
+  { name: 'Alice', email: 'alice@example.com' }
+]
+
+builder = Philiprehberger::CsvBuilder.build(records) do
+  column :name
+  column :email
+end
+
+builder.column_stats
+# => {
+#   name:  { count: 3, unique: 2, nil_count: 0, sample: ["Alice", "Bob"] },
+#   email: { count: 3, unique: 1, nil_count: 1, sample: ["alice@example.com"] }
+# }
+```
+
+Statistics respect filters, limits, and offsets. The `nil_count` includes both `nil` values and values matching the configured `empty_value`.
+
 ### Headers
 
 ```ruby
@@ -420,6 +445,7 @@ builder.headers  # => ["name", "email"]
 | `Builder#append_to(path)` | Append data rows (no header, no BOM) to an existing CSV file |
 | `Builder#to_io(io)` | Stream CSV to any IO object |
 | `Builder#headers` | Return column header names |
+| `Builder#column_stats` | Per-column statistics: count, unique, nil_count, and sample values |
 | `Builder#row_count` | Number of data rows after filters, sorts, offsets, and limits |
 
 ## Development

data/lib/philiprehberger/csv_builder/builder.rb

@@ -174,6 +174,25 @@ module Philiprehberger
         filtered_records.size
       end
 
+      # Per-column statistics across filtered records.
+      #
+      # @return [Hash{Symbol => Hash}] column name mapped to stats hash
+      #   with keys :count, :unique, :nil_count, :sample
+      def column_stats
+        recs = filtered_records
+        @columns.to_h do |col|
+          values = recs.map { |r| col.extract(r, empty_value: @empty_value) }
+          nil_count = values.count { |v| v.nil? || v == @empty_value }
+          unique_values = values.reject { |v| v.nil? || v == @empty_value }.uniq
+          [col.name, {
+            count: values.size,
+            unique: unique_values.size,
+            nil_count: nil_count,
+            sample: unique_values.first(3)
+          }]
+        end
+      end
+
       # Return the filtered records
       #
       # @return [Array]

data/lib/philiprehberger/csv_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module CsvBuilder
-    VERSION = '0.8.0'
+    VERSION = '0.9.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-csv_builder
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-16 00:00:00.000000000 Z
 dependencies: []
 description: Build CSV files from record collections using a declarative DSL with
   column definitions, custom transforms, filtering, sorting, pagination via limit/offset,