token-resolver 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66d9dd5b6e50ded563ba876174ef20a039d7c074193136becdb5c49117b34039
-  data.tar.gz: 24245d7bd943145c2c7096931d3d2b5c514b226538e2c1f0f35dc408c72a9cb8
+  metadata.gz: 6b23a9edef4ee26b3306a11c3829662efdfd3d813f325125fea41a12ab52a4d8
+  data.tar.gz: 69f56a454fb92a428d07c19357f7f30f6c343c9538ad7931797bb0c40263d61c
 SHA512:
-  metadata.gz: 178cc7d07c311b8c8c66b022c71a6ef0e6fa6e903b00abe2c815d217ff03129ff546b66ea02f956e85c71149a56c02340e4f0fdff7c6acb02fe44e6d736736cb
-  data.tar.gz: 9acb5dd248d648b4db87d34fa39f34401e365904b899736a0ef97f21dca47beb8446b02673e9ce7dd7bdca5045a909127b2765e18bc99a5a8ffd8d079cfd917e
+  metadata.gz: 2eb601757412886989daabc322e8128c24c0afc8cbad62195a6d987fe11e6ff6c9b0946831d2b570b589991f0070ecbca60a47787343b9b1c973b07c23f4baec
+  data.tar.gz: 62b7ec4552e63c67d80ca72e67931b87091a71311adb4e6c3fcc560fc6efff888606970fe24bacbcf201ab5b58c73f58fba497cfa25963060348df8b01271770

data/CHANGELOG.md

@@ -30,6 +30,27 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.2] - 2026-02-22
+
+- TAG: [v1.0.2][1.0.2t]
+- COVERAGE: 98.13% -- 263/268 lines in 10 files
+- BRANCH COVERAGE: 91.18% -- 62/68 branches in 10 files
+- 96.77% documented
+
+### Added
+
+- **Benchmarking tools** — Performance comparison suite comparing `token-resolver` against simpler
+  alternatives (`String#gsub` and `Kernel#sprintf`):
+  - `benchmarks/comparison.rb` — Comprehensive benchmark script measuring iterations per second
+    across four realistic scenarios (simple replacement, moderate complexity, high complexity,
+    and large documents with sparse tokens)
+  - `gemfiles/modular/benchmark/ips.gemfile` — Development dependency for `benchmark-ips` gem
+  - Rake tasks: `rake bench:comparison` (run comparison), `rake bench:list` (list benchmarks),
+    `rake bench:run` (run all benchmarks), `rake bench` (alias)
+  - `BENCHMARK.md` — Results and analysis showing token-resolver is 100-3000x slower due to
+    PEG parsing, validation, and AST building; includes guidance on when to use each approach
+    and real-world performance context
+
 ## [1.0.1] - 2026-02-22
 
 - TAG: [v1.0.1][1.0.1t]
@@ -70,7 +91,9 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
-[Unreleased]: https://github.com/kettle-rb/token-resolver/compare/v1.0.1...HEAD
+[Unreleased]: https://github.com/kettle-rb/token-resolver/compare/v1.0.2...HEAD
+[1.0.2]: https://github.com/kettle-rb/token-resolver/compare/v1.0.1...v1.0.2
+[1.0.2t]: https://github.com/kettle-rb/token-resolver/releases/tag/v1.0.2
 [1.0.1]: https://github.com/kettle-rb/token-resolver/compare/v1.0.0...v1.0.1
 [1.0.1t]: https://github.com/kettle-rb/token-resolver/releases/tag/v1.0.1
 [1.0.0]: https://github.com/kettle-rb/ast-merge/compare/e0e299cad6e6914d512845c71df6b7ac8009e5ac...v1.0.0

data/README.md

@@ -286,6 +286,34 @@ infinite loops and ensures predictable behavior when replacement values contain
 If the input doesn't contain the `pre` delimiter at all, the parser fast-paths and returns
 a single Text node without invoking parslet.
 
+#### 📊 Benchmarks
+
+Token-resolver prioritizes **flexibility, configurability, and maintainability** over raw speed.
+
+**⚠️ Important**: Token-resolver is **100-3000x slower** than simple alternatives like `String#gsub` and `Kernel#sprintf`.
+because it does significantly more work:
+- Full PEG parsing of the input string
+- Token validation and structure enforcement
+- Building an AST for introspection
+- Flexible error handling for missing tokens
+
+This performance difference is **expected and acceptable** because these are fundamentally different
+approaches solving different problems.
+
+See [BENCHMARK.md](BENCHMARK.md) for detailed performance comparisons and guidance on:
+
+- **When to use token-resolver**: Configurable token structures, validation, introspection, flexible error handling
+- **When to use String#gsub**: Fixed token patterns, maximum performance, simple one-shot replacements
+- **When to use Kernel#sprintf**: Positional formatting, fixed templates, printf-style output
+
+The choice should be based on your actual requirements, not just raw performance metrics.
+
+To run benchmarks on your system:
+
+```bash
+bundle exec rake bench:comparison
+```
+
 ### False Positive Prevention
 
 The grammar constrains segment content to the configured `segment_pattern` (default: word
@@ -294,7 +322,6 @@ block parameters (`{ |x| expr }`) or shell variable expansion (`${VAR:+val}`)
 mistakenly parsed as a token. Replacement keys that contain characters outside the
 `segment_pattern` are rejected with an `ArgumentError` at resolve time.
 
-
 ## 🦷 FLOSS Funding
 
 While kettle-rb tools are free software and will always be, the project would benefit immensely from some funding.

data/lib/token/resolver/version.rb

@@ -5,7 +5,7 @@ module Token
     # Version information for Token::Resolver
     module Version
       # Current version of the token-resolver gem
-      VERSION = "1.0.1"
+      VERSION = "1.0.2"
     end
     VERSION = Version::VERSION # traditional location
   end

data.tar.gz.sig

@@ -1,4 +1 @@
-iد�쾰�'Ctۨfi��(�t!��I�S���?��o�
-�}l���1�%��p=>U
-�#F��h<cg0G��,*	A�4)8��h�h`]��X�ۛ��M�<���-M�!���Z�txKFl�CJ�ˇ�d^	� �6�;+�ԝ�Q3�m�{���X
-���ѫ1ى�p����[z{v�r&2��	N�,���9�k��Q攛�Տݰr졽�^��"uQI	���+r����F��Vm��Uxw&`�	��Rނ��������[]Z��x����j���b
-��p��W�F�Ԣ?�#�����~��ޙ�#b�>��ɀ�?��sՈ��/����������Қ��{QJj�gZI���*�v��?��?|mH3��O�$4�1��d�;�t�Z����|1(eSi�ۀ�����}�kaWdƞ�
+
V���'''��' ���k�0����K-��#$7��G���*���{@P7��R��!�IVd�^	��X^Km��,u��j�D8��,B{B�T�p����t0��	�M�ơ�|@��Ss_u�m��f�+L�Vyj�
��s���k>��$��D�p�b�N_"���.
�u�4�Z
�.N|;n���X�Z/Fʾ�2
��e�Jv;(�b!H��hLP�w��TTwe2F

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: token-resolver
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Peter H. Boling
@@ -274,10 +274,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://token-resolver.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/token-resolver/tree/v1.0.1
-  changelog_uri: https://github.com/kettle-rb/token-resolver/blob/v1.0.1/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/token-resolver/tree/v1.0.2
+  changelog_uri: https://github.com/kettle-rb/token-resolver/blob/v1.0.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/token-resolver/issues
-  documentation_uri: https://www.rubydoc.info/gems/token-resolver/1.0.1
+  documentation_uri: https://www.rubydoc.info/gems/token-resolver/1.0.2
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/token-resolver/wiki
   news_uri: https://www.railsbling.com/tags/token-resolver