tins 1.51.0 → 1.51.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0842c03ef937e88e3983fe986604f369f741c783d5aeb1f73a27d50f98512265'
-  data.tar.gz: aeaf30f783e232586deb4b60017623539d37973a035331050c5d4c75c9af1f72
+  metadata.gz: dce6e60b660a0f614d5e3964270e99aaff36fa473a54efa387de8e17fc0e331b
+  data.tar.gz: f6f4c1fcad05d874d6e20897c42f211cd1d7ed6892ef9d539816b7641d56129c
 SHA512:
-  metadata.gz: fc76519aa6e09ff9a9e8094712070f71be2f34540a4001af2f6f07c5de357ac8642230828d543ffa53219936bf877db88e02e6dfb3a6f713e312b236b45e3d2a
-  data.tar.gz: 9e65ecc2199824d5efafb4502c9c5bef6322c5e9cad8f9f72504bb0571d09b15251e539db7b6336cad0af161e382bb2bf473fcaf720d2f146a6dba3b2757f84f
+  metadata.gz: 3e33a9d1241117807d6dcba8fa72087d57fa70587015e2fb6988f6221ac00054149c5770ef856a83a1b1a478a6cc27aca117b9f0f23cf582867200159d4d486b
+  data.tar.gz: 6a3310dec353f33acf140b4e971e7be1269bb413fd2b3b13d29fc777573d69b14a932a35977832c58d87b80cab90cd4f326542030c7d422aa8bf0df53830940a

data/CHANGES.md

@@ -1,5 +1,15 @@
 # Changes
 
+## 2026-01-14 v1.51.1
+
+- Simplified `lru_cache` implementation to not need `NOT_EXIST`
+- Updated `rubygems_version` from **4.0.2** to **4.0.3**
+- Changed `gem_hadar` development dependency from "~> 2.10" to ">= 2.16.3"
+- Updated Ruby image version from 4.0-rc-alpine to 4.0-alpine in CI pipeline
+- Added comprehensive module documentation for `DSLKit` explaining its purpose
+  and features
+- Added `CHANGES.md` file to gem release process using `GemHadar`
+
 ## 2025-12-20 v1.51.0
 
 - Added `readline` as a runtime dependency in both `Rakefile` and

data/Rakefile

@@ -22,6 +22,10 @@ GemHadar do
   licenses <<       'MIT'
   clean <<          'coverage'
 
+  changelog do
+    filename 'CHANGES.md'
+  end
+
   github_workflows(
     'static.yml' => {}
   )

data/lib/tins/dslkit.rb

@@ -1137,4 +1137,69 @@ module Tins
     end
   end
 end
+# DSLKit provides a comprehensive framework for building Domain Specific Languages
+# and configuration systems in Ruby.
+#
+# DSLKit is designed to make it easy to create clean, expressive APIs that feel
+# natural to Ruby developers. It provides a collection of utilities for:
+#
+# - Creating method-based accessors and constants
+# - Working with singleton classes and eigenclasses
+# - Building thread-safe global variables
+# - Implementing dynamic code evaluation
+# - Creating symbolic method handling
+# - Deflecting method calls for interception
+# - Providing delegate patterns for method forwarding
+# - Building blank slates for clean API surfaces
+#
+# The framework is organized around several key modules:
+#
+# - Tins::DSLAccessor: For creating configurable accessors with default values
+# - Tins::Constant: For creating method-based constants
+# - Tins::Eigenclass: For working with singleton classes
+# - Tins::ClassMethod: For defining class methods dynamically
+# - Tins::ThreadGlobal: For thread-safe global variables
+# - Tins::Interpreter: For dynamic code evaluation
+# - Tins::SymbolMaker: For symbolic method handling
+# - Tins::ConstantMaker: For symbolic constant handling
+# - Tins::Deflect: For method call interception
+# - Tins::Delegate: For method delegation patterns
+# - Tins::BlankSlate: For creating clean API surfaces
+#
+# @example Basic DSL usage
+#   class Config
+#     extend Tins::DSLAccessor
+#     dsl_accessor :port, 8080
+#     dsl_accessor :host, 'localhost'
+#   end
+#
+#   config = Config.new
+#   config.port    # => 8080
+#   config.port 8081  # Sets port to 8081
+#
+# @example Method deflection
+#   class Calculator
+#     def add(a, b)
+#       a + b
+#     end
+#   end
+#
+#   calc = Calculator.new
+#   Tins::Deflect.deflect(Calculator, :add) do |obj, method, *args|
+#     # Custom behavior for add method
+#     args.sum
+#   end
+#
+#   calc.add(1, 2, 3)  # => 6 (sum instead of addition)
+#
+# @see Tins::DSLAccessor
+# @see Tins::Constant
+# @see Tins::Eigenclass
+# @see Tins::ClassMethod
+# @see Tins::ThreadGlobal
+# @see Tins::Interpreter
+# @see Tins::SymbolMaker
+# @see Tins::Deflect
+# @see Tins::Delegate
+# @see Tins::BlankSlate
 DSLKit = Tins

data/lib/tins/lru_cache.rb

@@ -3,15 +3,10 @@ module Tins
   #
   # This cache maintains a fixed-size collection of key-value pairs,
   # automatically removing the least recently accessed item when the capacity
-  # is exceeded.
+  # is exceeded. Both read and write are considered access.
   class LRUCache
     include Enumerable
 
-    # Our "nil" value if it wasn' set by clients
-    NOT_EXIST = Object.new.freeze
-
-    private_constant :NOT_EXIST
-
     # Initializes a new LRU cache with the specified capacity.
     #
     # @param capacity [Integer] maximum number of items the cache can hold
@@ -19,7 +14,7 @@ module Tins
       @capacity = Integer(capacity)
       @capacity >= 1 or
         raise ArgumentError, "capacity should be >= 1, was #@capacity"
-      @data     = {}
+      @data     = {} # Least-recently used will always be the first element
     end
 
     # Returns the maximum capacity of the cache.
@@ -35,11 +30,8 @@ module Tins
     # @param key [Object] the key to look up
     # @return [Object, nil] the value for the key or nil if not found
     def [](key)
-      case value = @data.delete(key) { NOT_EXIST }
-      when NOT_EXIST
-        nil
-      else
-        @data[key] = value
+      if @data.has_key?(key)
+        @data[key] = @data.delete(key)
       end
     end
 
@@ -56,7 +48,7 @@ module Tins
       @data.delete(key)
       @data[key] = value
       if @data.size > @capacity
-        @data.delete(@data.keys.first)
+        @data.shift
       end
       value
     end

data/lib/tins/version.rb

@@ -1,6 +1,6 @@
 module Tins
   # Tins version
-  VERSION         = '1.51.0'
+  VERSION         = '1.51.1'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/tests/lru_cache_test.rb

@@ -7,9 +7,10 @@ module Tins
     end
 
     def test_too_low_capacity
-      assert_raise ArgumentError do
+      ex = assert_raise ArgumentError do
         LRUCache.new(0)
       end
+      assert_equal 'capacity should be >= 1, was 0', ex.message
     end
 
     def test_wrong_capacity_type

data/tins.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: tins 1.51.0 ruby lib
+# stub: tins 1.51.1 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "tins".freeze
-  s.version = "1.51.0".freeze
+  s.version = "1.51.1".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -17,13 +17,13 @@ Gem::Specification.new do |s|
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "Tins - Useful stuff.".freeze, "--main".freeze, "README.md".freeze]
   s.required_ruby_version = Gem::Requirement.new(">= 3.1".freeze)
-  s.rubygems_version = "4.0.2".freeze
+  s.rubygems_version = "4.0.3".freeze
   s.summary = "Useful stuff.".freeze
   s.test_files = ["tests/annotate_test.rb".freeze, "tests/ask_and_send_test.rb".freeze, "tests/attempt_test.rb".freeze, "tests/bijection_test.rb".freeze, "tests/blank_full_test.rb".freeze, "tests/case_predicate_test.rb".freeze, "tests/concern_test.rb".freeze, "tests/date_dummy_test.rb".freeze, "tests/date_time_dummy_test.rb".freeze, "tests/deep_dup_test.rb".freeze, "tests/delegate_test.rb".freeze, "tests/deprecate_test.rb".freeze, "tests/dslkit_test.rb".freeze, "tests/duration_test.rb".freeze, "tests/dynamic_scope_test.rb".freeze, "tests/expose_test.rb".freeze, "tests/extract_last_argument_options_test.rb".freeze, "tests/file_binary_test.rb".freeze, "tests/find_test.rb".freeze, "tests/from_module_test.rb".freeze, "tests/generator_test.rb".freeze, "tests/go_test.rb".freeze, "tests/hash_bfs_test.rb".freeze, "tests/hash_symbolize_keys_recursive_test.rb".freeze, "tests/hash_union_test.rb".freeze, "tests/if_predicate_test.rb".freeze, "tests/implement_test.rb".freeze, "tests/limited_test.rb".freeze, "tests/lines_file_test.rb".freeze, "tests/lru_cache_test.rb".freeze, "tests/memoize_test.rb".freeze, "tests/method_description_test.rb".freeze, "tests/minimize_test.rb".freeze, "tests/module_group_test.rb".freeze, "tests/named_set_test.rb".freeze, "tests/named_test.rb".freeze, "tests/null_test.rb".freeze, "tests/p_test.rb".freeze, "tests/partial_application_test.rb".freeze, "tests/proc_compose_test.rb".freeze, "tests/proc_prelude_test.rb".freeze, "tests/range_plus_test.rb".freeze, "tests/require_maybe_test.rb".freeze, "tests/responding_test.rb".freeze, "tests/rotate_test.rb".freeze, "tests/scope_test.rb".freeze, "tests/secure_write_test.rb".freeze, "tests/sexy_singleton_test.rb".freeze, "tests/string_byte_order_mark_test.rb".freeze, "tests/string_camelize_test.rb".freeze, "tests/string_named_placeholders.rb".freeze, "tests/string_underscore_test.rb".freeze, "tests/string_version_test.rb".freeze, "tests/subhash_test.rb".freeze, "tests/temp_io_test.rb".freeze, "tests/test_helper.rb".freeze, "tests/time_dummy_test.rb".freeze, "tests/time_freezer_test.rb".freeze, "tests/to_test.rb".freeze, "tests/token_test.rb".freeze, "tests/unit_test.rb".freeze, "tests/annotate_test.rb".freeze, "tests/ask_and_send_test.rb".freeze, "tests/attempt_test.rb".freeze, "tests/bijection_test.rb".freeze, "tests/blank_full_test.rb".freeze, "tests/case_predicate_test.rb".freeze, "tests/concern_test.rb".freeze, "tests/date_dummy_test.rb".freeze, "tests/date_time_dummy_test.rb".freeze, "tests/deep_dup_test.rb".freeze, "tests/delegate_test.rb".freeze, "tests/deprecate_test.rb".freeze, "tests/dslkit_test.rb".freeze, "tests/duration_test.rb".freeze, "tests/dynamic_scope_test.rb".freeze, "tests/expose_test.rb".freeze, "tests/extract_last_argument_options_test.rb".freeze, "tests/file_binary_test.rb".freeze, "tests/find_test.rb".freeze, "tests/from_module_test.rb".freeze, "tests/generator_test.rb".freeze, "tests/go_test.rb".freeze, "tests/hash_bfs_test.rb".freeze, "tests/hash_symbolize_keys_recursive_test.rb".freeze, "tests/hash_union_test.rb".freeze, "tests/if_predicate_test.rb".freeze, "tests/implement_test.rb".freeze, "tests/limited_test.rb".freeze, "tests/lines_file_test.rb".freeze, "tests/lru_cache_test.rb".freeze, "tests/memoize_test.rb".freeze, "tests/method_description_test.rb".freeze, "tests/minimize_test.rb".freeze, "tests/module_group_test.rb".freeze, "tests/named_set_test.rb".freeze, "tests/named_test.rb".freeze, "tests/null_test.rb".freeze, "tests/p_test.rb".freeze, "tests/partial_application_test.rb".freeze, "tests/proc_compose_test.rb".freeze, "tests/proc_prelude_test.rb".freeze, "tests/range_plus_test.rb".freeze, "tests/require_maybe_test.rb".freeze, "tests/responding_test.rb".freeze, "tests/rotate_test.rb".freeze, "tests/scope_test.rb".freeze, "tests/secure_write_test.rb".freeze, "tests/sexy_singleton_test.rb".freeze, "tests/string_byte_order_mark_test.rb".freeze, "tests/string_camelize_test.rb".freeze, "tests/string_underscore_test.rb".freeze, "tests/string_version_test.rb".freeze, "tests/subhash_test.rb".freeze, "tests/temp_io_test.rb".freeze, "tests/time_dummy_test.rb".freeze, "tests/time_freezer_test.rb".freeze, "tests/to_test.rb".freeze, "tests/token_test.rb".freeze, "tests/unit_test.rb".freeze]
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.10".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.16.3".freeze])
   s.add_development_dependency(%q<all_images>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tins
 version: !ruby/object:Gem::Version
-  version: 1.51.0
+  version: 1.51.1
 platform: ruby
 authors:
 - Florian Frank
@@ -13,16 +13,16 @@ dependencies:
   name: gem_hadar
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: 2.16.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: 2.16.3
 - !ruby/object:Gem::Dependency
   name: all_images
   requirement: !ruby/object:Gem::Requirement
@@ -498,7 +498,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Useful stuff.
 test_files: