inline_transforms 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69650094317116d52d29eaaebdc3237dcf2c014d6447b2ad52631a4eabb11837
-  data.tar.gz: 2729df1b7e99479a4101a9c53782b32a4d736e1756008f0da8fa976722799bd2
+  metadata.gz: 4334af4981af33dcc4fb7ead38766fddf4d25fe1d86f2db067a5ff944b4e9556
+  data.tar.gz: 6ac97539f4c3a359d9ae9f8b174af4831363818eb7cacd1ab7513b11470a06fb
 SHA512:
-  metadata.gz: e1432ee3d677412d5aa6bcd9b014f2b7e5c093b7e495b760335dac315d312825890e1e26759a977639a7c69fdce09f6e9309b8b57f3bb2bcb4d06291ac1ee62c
-  data.tar.gz: 462d39e0cf06278f6bf757ceec642496b22a7b2d06f9e8bf6d66c0fc0d4993e4c493eaea2cad25258e9c1f72549f7eb25e7925dd04b3af7a0d918a1f47d4c914
+  metadata.gz: bfab67d890ef4e3a0e8e2e342dc87463f7b595333b34cb521e7980b03236eb35de2b5b9db07dc8bbb20300e2798c41683cbd4fe7d33749bdf8491548f9d32963
+  data.tar.gz: 90efac60c1b9efaac6f335bfd6f36c8e7d607c1f868612b20fabff840dac765e9d983b4f240dd252a9cf7782553875627552bd8942aa518c28586bbc634a97c1

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## v0.3.1 (2026-09-29)
+- **Chores**:
+  - Corrected Gemspec *changelog* URI.
+  - Exclude unnecessary files to reduce gem size.
+
+## v0.3.0 (2026-08-26)
+- **Features**:
+  - Pass the original value to fallback/transform `Proc`s.
+
+## v0.2.0 (2026-08-25)
+- **Features**:
+  - Added an `only_if` transform.
+
+## v0.1.0 (2026-08-25)
+- **Features**:
+  - Initial "inline transforms" implementation.
+- **Testing**:
+  - Proper testing of all expected behaviors.

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in inline_transforms.gemspec
+gemspec
+
+gem 'irb'
+gem 'rake', '~> 13'
+gem 'rspec', '~> 3'
+gem 'rubocop'
+gem 'yard'

data/Gemfile.lock

@@ -0,0 +1,129 @@
+PATH
+  remote: .
+  specs:
+    inline_transforms (0.3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    diff-lcs (1.6.2)
+    erb (6.0.7)
+    io-console (0.9.2)
+    irb (1.18.0)
+      pp (>= 0.6.0)
+      prism (>= 1.3.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    parallel (2.1.0)
+    parser (3.3.12.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.4)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.9.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.4.2)
+    rbs (4.1.3)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    rdoc (8.0.0)
+      erb
+      prism (>= 1.6.0)
+      rbs (>= 4.0.0)
+      tsort
+    regexp_parser (2.12.0)
+    reline (0.7.0)
+      io-console (~> 0.5)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.89.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    yard (0.9.45)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  inline_transforms!
+  irb
+  rake (~> 13)
+  rspec (~> 3)
+  rubocop
+  yard
+
+CHECKSUMS
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  bundler (4.0.14) sha256=d09a0a965cf772266a7e49e83610be7c2f4e49e61134c42a56804bb383cc24b8
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
+  inline_transforms (0.3.0)
+  io-console (0.9.2) sha256=efa74f891dd03c0939a931dfc6e74c2813d904763d456ea9762b0525e748db08
+  irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3
+  json (2.21.2) sha256=1f1d3b7cf2b3ba1a69beca0bb6db13d5438b80bff3cd54cdaaa620b9b07c1c6a
+  language_server-protocol (3.17.0.6) sha256=5ef2c0c138f8267e1bc631d3328347d354f96724b0af22f2c79516120443b7f0
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356
+  parser (3.3.12.0) sha256=21a6d7f755d5a24dfbdc6e6b772e4e879a52e7631a88bc5a3a134606052c9828
+  pp (0.6.4) sha256=dfcb0fce700c41456265922884f9fe195d7fbb0674a3578e6c0f69588e82b570
+  prettyprint (0.2.0) sha256=2bc9e15581a94742064a3cc8b0fb9d45aae3d03a1baa6ef80922627a0766f193
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
+  rbs (4.1.3) sha256=0c4474a9751cdc14364bfad0b3e53678323bbdc2c31683b0445932867dbab8c4
+  rdoc (8.0.0) sha256=03bf8c08a9639658855a0cfd77c0abca8325c227693f7f33f82957811348c469
+  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
+  reline (0.7.0) sha256=5b012d8e55dbf9d450f12bde2cf7d15ff546ae80b3f8f3b30e570d431815583d
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.89.0) sha256=4dee8e3ee9c45e474834efd9e8d6fd031e8331c8dacdff0de4ad65ae0a6faae7
+  rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  yard (0.9.45) sha256=52e211493f7cb8a3ebf7e104a25a1e73937a3103092545d34cb88fafebb3dc51
+
+BUNDLED WITH
+  4.0.14

data/README.md

@@ -91,6 +91,9 @@ final_value = original_value.transform true   => 'success',
 `only_if` lets you specify a "good" value and an `else` replacement.
 
 - If your `else` replacement is a `Proc`, it is resolved (via `call`) before being returned.
+  - If it has arity 0, it is `call`ed with no params.
+  - If it has arity 1, it is `call`ed with the original value.
+  - If it has arity -1 (a `lambda` with optional param), it is `call`ed with the original value.
 - This method uses **case comparison** (`===`), so you can check for range inclusion or class.
 
 ```ruby
@@ -105,6 +108,9 @@ final = value.only_if good_value, else: -> { some_method_call with_params }
 `unless` lets you specify a "bad" value and a `then` replacement.
 
 - If your `then` replacement is a `Proc`, it is resolved (via `call`) before being returned.
+  - If it has arity 0, it is `call`ed with no params.
+  - If it has arity 1, it is `call`ed with the original value.
+  - If it has arity -1 (a `lambda` with optional param), it is `call`ed with the original value.
 - This method uses **case comparison** (`===`), so you can check for range inclusion or class.
 
 ```ruby
@@ -119,6 +125,9 @@ final = value.unless bad_value, then: -> { some_method_call with_params }
 `transform` lets you specify a transformation hash and will return the value for the first matching key, or (if no matching key is found) the `:else` value.
 
 - Any `Proc` values in the transform hash are resolved (via `call`) before being returned.
+  - Values with arity 0 are `call`ed with no params.
+  - Values with arity 1 are `call`ed with the original value.
+  - Values with arity -1 (`lambda`s with an optional param) are `call`ed with the original value.
 - This method uses **case comparison** (`===`), so range and class keys work as you expect.
 
 ```ruby

data/inline_transforms.gemspec

@@ -0,0 +1,34 @@
+require_relative 'lib/inline_transforms/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.name          = 'inline_transforms'
+  spec.version       = InlineTransforms::VERSION
+  spec.authors       = ['Nestor Custodio']
+  spec.email         = ['nestor@custodio.org']
+
+  spec.summary       = 'Facilitates inline value logic.'
+  spec.homepage      = 'https://github.com/nestor-custodio/inline_transforms'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0") & Dir['*', 'lib/**/*']
+  spec.executables   = []
+  spec.require_paths = ['lib']
+
+  # ---
+
+  spec.metadata = {
+    # See: https://guides.rubygems.org/specification-reference/#metadata
+
+    # RubyGems.org Security
+    #
+    'allowed_push_host'     => 'https://rubygems.org',
+    'rubygems_mfa_required' => 'true',
+
+    # Metadata-Provided URIs
+    #
+    'homepage_uri'          => spec.homepage,
+    'changelog_uri'         => "#{spec.homepage}/blob/main/CHANGELOG.md"
+  }
+end

data/lib/inline_transforms/version.rb

@@ -1,3 +1,3 @@
 module InlineTransforms
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.3.1'.freeze
 end

data/lib/inline_transforms.rb

@@ -26,10 +26,7 @@ module InlineTransforms
   def only_if(good_value, **options)
     return self if inline_transforms_equality? good_value
 
-    alt_value = options[:else]
-    return alt_value.call if alt_value.is_a? Proc
-
-    alt_value
+    inline_transforms_response_processor options[:else]
   end
 
   # Returns `self` ... unless it matches a "bad" value, in which case it returns an alternate (`then:`) value.
@@ -50,10 +47,7 @@ module InlineTransforms
   def unless(bad_value, **options)
     return self unless inline_transforms_equality? bad_value
 
-    alt_value = options[:then]
-    return alt_value.call if alt_value.is_a? Proc
-
-    alt_value
+    inline_transforms_response_processor options[:then]
   end
 
   # Returns `self` ... unless it matches one of the keys in the given "transformation hash", in which case the
@@ -74,8 +68,8 @@ module InlineTransforms
   def transform(**options)
     default = options.delete :else
 
-    options.each { |key, value| return value.unless Proc, then: -> { value.call } if inline_transforms_equality? key }
-    default
+    options.each { |key, value| return inline_transforms_response_processor value if inline_transforms_equality? key }
+    inline_transforms_response_processor default
   end
 
   private
@@ -94,6 +88,27 @@ module InlineTransforms
     value === self
   end
 
+  # We want to pass fallback values through as-is **except for `Proc`s**,
+  # which we must resolve by passing `self` _or not_, as dictated by its arity.
+  #
+  # @param response_value [Object]
+  #   The `then`, `else`, or matching transform value from one of the above.
+  #
+  # @return [Object]
+  #   The given `response_value`, unless it's a `Proc`, in which case we want to resolve it first.
+  #
+  # @raise [ArgumentError]
+  #
+  def inline_transforms_response_processor(response_value)
+    return response_value unless response_value.is_a? Proc
+
+    case response_value.arity
+    when 0 then response_value.call
+    when 1, -1 then response_value.call self
+    else raise ArgumentError, 'fallback Proc must be of arity 0 or 1'
+    end
+  end
+
   # rubocop:enable Style/CaseEquality
 end
 

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: inline_transforms
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Nestor Custodio
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
@@ -15,27 +15,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".ruby-version"
-- ".yardopts"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
-- docs/InlineTransforms.html
-- docs/Object.html
-- docs/_index.html
-- docs/class_list.html
-- docs/css/common.css
-- docs/css/full_list.css
-- docs/css/style.css
-- docs/file.README.html
-- docs/file_list.html
-- docs/frames.html
-- docs/index.html
-- docs/js/app.js
-- docs/js/full_list.js
-- docs/js/jquery.js
-- docs/method_list.html
-- docs/top-level-namespace.html
+- inline_transforms.gemspec
 - lib/inline_transforms.rb
 - lib/inline_transforms/version.rb
 homepage: https://github.com/nestor-custodio/inline_transforms
@@ -43,9 +29,9 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/nestor-custodio/inline_transforms
-  changelog_uri: https://github.com/nestor-custodio/inline_transforms/CHANGELOG.md
   rubygems_mfa_required: 'true'
+  homepage_uri: https://github.com/nestor-custodio/inline_transforms
+  changelog_uri: https://github.com/nestor-custodio/inline_transforms/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib

data/.ruby-version

@@ -1 +0,0 @@
-3.4

data/.yardopts

@@ -1,4 +0,0 @@
---format='html'
---markup='markdown'
---no-private
---output-dir='./docs'