tins 1.47.0 → 1.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37dea3f4959ecf698b1908647ef0a7e1c19abe61aa669bbc63aa65fde10714e4
-  data.tar.gz: 78d9256391b2a6dd105be5bc8e0b37aef0508516ddc2cbc578e4766a4f02a50c
+  metadata.gz: fa1d017de1e131e88ad3f54ae37abc4ff5020399f48a5fd97d3fd19a3ffca6e9
+  data.tar.gz: 50233d748b6362c332e51089923a6ef49f7e2e07044fa7f5843761adac219b0f
 SHA512:
-  metadata.gz: 04d75c6e6264659e08574a21bf0a2899702a7765ca90e32baec72056b6a95a639b35aeef7c0ad0d81a35287b3b076b9185f029be9115ae1d0b009236a3a4ca2a
-  data.tar.gz: df69723660df31a08011a5209d460d55a6422cc1999067e2739365866ce30f4f2135a81484d722ae9ac9d83a0ed1c9cdbfe53d1f76ee6060457ad292717cd126
+  metadata.gz: 6318e15f121a8924c548d793f92f28b1eaae0688b0c26a347501fd57f0e493c49edeff0501a5bc0b977ecde21d1eadc7a4adae335a3de9f542cedaf6956e2289
+  data.tar.gz: 768135b3fc2f635a728fcc14c5fc4d0648cfba85c973072a53557ae5c60fb00587af96944066a4bd9df0773b0dab066d540f0197e040b861064eedceaf27231e

data/CHANGES.md

@@ -1,5 +1,19 @@
 # Changes
 
+## 2025-12-05 v1.48.0
+
+- Added `Tins::Token.analyze` class method to calculate bit strength
+- Moved bit calculation logic from `initialize` to `analyze` method for reuse
+- Implemented bit strength calculation using formula: `length ×
+  log₂(alphabet_size)`
+- Added comprehensive tests for the `analyze` method with various alphabets
+- Support both token string and length-based analysis
+- Implemented proper error handling for required parameters
+- Updated `initialize` method to use the new `analyze` method
+- Test cases verify bit strength for **BASE16**, **BASE64**, and **BASE32**
+  alphabets
+- Method returns integer bit strength for cryptographic token analysis
+
 ## 2025-11-14 v1.47.0
 
 - Tins::GO

data/lib/tins/token.rb

@@ -81,7 +81,7 @@ module Tins
         bits > 0 or raise ArgumentError, 'bits has to be positive'
         length = (Math.log(1 << bits) / Math.log(alphabet.size)).ceil
       end
-      self.bits = (Math.log(alphabet.size ** length) / Math.log(2)).floor
+      self.bits = self.class.analyze(alphabet:, length:)
       token = +''
       length.times { token << alphabet[random.random_number(alphabet.size)] }
       super token
@@ -91,5 +91,22 @@ module Tins
     #
     # @return [Integer] the number of bits of entropy in the token
     attr_accessor :bits
+
+    # The analyze method calculates the bit length of a token based on its
+    # alphabet and length.
+    #
+    # @param alphabet [String] the alphabet used for token generation, defaults
+    #   to Tins::Token::DEFAULT_ALPHABET
+    # @param token [String, nil] the token string to analyze, optional
+    # @param length [Integer, nil] the length of the token, optional
+    #
+    # @return [Integer] the calculated bit length of the token
+    #
+    # @raise [ArgumentError] if neither token nor length is provided, or if both are provided
+    def self.analyze(alphabet: Tins::Token::DEFAULT_ALPHABET, token: nil, length: nil)
+      token.nil? ^ length.nil? or raise ArgumentError, 'either token or length is required'
+      length ||= token.length
+      (Math.log(alphabet.size ** length) / Math.log(2)).floor
+    end
   end
 end

data/lib/tins/unit.rb

@@ -26,6 +26,18 @@ module Tins
       '', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y',
     ].each_with_index.map { |n, i| Prefix.new(n.freeze, 1024, 1024 ** i, false) }.freeze
 
+    # An array of prefix objects for uppercase binary prefixes (Ki, Mi, Gi...) based
+    # on 1024-step increments.
+    PREFIX_IEC_UC = [
+      '', 'Ki', 'Mi', 'Gi', 'Ti', 'Pi', 'Ei', 'Zi', 'Yi',
+    ].each_with_index.map { |n, i| Prefix.new(n.freeze, 1024, 1024 ** i, false) }.freeze
+
+    # An array of prefix objects for uppercase SI unit prefixes (K, M, G...) based
+    # on 1000-step increments.
+    PREFIX_SI_UC = [
+      '', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y',
+    ].each_with_index.map { |n, i| Prefix.new(n.freeze, 1000, 1000 ** i, false) }.freeze
+
     # An array of prefix objects for fractional prefixes (m, µ, n...) based on
     # 1000-step decrements.
     PREFIX_F = [
@@ -51,10 +63,14 @@ module Tins
       case identifier
       when :uppercase, :uc, 1024
         PREFIX_UC
+      when :iec_uppercase, :iec_uc
+        PREFIX_IEC_UC
       when :lowercase, :lc, 1000
         PREFIX_LC
-      when :fraction, :f, 0.001
+      when :fraction, :f, :si_greek, 0.001
         PREFIX_F
+      when :si_uc, :si_uppercase
+        PREFIX_SI_UC
       when Array
         identifier
       end

data/lib/tins/version.rb

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

data/tests/token_test.rb

@@ -32,6 +32,37 @@ module Tins
       assert_equal 128, token.length
       assert_equal 256, token.bits
     end
+
+    def test_analyze_method
+      # Test with default alphabet and length
+      bits = Tins::Token.analyze(alphabet: Tins::Token::DEFAULT_ALPHABET, length: 22)
+      assert_equal 130, bits
+
+      # Test with hex alphabet and length
+      bits = Tins::Token.analyze(alphabet: Tins::Token::BASE16_LOWERCASE_ALPHABET, length: 32)
+      assert_equal 128, bits  # 32 × 4 = 128 bits
+
+      # Test with base64 alphabet and length
+      bits = Tins::Token.analyze(alphabet: Tins::Token::BASE64_ALPHABET, length: 44)
+      assert_equal 264, bits  # 44 × 6 = 264 bits
+
+      # Test with base32 alphabet and length
+      bits = Tins::Token.analyze(alphabet: Tins::Token::BASE32_ALPHABET, length: 52)
+      assert_equal 260, bits  # 52 × 5 = 260 bits
+
+      # Test with token string instead of length
+      token = "5f4dcc3b5aa765d61d8327deb882cf99"
+      bits = Tins::Token.analyze(alphabet: Tins::Token::BASE16_LOWERCASE_ALPHABET, token: token)
+      assert_equal 128, bits
+
+      # Test error handling
+      assert_raise(ArgumentError) do
+        Tins::Token.analyze(alphabet: Tins::Token::DEFAULT_ALPHABET)
+      end
+
+      assert_raise(ArgumentError) do
+        Tins::Token.analyze(alphabet: Tins::Token::DEFAULT_ALPHABET, token: "test", length: 5)
+      end
+    end
   end
 end
-

data/tests/unit_test.rb

@@ -15,6 +15,11 @@ module Tins
       assert_equal Tins::Unit::PREFIX_F, prefixes(0.001)
       assert_equal Tins::Unit::PREFIX_F, prefixes(:f)
       assert_equal Tins::Unit::PREFIX_F, prefixes(:fraction)
+      assert_equal Tins::Unit::PREFIX_F, prefixes(:si_greek)
+      assert_equal Tins::Unit::PREFIX_SI_UC, prefixes(:si_uc)
+      assert_equal Tins::Unit::PREFIX_SI_UC, prefixes(:si_uppercase)
+      assert_equal Tins::Unit::PREFIX_IEC_UC, prefixes(:iec_uc)
+      assert_equal Tins::Unit::PREFIX_IEC_UC, prefixes(:iec_uppercase)
       assert_equal nil, prefixes(:nix)
     end
 
@@ -42,6 +47,19 @@ module Tins
         format(0.000_000_123, format: '%.3f %U', prefix: :f, unit: ?F)
     end
 
+    def test_format_si_multipliers
+      assert_equal '23 KHz',
+        format(23 * 1000, format: '%d %U', prefix: :si_uc, unit: 'Hz')
+      assert_equal '-23 KHz',
+        format(-23 * 1000, format: '%d %U', prefix: :si_uc, unit: 'Hz')
+      assert_equal '23.1 KHz',
+        format(23 * 1000 + 111, format: '%.1f %U', prefix: :si_uc, unit: 'Hz')
+      assert_equal 'KHz: 23',
+        format(23 * 1000, format: '%U: %d', prefix: :si_uc, unit: 'Hz')
+      assert_equal 'KHz: 23.12',
+        format(23 * 1000 + 120, prefix: :si_uc, format: '%U: %.2f', unit: 'Hz')
+    end
+
     def test_parse
       assert_in_delta 17_301_504, parse('16.5 Mb').to_i, 1e-5
       assert_in_delta 16_500_000, parse('16.5 mbps', unit: 'bps').to_i, 1e-5

data/tins.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: tins 1.47.0 ruby lib
+# stub: tins 1.49.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "tins".freeze
-  s.version = "1.47.0".freeze
+  s.version = "1.49.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -17,7 +17,7 @@ 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 = "3.7.2".freeze
+  s.rubygems_version = "4.0.2".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]
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tins
 version: !ruby/object:Gem::Version
-  version: 1.47.0
+  version: 1.49.0
 platform: ruby
 authors:
 - Florian Frank
@@ -484,7 +484,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.2
 specification_version: 4
 summary: Useful stuff.
 test_files: