philiprehberger-csv_builder 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a4ffc869b5a686e7e0d33b193f309354328b4ea6aa12bd5421ff1d906aa8cce
-  data.tar.gz: 74f124f09a30ff6fd71f7caaaf13364c2bf63032adf8bf03b5d61dc1cf328caa
+  metadata.gz: 2f1c54dd0a22f73f8b3c1aba25cd72060d79c2fc9bd71ffc409d708aa927d826
+  data.tar.gz: d4484b178feb602eea6c387e0dfcbbe352cbe303886374115bf52cd44f1b97c1
 SHA512:
-  metadata.gz: fa82a727dacd0a8047b60a431045eeb40a99331346d96e5e2f9025137fbf83bce1ccbfb92e5bd502331943311e2543d6e7eb68d527ee61a9cc7bb79e9dbe8e36
-  data.tar.gz: 753166a7741b788a23133861c93d09441b7c8852b62bf1753d3b87565250aa017e38741c321a0388524d78885fa66a734ca112c63c27d8aba4c8c55b103ec37e
+  metadata.gz: 38aa26541ad6d2f535f5b64d1cd27d10b01818efd0712456dbe92a44bef40ac46654a678d4aa6c957d84df4f1e93327dd3f91ce8ee8e2bd9aa1bb686cc7ba984
+  data.tar.gz: 7b057a2ef52c4919f9e79ca82d0575514ff791aec1b26a0d3d564ecd64f272531d627df773822e1c47a282f10a1440c4fd6c2ef2ca19f6fd77b415995c54516a

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-04-30
+
+### Added
+- `Builder#empty?` — `true` when zero data rows would be emitted; respects filters, sort, offset, and limit. Saves callers from generating CSV just to check emptiness.
+
 ## [0.9.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -306,6 +306,7 @@ builder = Philiprehberger::CsvBuilder.build(records) do
 end
 
 builder.row_count  # => 50
+builder.empty?     # => false (true when no data rows would be emitted)
 ```
 
 ### Streaming
@@ -447,6 +448,7 @@ builder.headers  # => ["name", "email"]
 | `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 |
+| `Builder#empty?` | `true` when zero data rows would be emitted (after filters/limits/offset) |
 
 ## Development
 

data/lib/philiprehberger/csv_builder/builder.rb

@@ -174,6 +174,15 @@ module Philiprehberger
         filtered_records.size
       end
 
+      # Whether the builder will emit zero data rows after applying filters,
+      # sort, offset, and limit. Headers and footer are excluded from the
+      # check — `#empty?` reports on the data body only.
+      #
+      # @return [Boolean]
+      def empty?
+        row_count.zero?
+      end
+
       # Per-column statistics across filtered records.
       #
       # @return [Hash{Symbol => Hash}] column name mapped to stats hash

data/lib/philiprehberger/csv_builder/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-csv_builder
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-16 00:00:00.000000000 Z
+date: 2026-04-30 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,