philiprehberger-csv_kit 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85d915adb35a580821d1055d966fe76b802598d6422571ad1e727694dd604a4f
-  data.tar.gz: 66cc520a86bae535668b77aa56ae7d154ddc1f5df22cca7b4578d4b12a7958e8
+  metadata.gz: 2ad7f9f8f543aa7336129a60b131b397f7d46884dc63949aed97ffcdeea41a99
+  data.tar.gz: 623d9169efd50e7f1bf3894c7a6b7ffbc99c79085a444d633c280af727f0f8b6
 SHA512:
-  metadata.gz: 0b719464ccea551cb56975fe78985ffa2f49480f2439e9a528f091afa53b5b24dd55219dbab3e65a8f30ec1f326959749ad4162e52d36471b1ee3bfd1272afcd
-  data.tar.gz: 7f98968c2c5063109053f2a4a8f4508f6544e5238f783440969f237f593b66f4ac2a2ace4e6b495862621944fe891c44107a247366d3c1cedd59be6208a88df9
+  metadata.gz: aaee8ffddffaabf495a59a9e5b7b00d2ebfbcc73f06d73229f96c11184f16c7215203ead52e77c1bc109e29d8eb28e2b2b5e728c64d094bb35af953a5c62aad7
+  data.tar.gz: a310d1904161f42549cff7b2dfee711d2f483e6b2cb9ff5428267e9118bdc80130af7b701b47ad6e659c56dddb29607f7b6d5eea0af6dd0e667b207e0fc2e765

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-05-07
+
+### Added
+- `CsvKit.transpose(path_or_io, dialect:)` — returns a column-oriented hash mapping each header to the array of values across all rows. The natural complement to `to_hashes` for column-wise operations.
+
 ## [0.9.0] - 2026-04-19
 
 ### Added
@@ -112,7 +117,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Type coercion and row validation
 - Quick load and filtering convenience methods
 
-[Unreleased]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.9.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.10.0...HEAD
+[0.10.0]: https://github.com/philiprehberger/rb-csv-kit/releases/tag/v0.10.0
 [0.9.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/philiprehberger/rb-csv-kit/compare/v0.6.0...v0.7.0

data/README.md

@@ -205,11 +205,25 @@ delimiter = Philiprehberger::CsvKit::Detector.detect("data.tsv")
 # => "\t"
 ```
 
+### Column Transpose
+
+```ruby
+require 'philiprehberger/csv_kit'
+
+# users.csv:
+# name,age
+# Alice,30
+# Bob,25
+Philiprehberger::CsvKit.transpose('users.csv')
+# => { name: ['Alice', 'Bob'], age: ['30', '25'] }
+```
+
 ## API
 
 | Method / Class | Description |
 |----------------|-------------|
 | `CsvKit.to_hashes(path_or_io, dialect:)` | Load CSV into array of symbolized hashes |
+| `CsvKit.transpose(path_or_io, dialect:)` | Returns a column-oriented hash mapping each header to its column of values |
 | `CsvKit.to_csv(rows, headers:, dialect:)` | Serialize an array of hashes to a CSV string |
 | `CsvKit.sample(path_or_io, n, dialect:)` | Return n randomly sampled rows using reservoir sampling (Algorithm R) |
 | `CsvKit.pluck(path_or_io, *keys, dialect:)` | Extract specific columns |

data/lib/philiprehberger/csv_kit/version.rb

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

data/lib/philiprehberger/csv_kit.rb

@@ -42,6 +42,20 @@ module Philiprehberger
       rows
     end
 
+    # Read a CSV and return a hash mapping each header to the column of values.
+    #
+    # @param path_or_io [String, IO] the path or IO to read from
+    # @param dialect [Hash, nil] optional CSV dialect overrides
+    # @return [Hash{Symbol => Array}] column-oriented view of the CSV
+    def self.transpose(path_or_io, dialect: nil)
+      rows = to_hashes(path_or_io, dialect: dialect)
+      return {} if rows.empty?
+
+      rows.first.keys.to_h do |key|
+        [key, rows.map { |row| row[key] }]
+      end
+    end
+
     # Serialize an array of hashes to a CSV string.
     #
     # If headers is omitted, the keys of the first hash are used. Empty input

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-csv_kit
 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-20 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
 description: Streaming CSV processor with row-by-row transforms, validations, column
   plucking, streaming each_hash iteration, filtering, writing, error recovery, and