philiprehberger-data_mapper 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28a193815c02260ca5a5f0e32cf1bb8e41c80ac915ae230d238ea17cbf98b5e1
-  data.tar.gz: 70dc78f072bb23f692d009561bb3865a3bb5b4e7937b51440a8e4999f7af7db3
+  metadata.gz: '08f4e17d177ee25cbc161e5873c41623a8f774b0a2c36faa1e43776cbea3c5a2'
+  data.tar.gz: 133251c11f08fd0204a5672fa78c60a1bec5b3225648e49d1c67ffc01b4102cd
 SHA512:
-  metadata.gz: f391be6c263d16d60b917a1c7ae8a77cf74d4a0e5c9625df29f44efbeb21dff068253a15c7c50a323d70fcb132071dbf0a297e8d46574e0bb149c7a290d30f15
-  data.tar.gz: 981703bef28308069940c19bc5b5eea7192b37553de840b23d60b5c2c3969f5657ff919d2d6e286149ce766e3d190477a9870bcb20e09f1a03ea008c9b6db973
+  metadata.gz: 294795cf41fadc25753f7f951fa584b6c09a934e5ba10cdd4f4a95439e3e5161487d69d1916fd58ac890e796569d0c69c2ba418fbf3165b1d10462658f8820ec
+  data.tar.gz: 50a8a7eccca2e2822014b57b1d670588ec5595db505e53e37506718475b3e1a2621d79e1f6e07d4e1288165bd58fd111066f5743a5290643a752fe898c29bf98

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-05-01
+
+### Added
+- `Mapping#has_field?(name)` — boolean predicate for whether the mapping declares an output field with that name (covers both regular and computed fields)
+
+## [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

data/README.md

@@ -69,6 +69,20 @@ 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
@@ -191,6 +205,10 @@ mapping = Philiprehberger::DataMapper.define do
   computed(:upper) { |r| r[:Name].upcase }
 end
 mapping.field_names  # => [:name, :upper]
+
+mapping.has_field?(:name)    # => true
+mapping.has_field?(:upper)   # => true
+mapping.has_field?(:missing) # => false
 ```
 
 ### Validation
@@ -223,10 +241,13 @@ 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#has_field?(name)` | Whether the mapping declares an output field with that name |
 | `Mapping#reverse(hash)` | Transform output hash back to input schema |
 | `Mapping#from_csv(string, headers: true)` | Parse CSV and map each row |
 | `Mapping#from_json(json_string)` | Parse JSON string and map the result |

data/lib/philiprehberger/data_mapper/mapping.rb

@@ -48,6 +48,22 @@ module Philiprehberger
         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>]
@@ -55,6 +71,19 @@ module Philiprehberger
         @fields.map(&:target) + @computed_fields.map(&:target)
       end
 
+      # Whether the mapping declares an output field with the given name.
+      #
+      # Matches both regular and computed fields. Comparison is exact
+      # (no symbol/string coercion beyond `to_sym` on the input).
+      #
+      # @param name [Symbol, String] the target field name to check
+      # @return [Boolean]
+      def has_field?(name)
+        target = name.to_sym
+        @fields.any? { |f| f.target == target } ||
+          @computed_fields.any? { |c| c.target == target }
+      end
+
       private
 
       def map_fields(hash)

data/lib/philiprehberger/data_mapper/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module DataMapper
-    VERSION = '0.5.0'
+    VERSION = '0.7.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-data_mapper
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-19 00:00:00.000000000 Z
+date: 2026-05-02 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.