philiprehberger-data_mapper 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5404a0cdcc13d6351546a1eba5afde88afd31ea3a26fb02884166918aee9cb0
-  data.tar.gz: 0e7d36ecf87018ebce2eb8bcfe2decaee35c120f79c006a954883cd8cb4d2b20
+  metadata.gz: 1e3fb4ef570f5687ce40b83423e1a831c585718696082a00a356a005598ad446
+  data.tar.gz: b00a3a344096b9e678a2dea5a2e558cf70fd912fa863351704aa73ca3672d0d6
 SHA512:
-  metadata.gz: 61416ea1c4083f22dee9c828f585b19d7d6dbce1b57f3d0e3100d27b72890bdb44be2fd7e216bfaa5b99a8c75ec5a1e19c012be55bb55e2c2f7080845d9fc806
-  data.tar.gz: 64d3f10c97e693f882ba0e52e0661d2b26e19a32759478f43fcf5013b8124204e546c08bf3eefdd9f713c7d8e9c616e9e54ab7e876a18b981c52f4564dc90b83
+  metadata.gz: ea73b6ed241967a0e9c544aa57635fb08c21dfe6b4d498721905cff7ff63c4f55bcbcc3839041c0f899c1857bc916dcd1bf31f96ab823438e372a76eb08b1e02
+  data.tar.gz: ddf8d77ec5eba001b9ffb27d0290eb5a036a9801cbabfd5c566fb9f0c25ac65d277bb90a70191126cd238e415324f38da41e18cc2c232f4fb0cd730ef6b0c925

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-21
+
+### Added
+- `Mapping#call(hash)` — alias for `#map`, enabling `Mapping` instances to be used as callables
+- `Mapping#to_proc` — returns a `Proc` that maps a single record, allowing idiomatic usage like `rows.map(&mapping)`
+
+## [0.5.0] - 2026-04-18
+
+### Added
+- `Mapping#map_lazy(enumerable)` — returns a `Lazy` Enumerator that applies `#map` per-element; suitable for streaming large inputs without materialization
+
 ## [0.4.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -55,6 +55,34 @@ mapping.map_all(input)
 # => [{ full_name: "Alice", years: 30, role: "member" }, ...]
 ```
 
+### Lazy streaming
+
+Use `map_lazy` to pipe huge datasets without materializing an intermediate array. It returns an `Enumerator::Lazy` that applies `#map` per-element, so it composes with `.first`, `.select`, `.reject`, and works on infinite enumerables:
+
+```ruby
+mapping = Philiprehberger::DataMapper.define do
+  field :id
+end
+
+infinite = (1..).lazy.map { |i| { "id" => i } }
+mapping.map_lazy(infinite).first(3)
+# => [{ id: 1 }, { id: 2 }, { id: 3 }]
+```
+
+### Use as a callable
+
+`Mapping#call` is an alias for `#map`, and `Mapping#to_proc` returns a proc, so a mapping can be passed wherever a callable is expected:
+
+```ruby
+mapping = Philiprehberger::DataMapper.define do
+  field :name, from: :Name
+end
+
+mapping.call({ Name: "Ada" })      # => { name: "Ada" }
+[{ Name: "Ada" }, { Name: "Lin" }].map(&mapping)
+# => [{ name: "Ada" }, { name: "Lin" }]
+```
+
 ### Parse CSV
 
 ```ruby
@@ -209,8 +237,11 @@ result.errors  # => [{ field: :age, value: -1 }, { field: :name, value: "" }]
 | `Mapping#computed(target, &block)` | Define a computed field derived from the full record |
 | `Mapping#array_field(target, from:, split:, &transform)` | Define a field that splits a string into an array |
 | `Mapping#map(hash)` | Apply mapping to a single hash |
+| `Mapping#call(hash)` | Alias for `#map` — lets a `Mapping` be used as a callable |
+| `Mapping#to_proc` | Return a `Proc` that calls `#map`, usable with `array.map(&mapping)` |
 | `Mapping#map_with_validation(hash)` | Apply mapping and return a `MappingResult` with errors |
 | `Mapping#map_all(array)` | Apply mapping to an array of hashes |
+| `Mapping#map_lazy(enumerable)` | Return a `Lazy` Enumerator applying `#map` per-element for streaming |
 | `Mapping#field_names` | Array of symbol targets for declared fields and computed fields |
 | `Mapping#reverse(hash)` | Transform output hash back to input schema |
 | `Mapping#from_csv(string, headers: true)` | Parse CSV and map each row |

data/lib/philiprehberger/data_mapper/mapping.rb

@@ -44,6 +44,26 @@ module Philiprehberger
         array.map { |hash| map(hash) }
       end
 
+      def map_lazy(enumerable)
+        enumerable.lazy.map { |hash| map(hash) }
+      end
+
+      # Proc conversion so a `Mapping` can be passed wherever a callable is expected
+      # (e.g. `rows.map(&mapping)`).
+      #
+      # @return [Proc] a proc that calls `#map` on its argument
+      def to_proc
+        method(:map).to_proc
+      end
+
+      # Alias of `#map` so a Mapping instance can be invoked like a function.
+      #
+      # @param hash [Hash] the record to map
+      # @return [Hash]
+      def call(hash)
+        map(hash)
+      end
+
       # Names (targets) of every declared field, including computed fields.
       #
       # @return [Array<Symbol>]

data/lib/philiprehberger/data_mapper/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module DataMapper
-    VERSION = '0.4.0'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-data_mapper
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-21 00:00:00.000000000 Z
 dependencies: []
 description: A zero-dependency Ruby gem for transforming data between formats with
   a mapping DSL, field renaming, type conversion, validation, and CSV support.