tins 1.32.0 → 1.44.0

data/lib/tins/xt.rb

@@ -3,7 +3,6 @@ require 'tins'
 module Tins
   require 'tins/xt/attempt'
   require 'tins/xt/blank'
-  require 'tins/xt/count_by'
   require 'tins/xt/deep_dup'
   require 'tins/xt/file_binary'
   require 'tins/xt/full'
@@ -22,12 +21,10 @@ module Tins
   require 'tins/xt/time_dummy'
   require 'tins/xt/date_dummy'
   require 'tins/xt/date_time_dummy'
-  require 'tins/xt/uniq_by'
   require 'tins/xt/write'
   require 'tins/xt/if_predicate'
   require 'tins/xt/ask_and_send'
   require 'tins/xt/extract_last_argument_options'
-  require 'tins/xt/deep_const_get'
   require 'tins/xt/responding'
   require 'tins/xt/proc_compose'
   require 'tins/xt/proc_prelude'
@@ -42,4 +39,7 @@ module Tins
   require 'tins/xt/complete'
   require 'tins/xt/expose'
   require 'tins/xt/temp_io'
+  require 'tins/xt/deprecate'
+  require 'tins/xt/hash_bfs'
+  require 'tins/xt/minimize'
 end

data/lib/tins.rb

@@ -1,7 +1,22 @@
+# Tins is a collection of useful Ruby utilities and tools that provide
+# common functionality without requiring external dependencies. It's designed
+# to be a lightweight, drop-in library that enhances Ruby's standard library
+# with practical conveniences.
+#
+# @example Basic usage
+#   require 'tins'
+#
+#   Tins::Once.only_once { puts "Only one instance" }
+#
+# @example Automatic class extensions
+#   require 'tins/xt'
+#
+#   # Automatically extends core classes with useful methods
+#   "foo".full? # => "foo"
+#   "   ".full? # => nil
 module Tins
   require 'tins/attempt'
   require 'tins/bijection'
-  require 'tins/count_by'
   require 'tins/deep_dup'
   require 'tins/file_binary'
   require 'tins/find'
@@ -25,16 +40,15 @@ module Tins
   require 'tins/string_camelize'
   require 'tins/string_underscore'
   require 'tins/string_version'
+  require 'tins/string_named_placeholders'
   require 'tins/subhash'
   require 'tins/time_dummy'
   require 'tins/date_dummy'
   require 'tins/date_time_dummy'
   require 'tins/to_proc'
-  require 'tins/uniq_by'
   require 'tins/version'
   require 'tins/write'
   require 'tins/extract_last_argument_options'
-  require 'tins/deep_const_get'
   require 'tins/responding'
   require 'tins/proc_compose'
   require 'tins/proc_prelude'
@@ -58,5 +72,7 @@ module Tins
   require 'tins/temp_io'
   require 'tins/temp_io_enum'
   require 'tins/lru_cache'
+  require 'tins/deprecate'
+  require 'tins/hash_bfs'
 end
 require 'tins/alias'

data/tests/annotate_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class AnnotateTest < Test::Unit::TestCase

data/tests/bijection_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class BijectionTest < Test::Unit::TestCase

data/tests/concern_test.rb

@@ -1,35 +1,94 @@
 require 'test_helper'
-require 'tins'
 
 class ConcernTest < Test::Unit::TestCase
-  module AC
+  module C1
     extend Tins::Concern
 
     included do
       $included = self
     end
 
+    prepended do
+      $prepended = self
+    end
+
     def foo
       :foo
     end
 
+    class_methods do
+      def baz1
+        :baz1
+      end
+    end
+
     module ClassMethods
       def bar
         :bar
       end
     end
+
+    class_methods do
+      def baz2
+        :baz2
+      end
+    end
   end
 
   $included = nil
+  $prepended = nil
+
+  module C2
+    extend Tins::Concern
+
+    def foo
+      :'prepended-foo'
+    end
+  end
+
 
   class A
-    include AC
+    include C1
+  end
+
+  class B
+    prepend C1
+  end
+
+  class C
+    def foo
+      :foo
+    end
   end
 
-  def test_concern
+  def test_concern_include
     a = A.new
     assert_equal A, $included
     assert_equal :foo, a.foo
     assert_equal :bar, A.bar
+    assert_equal :baz1, A.baz1
+    assert_equal :baz2, A.baz2
+    assert_raise(StandardError) do
+      C1.module_eval { included {} }
+    end
+  end
+
+  def test_concern_prepend
+    b = B.new
+    assert_equal B, $prepended
+    assert_equal :foo, b.foo
+    assert_equal :bar, B.bar
+    assert_equal :baz1, B.baz1
+    assert_equal :baz2, B.baz2
+    assert_raise(StandardError) do
+      C1.module_eval { prepended {} }
+    end
+  end
+
+  def test_prepended_method
+    c = C.new
+    assert_equal :foo, c.foo
+    C.class_eval { prepend C2 }
+    assert_equal :'prepended-foo', c.foo
   end
 end

data/tests/date_dummy_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class DateDummyTest < Test::Unit::TestCase

data/tests/date_time_dummy_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class DateTimeDummyTest < Test::Unit::TestCase

data/tests/delegate_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 
 class DelegationTestClass

data/tests/deprecate_test.rb

@@ -0,0 +1,41 @@
+require 'test_helper'
+
+module Tins
+  class DeprecateTest < Test::Unit::TestCase
+    class A < Array
+      attr_reader :warned
+
+      def warn(message)
+        @warned = message if message =~ /DEPRECATION/
+      end
+
+      extend Tins::Deprecate
+      deprecate method:
+        def zum_felde
+          to_a
+        end,
+        new_method: :to_a
+
+      extend Tins::Deprecate
+      deprecate method:
+        def zum_vektor
+          to_a
+        end,
+        message: '[DEPRECATION] method `%{method}` is obsolete.'
+    end
+
+    def test_deprecate
+      a = A[ 1, 2 ]
+      assert_nil a.warned
+      assert_equal [ 1, 2 ], a.zum_felde
+      assert_match(/zum_felde` is deprecated/, a.warned)
+    end
+
+    def test_deprecate_with_message
+      a = A[ 1, 2 ]
+      assert_nil a.warned
+      assert_equal [ 1, 2 ], a.zum_vektor
+      assert_match(/zum_vektor` is obsolete/, a.warned)
+    end
+  end
+end

data/tests/dslkit_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 class TL
   def initialize
@@ -66,6 +65,12 @@ class DA
   end
 
   dsl_reader :abc, *%w[a b c]
+
+  dsl_lazy_accessor :lazy do
+    :foo
+  end
+
+  dsl_lazy_accessor :lazy_no_default
 end
 
 class I
@@ -221,6 +226,15 @@ class PoliteTest < Test::Unit::TestCase
     assert_equal %w[a b c], @da.abc
   end
 
+  def test_lazy_accessor
+    assert_equal :foo, @da.lazy
+    @da.lazy { :bar }
+    assert_equal :bar, @da.lazy
+    assert_equal nil, @da.lazy_no_default
+    @da.lazy_no_default { :bar }
+    assert_equal :bar, @da.lazy_no_default
+  end
+
   def test_dsl_accessor_multiple
     assert_nil @da.foo
     assert_equal :bar, @da.bar

data/tests/duration_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class DurationTest < Test::Unit::TestCase
@@ -23,6 +22,10 @@ module Tins
       assert_equal '0+00:11:06.123456', Tins::Duration.new(666.123456).format
     end
 
+    def test_format_percentage
+      assert_equal '11%06', Tins::Duration.new(666.123456).format('%m%%%s')
+    end
+
     def test_smart_format
       assert_equal '00:11:06.123', Tins::Duration.new(666.123456).format('%D')
       assert_equal '7+17:11:06.123', Tins::Duration.new(666666.123456).format('%D')
@@ -76,6 +79,24 @@ module Tins
       assert_true duration.negative?
       assert_false Tins::Duration.new(42).negative?
     end
+
+    def test_parse_roundtrip
+      duration_string = '6+05:04:03.210'
+      seconds = Tins::Duration.parse(duration_string)
+      assert_equal duration_string, Tins::Duration.new(seconds).to_s
+    end
+
+    def test_parse_duration_instance
+      duration_string = '6+05:04:03.210'
+      duration = Tins::Duration.new(536643.21)
+      seconds = Tins::Duration.parse(duration)
+      assert_equal duration_string, Tins::Duration.new(seconds).to_s
+    end
+
+    def test_parse_percentage
+      duration_string = '1%2'
+      seconds = Tins::Duration.parse(duration_string, template: '%h%%%m')
+      assert_equal seconds, 3720
+    end
   end
 end
-

data/tests/dynamic_scope_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 class DynamicScopeTest < Test::Unit::TestCase
   include Tins::DynamicScope

data/tests/extract_last_argument_options_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class ExtractLastArgumentOptionsTest < Test::Unit::TestCase

data/tests/find_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins/find'
 require 'fileutils'
 require 'tempfile'
 

data/tests/from_module_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 class FromModuleTest < Test::Unit::TestCase
   module MyIncludedModule
@@ -12,6 +11,16 @@ class FromModuleTest < Test::Unit::TestCase
     end
   end
 
+  module MyIncludedModule2
+    def foo
+      :foo2
+    end
+
+    def bar
+      :bar2
+    end
+  end
+
   class MyKlass
     def foo
       :original_foo
@@ -36,14 +45,17 @@ class FromModuleTest < Test::Unit::TestCase
     def bar
       :original_bar
     end
+
+    def baz
+      :original_baz
+    end
     include MyIncludedModule
   end
 
   class AnotherDerivedKlass
-    include MyModule
-
     extend Tins::FromModule
 
+    include MyModule
     include from module: MyIncludedModule, methods: :foo
   end
 
@@ -58,4 +70,19 @@ class FromModuleTest < Test::Unit::TestCase
     assert_equal :foo, c.foo
     assert_equal :original_bar, c.bar
   end
+
+  class MixedClass
+    extend Tins::FromModule
+
+    include MyModule
+    include from module: MyIncludedModule, methods: :foo
+    include from module: MyIncludedModule2, methods: :bar
+  end
+
+  def test_mixed_klass
+    c = MixedClass.new
+    assert_equal :foo, c.foo
+    assert_equal :bar2, c.bar
+    assert_equal :original_baz, c.baz
+  end
 end

data/tests/generator_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class GeneratorTest < Test::Unit::TestCase

data/tests/go_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins/go'
 
 module Tins
   class GoTest < Test::Unit::TestCase

data/tests/hash_bfs_test.rb

@@ -0,0 +1,34 @@
+require 'test_helper'
+require 'tins/xt/hash_bfs'
+
+module Tins
+  class HashBFSTest < Test::Unit::TestCase
+    def setup
+      @hash = { a: 'foo', b: [ { c: 'baz' }, { d: 'quux' }, [ 'blub' ] ] }
+    end
+
+    def test_without_nodes
+      results = []
+      @hash.bfs { |*a| results.push(a) }
+      assert_equal [[:a, "foo"], [:c, "baz"], [:d, "quux"], [0, "blub"]], results
+    end
+
+    def test_with_nodes
+      results = []
+      @hash.bfs(visit_internal: true) { |*a| results.push(a) }
+      assert_equal(
+        [[nil, {a:"foo", b:[{c:"baz"}, {d:"quux"}, ["blub"]]}], [:a, "foo"],
+         [:b, [{c:"baz"}, {d:"quux"}, ["blub"]]], [0, {c:"baz"}], [1, {d:"quux"}],
+         [2, ["blub"]], [:c, "baz"], [:d, "quux"], [0, "blub"]], results
+      )
+      assert_equal 9, results.size
+    end
+
+    def test_with_nodes_with_circle
+      results = []
+      @hash[:b].last << @hash
+      @hash.bfs(visit_internal: true) { |*a| results.push(a) }
+      assert_equal 9, results.size
+    end
+  end
+end

data/tests/hash_symbolize_keys_recursive_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class HashSymbolizeKeysRecursiveTest < Test::Unit::TestCase

data/tests/implement_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class ImplementTest < Test::Unit::TestCase
@@ -54,14 +53,12 @@ module Tins
       assert_equal('blab', error_message { A.new.quux })
     end
 
-    if RUBY_VERSION >= "2.1"
-      def test_implement_def_subclass
-        assert_equal(
-          'method foobar(arg1,arg2:?) has to be '\
-          'implemented in subclasses of Tins::ImplementTest::A',
-          error_message { A.new.foobar }
-        )
-      end
+    def test_implement_def_subclass
+      assert_equal(
+        'method foobar(arg1,arg2:…) has to be '\
+        'implemented in subclasses of Tins::ImplementTest::A',
+        error_message { A.new.foobar }
+      )
     end
 
     private

data/tests/limited_test.rb

@@ -1,22 +1,22 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class LimitedTest < Test::Unit::TestCase
-    def test_limited
+    def test_process_with
       count = {}
-      limited = Tins::Limited.new(5)
-      5.times do
-        limited.execute do
-          count[Thread.current] = true
-          sleep 1
+      Tins::Limited.new(5, name: 'sleeper').process do |limited|
+        10.times do
+          limited.execute do
+            count[Thread.current] = true
+            sleep 1
+          end
         end
+        until count.size >= 10
+          sleep 0.1
+        end
+        limited.stop
       end
-      until count.size >= 5
-        sleep 0.1
-      end
-      assert_equal 5, count.keys.uniq.size
-      assert_equal 5, limited.wait.size
+      assert_equal 10, count.keys.uniq.size
     end
   end
 end

data/tests/lines_file_test.rb

@@ -1,6 +1,7 @@
+# frozen_string_literal: false
+
 require 'test_helper'
 require 'tempfile'
-require 'tins/lines_file'
 
 module Tins
   class TinsLinesFileTest < Test::Unit::TestCase

data/tests/lru_cache_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class LRUCacheTest < Test::Unit::TestCase
@@ -7,6 +6,18 @@ module Tins
       @cache = LRUCache.new(3)
     end
 
+    def test_too_low_capacity
+      assert_raise ArgumentError do
+        LRUCache.new(0)
+      end
+    end
+
+    def test_wrong_capacity_type
+      assert_raise TypeError do
+        LRUCache.new(:foo)
+      end
+    end
+
     def test_can_be_filled_to_capacity
       assert_equal 0, @cache.size
       @cache[1] = 1

data/tests/memoize_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class MemoizeTest < Test::Unit::TestCase

data/tests/method_description_test.rb

@@ -12,10 +12,8 @@ module Tins
     end
 
     def test_static_nonstatic
-      assert_equal 'Tins::MethodDescriptionTest::A#foo()', A.instance_method(:foo).to_s
-      assert_equal '#<UnboundMethod: Tins::MethodDescriptionTest::A#foo()>', A.instance_method(:foo).inspect
-      assert_equal 'Tins::MethodDescriptionTest::A.foo()', A.method(:foo).to_s
-      assert_equal '#<Method: Tins::MethodDescriptionTest::A.foo()>', A.method(:foo).inspect
+      assert_equal 'Tins::MethodDescriptionTest::A#foo()', A.instance_method(:foo).description
+      assert_equal 'Tins::MethodDescriptionTest::A.foo()', A.method(:foo).description
     end
 
     class B
@@ -33,12 +31,12 @@ module Tins
     end
 
     def test_standard_parameters_namespace
-      assert_equal 'Tins::MethodDescriptionTest::B#foo(x,y=?,*r,&b)',
-        B.instance_method(:foo).to_s
+      assert_equal 'Tins::MethodDescriptionTest::B#foo(x,y=…,*r,&b)',
+        B.instance_method(:foo).description
     end
 
     def test_standard_parameters_name
-      assert_equal 'foo(x,y=?,*r,&b)',
+      assert_equal 'foo(x,y=…,*r,&b)',
         B.instance_method(:foo).description(style: :name)
     end
 
@@ -84,21 +82,17 @@ module Tins
     end
 
     def test_keyword_parameters
-      assert_equal 'Tins::MethodDescriptionTest::C#foo(x,k:?,&b)', C.instance_method(:foo).to_s
-      assert_equal 'Tins::MethodDescriptionTest::C#bar(x,**k,&b)', C.instance_method(:bar).to_s
+      assert_equal 'Tins::MethodDescriptionTest::C#foo(x,k:…,&b)', C.instance_method(:foo).description
+      assert_equal 'Tins::MethodDescriptionTest::C#bar(x,**k,&b)', C.instance_method(:bar).description
     end
 
-    if RUBY_VERSION >= "2.1"
-      eval %{
-        class D
-          def foo(x, k:, &b)
-          end
-        end
-
-        def test_keyword_parameters_required
-          assert_equal 'Tins::MethodDescriptionTest::D#foo(x,k:,&b)', D.instance_method(:foo).to_s
-        end
-      }
+    class D
+      def foo(x, k:, &b)
+      end
+    end
+
+    def test_keyword_parameters_required
+      assert_equal 'Tins::MethodDescriptionTest::D#foo(x,k:,&b)', D.instance_method(:foo).description
     end
   end
 end

data/tests/minimize_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class MinimizeTest < Test::Unit::TestCase

data/tests/module_group_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class ModuleGroupTest < Test::Unit::TestCase

data/tests/named_set_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins/named_set'
 
 module Tins
   class NamedSetTest < Test::Unit::TestCase

data/tests/null_test.rb

@@ -1,5 +1,4 @@
 require 'test_helper'
-require 'tins'
 
 module Tins
   class NullTest < Test::Unit::TestCase

data/tests/partial_application_test.rb

@@ -13,9 +13,13 @@ module Tins
 
     def test_proc
       mul   = lambda { |x, y| x * y }
+      assert_equal 2, mul.arity
       klon  = mul.partial
+      assert_equal 2, klon.arity
       dup   = mul.partial(2)
+      assert_equal 1, dup.arity
       trip  = mul.partial(3)
+      assert_equal 1, trip.arity
       assert_equal [ 6, 9, 12 ], [ dup[3], trip[3], mul[4, 3] ]
       assert_equal [ 6, 9, 12 ], [ dup[3], trip[3], klon[4, 3] ]
       assert_raise(ArgumentError) do