shenanigans 1.0.13 → 1.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9f1eccb5f91c4900d73028357417c17999b7c69b5e775d506973fd90eeff8d6
-  data.tar.gz: 8c3d497d30c2081f7262096c3af8a7c3e65cec4d0841265476bae9943bd0a302
+  metadata.gz: 6e7e996c24ffbe66519073bafd5f160aba38a5de770493d2b6ef013c68398aae
+  data.tar.gz: f4785e43a5297504fe49818b80d7f5e57d6f32040c01f89548e1c303f3527556
 SHA512:
-  metadata.gz: a3feeb73a90347f1270f214a7fab07316c08823908c1fc76f434a56bccd40e1a600cf2155942469d2028bcef60fa02d8391b163b95d3f4dcc1b621711ece36e2
-  data.tar.gz: d9e206db73770af8e1265152eedcfbcca3ffdfb60bb1afc0f1fc0ae9c10704062d862dbc5f9b99bf90d5bf4be512dd57c75408da99c2944cf2bcc3d06ef40d17
+  metadata.gz: f7e8cb5e2a908f55f863e0859d5ff1ac58bef88ecab500d3f370c2162a25c0ce879e0e2db120cecec7c7ad9a5293ecebd430259afc11f6f50c22c8955609e8b7
+  data.tar.gz: dbbd0e0967510ce79c8ab5b47dcf791b31e6b9912b6e25deaba260c9b9c1e9cff2932e41ae4deb9eb04a3cc9e0c929b133221921141013050a871add2eee5264

data/lib/shenanigans/array/caret.rb

@@ -1,7 +1,8 @@
 class Array
   # Returns an array containing elements exclusive between two arrays.
-  #   [1, 2, 3] ^ [1, 2, 4]
-  #   #=> [3, 4]
+  #
+  # @example
+  #   [1, 2, 3] ^ [1, 2, 4] #=> [3, 4]
   def ^(other)
     (self - other) | (other - self)
   end

data/lib/shenanigans/array/random_subarray.rb

@@ -2,15 +2,17 @@ class Array
   # Generates random subarrays. Uses random numbers and
   # bit-fiddling to assure performant uniform distributions
   # even for large arrays.
+  #
+  # @example
   #   a = *1..5
-  #   a.random_subarray(3)
-  #   #=> [[1, 3, 5], [2, 4], [1, 3, 4, 5]]
+  #   a.random_subarray(3) #=> [[1, 3, 5], [2, 4], [1, 3, 4, 5]]
 
-  def random_subarray(n=1)
+  def random_subarray(n = 1)
     raise ArgumentError, "negative argument" if n < 0
+
     (1..n).map do
-      r = rand(2**self.size)
-      self.select.with_index { |_, i| r[i] == 1 }
+      r = rand(2**size)
+      select.with_index { |_, i| r[i] == 1 }
     end
   end
 end

data/lib/shenanigans/array/reductions.rb

@@ -1,13 +1,16 @@
 class Array
-  # Similar to +reduce+/+inject+, but also returns intermediate values. Has the same interface as +reduce+/+inject+, so an initial value, an oprator or both can be supplied. This method may eventually be moved to the +Enumerable+ module.
+  # Similar to +reduce+/+inject+, but also returns intermediate values. Has the 
+  # same interface as +reduce+/+inject+, so an initial value, an operator or 
+  # both can be supplied. This method may eventually be moved to the 
+  # +Enumerable+ module.
   #
-  #   a = [*1..4]
-  #   a.reductions(:+)
-  #   #=> 10
-  #   a.reductions(50, :+)
-  #   #=> 60
-  #   %w(a b c).reductions { |s1, s2| s1+s2 }
-  #   #=> ["a", "ab", "abc"]
+  # @example Symbol argument
+  #   a = (1..4).to_a
+  #   a.reductions(:+) #=> 10
+  # @example Initial value and symbol argument
+  #   a.reductions(50, :+) #=> 60
+  # @example Block argument
+  #   %w(a b c).reductions { |s1, s2| s1+s2 } #=> ["a", "ab", "abc"]
   def reductions(*args, &block)
     arr = dup
 
@@ -21,9 +24,9 @@ class Array
 
     initial ||= arr.shift
 
-    arr.inject([initial, [initial]]) do |(acc, result), el|
+    arr.inject([initial, [initial]]) { |(acc, result), el|
       val = op ? acc.send(op, el) : yield(acc, el)
       [val, result << val]
-    end.last
+    }.last
   end
 end

data/lib/shenanigans/array/zip_with.rb

@@ -1,21 +1,18 @@
 class Array
-
   # Zip <tt>self</tt> with <tt>other</tt>, combining the elements
   # with the provided block or symbol.
   # The resulting array will be as long as the shorter of
   # the two arrays.
-  #   [1,2,3].zip_with([6,5,4], :+)
-  #   #=> [7, 7, 7]
-  #   %w(a b).zip_with(%w(c d), :+)
-  #   #=> ["ac", "bd"]
-  #
-  # For more complex combinations, a block can be provided:
-  #
-  #   [1,2,3].zip_with([6,5,4]) { |a,b| 3*a+2*b }
+  # @example With a symbol
+  #   [1,2,3].zip_with([6,5,4], :+) #=> [7, 7, 7]
+  #   %w(a b).zip_with(%w(c d), :+) #=> ["ac", "bd"]
+  # @example With a block
+  #   [1,2,3].zip_with([6,5,4]) { |a,b| 3 * a + 2 * b }
   #   #=> [15, 16, 17]
-  def zip_with(other, op=nil)
-    return [] if self.empty? || other.empty?
-    clipped = self[0..other.length-1]
+  def zip_with(other, op = nil)
+    return [] if empty? || other.empty?
+
+    clipped = self[0..other.length - 1]
     zipped = clipped.zip(other)
 
     if op

data/lib/shenanigans/array.rb

@@ -1,3 +1,3 @@
-require_relative 'array/caret'
-require_relative 'array/random_subarray'
-require_relative 'array/zip_with'
+require_relative "array/caret"
+require_relative "array/random_subarray"
+require_relative "array/zip_with"

data/lib/shenanigans/hash/extract.rb

@@ -1,10 +1,11 @@
 class Hash
   # Returns a new hash only with the specified keys (if present).
+  #
+  # @example Key order does not matter
   #   hash = { a: 1, b: 2, c: 3 }
-  #   hash.extract(:b, :a)
-  #   #=> { a: 1, b: 2 }
-  #   hash.extract(:a, :d)
-  #   #=> { a: 1}
+  #   hash.extract(:b, :a) #=> { a: 1, b: 2 }
+  # @example Missing keys are ignored
+  #   hash.extract(:a, :d) #=> { a: 1}
   def extract(*ks)
     existing = keys & ks
     Hash[existing.zip(values_at(*existing))]

data/lib/shenanigans/hash/has_shape_pred.rb

@@ -1,15 +1,14 @@
 class Hash
   # Checks if a hash has a certain structure.
+  #
+  # @example Simple hash
   #     h = { k1: 1, k2: "1" }
-  #     h.has_shape?(k1: Fixnum, k2: String)
-  #     #=> true
-  #     h.has_shape?(k1: Class, k2: String)
-  #     #=> false
-  # It also works with compound data structures.
+  #     h.has_shape?(k1: Integer, k2: String) #=> true
+  #     h.has_shape?(k1: Class, k2: String) #=> false
+  # @example Nested hashes
   #     h = { k1: [], k2: { k3: Struct.new("Foo") } }
   #     shape = { k1: Array, k2: { k3: Module } }
-  #     h.has_shape?(shape)
-  #     #=> true
+  #     h.has_shape?(shape) #=> true
   def has_shape?(shape)
     all? do |k, v|
       Hash === v ? v.has_shape?(shape[k]) : shape[k] === v

data/lib/shenanigans/hash/to_ostruct.rb

@@ -1,8 +1,10 @@
-require 'ostruct'
+require "ostruct"
 
 class Hash
   # Recursively converts a <tt>Hash</tt> and all nested <tt>Hash</tt>es to
   # <tt>OpenStruct</tt>s. Especially useful for parsing YAML.
+  #
+  # @example
   #     yaml=<<EOY
   #     subject: Programming Languages
   #     languages:
@@ -14,14 +16,11 @@ class Hash
   #         creator     : Larry Wall
   #     EOY
   #     struct = YAML.load(yaml).to_ostruct
-  #     struct.subject
-  #     #=> "Programming Languages"
-  #     struct.languages.first
-  #     #=> #<OpenStruct name="Ruby", creator="Matz">
-  #     struct.languages.first.creator
-  #     #=> "Matz"
+  #     struct.subject #=> "Programming Languages"
+  #     struct.languages.first #=> #<OpenStruct name="Ruby", creator="Matz">
+  #     struct.languages.first.creator #=> "Matz"
   def to_ostruct
-    arr = map do |k, v|
+    arr = map { |k, v|
       case v
       when Hash
         [k, v.to_ostruct]
@@ -30,7 +29,7 @@ class Hash
       else
         [k, v]
       end
-    end
+    }
     OpenStruct.new(Hash[arr])
   end
 end

data/lib/shenanigans/hash.rb

@@ -1,3 +1,3 @@
-require_relative 'hash/extract'
-require_relative 'hash/has_shape_pred'
-require_relative 'hash/to_ostruct'
+require_relative "hash/extract"
+require_relative "hash/has_shape_pred"
+require_relative "hash/to_ostruct"

data/lib/shenanigans/integer/divisible_by.rb

@@ -0,0 +1,13 @@
+class Integer
+  # Checks whether the receiver is cleanly divisble by the argument.
+  # @example
+  #     3.divisble_by(0) #=> false
+  #     3.divisble_by(2) #=> false
+  #     9.divisble_bu(3) #=> true
+  def divisible_by(n)
+    return false if n.zero?
+
+    self % n == 0
+  end
+end
+

data/lib/shenanigans/integer/string_length.rb

@@ -0,0 +1,13 @@
+class Integer
+  # Returns the length of the number's string representation.
+  # @example
+  #     0.string_length #=> 1
+  #     123.string_length #=> 3
+  #     -1.string_length #=> 2
+  def string_length
+    return 1 if zero?
+
+    len = Math.log10(abs).floor.next
+    positive? ? len : len.next
+  end
+end

data/lib/shenanigans/integer.rb

@@ -0,0 +1,2 @@
+require_relative "integer/divisible_by"
+require_relative "integer/string_length"

data/lib/shenanigans/kernel/fn.rb

@@ -1,14 +1,15 @@
 module Kernel
   # Composes a list of functions.
   # Functions can be specified as symbols or lambdas.
-  #   ["foo bar", "baz qux"].map &fn(:split, :last)
-  #   #=> ["bar", "qux"]
   #
-  #   (1..3).map &fn(:next, -> x { x * x }, -> x { x.to_f / 2 } )
+  # @example Composing symbols
+  #   ["foo bar", "baz qux"].map(&fn(:split, :last)) #=> ["bar", "qux"]
+  # @example Composing symbplds and lambdas
+  #   (1..3).map(&fn(:next, -> x { x * x }, -> x { x.to_f / 2 } ))
   #   #=> [2.0, 4.5, 8.0]
-  def fn(*funs) #:doc:
-    -> x do
-      funs.inject(x) do |v,f|
+  def fn(*funs)
+    ->(x) do
+      funs.inject(x) do |v, f|
         Proc === f ? f.call(v) : v.send(f)
       end
     end

data/lib/shenanigans/kernel/prompt.rb

@@ -1,5 +1,4 @@
 module Kernel
-
   # Currently only used by <tt>prompt</tt>:
   # <tt>:to_i</tt>, <tt>:to_f</tt>, <tt>:to_r</tt>, <tt>:to_sym</tt>, <tt>:to_c</tt>
   CONVERSIONS = [:to_i, :to_f, :to_r, :to_sym, :to_c]
@@ -7,14 +6,14 @@ module Kernel
   # Displays a prompt and returns chomped input.
   # Modelled after the Python method <tt>raw_input</tt>, but also can
   # be supplied with an optional conversion method.
+  # 
+  # @example A simple prompt
   #   prompt("Prompt> ")
-  #   Prompt> 12
-  #   #=> "12"
-  #
+  #   Prompt> 12 #=> "12"
+  # @example A prompt with conversion
   #   prompt("Prompt> ", :to_f)
-  #   Prompt> 12
-  #   #=> 12.0
-  def prompt(text='', conversion=nil) #:doc:
+  #   Prompt> 12 #=> 12.0
+  def prompt(text = "", conversion = nil)
     print text unless text.empty?
     input = gets.chomp
     CONVERSIONS.include?(conversion) ? input.send(conversion) : input

data/lib/shenanigans/kernel/require_optional.rb

@@ -2,17 +2,17 @@ module Kernel
   # Optionally require a gem. If it is not available, <tt>nil</tt>
   # will be returned. Alternatively, a block can be provided with code
   # to run.
-  #   require 'non_existent'
-  #   #=> nil
   #
-  #   require 'non_existent' do
-  #     puts 'Something went wrong'
-  #   end
-  #   #=> Outputs 'Something went wrong'
-  def require_optional(gem, &block) #:doc:
+  # @example Without a block
+  #   require "non_existent" #=> nil
+  # @example With a custom block
+  #   require "non_existent" do
+  #     puts "Something went wrong"
+  #   end #=> Outputs "Something went wrong"
+  def require_optional(gem, &block)
     require gem
   rescue LoadError
-    block.call if block
+    block&.call
   end
 
   private :require_optional

data/lib/shenanigans/kernel/with.rb

@@ -1,12 +1,13 @@
 module Kernel
   # A Pascal/ActionScript like <tt>with</tt> method. Yields its
   # argument to the provided block and then returns it.
+  #
+  # @example
   #   with([]) do |a|
   #     a << "a"
   #     a << "b"
-  #   end
-  #   #=> ["a", "b"]
-  def with(o, &blk) #:doc:
+  #   end #=> ["a", "b"]
+  def with(o, &blk)
     o.tap(&blk)
   end
 

data/lib/shenanigans/kernel.rb

@@ -1,4 +1,4 @@
-require_relative 'kernel/fn'
-require_relative 'kernel/prompt'
-require_relative 'kernel/with'
-require_relative 'kernel/require_optional'
+require_relative "kernel/fn"
+require_relative "kernel/prompt"
+require_relative "kernel/with"
+require_relative "kernel/require_optional"

data/lib/shenanigans/module/private_accessor.rb

@@ -1,10 +1,10 @@
 class Module
-  # Works like <tt>attr_accessor</tt> but generates private
-  # getter/setter methods for class internal use only. Useful
-  # for enforcing Smalltalk-style internal encapsulation.
+  # Works like <tt>attr_accessor</tt> but generates private getter/setter
+  # methods for class internal use only. Useful for enforcing Smalltalk-style
+  # internal encapsulation.
   #
   # For a more complete implementation of a similar feature see {ivar_encapsulation}[https://github.com/citizen428/ivar_encapsulation].
-  def private_accessor(*names) #:doc:
+  def private_accessor(*names)
     names.each do |name|
       instance_var_name = "@#{name}"
 
@@ -16,8 +16,8 @@ class Module
         instance_variable_set(instance_var_name, value)
       end
 
-      self.send(:private, name)
-      self.send(:private, "#{name}=")
+      send(:private, name)
+      send(:private, "#{name}=")
     end
     nil # like attr_accessor
   end

data/lib/shenanigans/module.rb

@@ -1 +1 @@
-require_relative 'module/private_accessor'
+require_relative "module/private_accessor"

data/lib/shenanigans/object/display.rb

@@ -2,16 +2,17 @@ class Object
   # Outputs the object and also returns it.
   # Will use <tt>puts</tt> if <tt>new_line</tt> is <tt>true</tt> and
   # <tt>print</tt> otherwise.
+  #
+  # @example
   #   "foo".display
-  #   foo
-  #   #=> "foo"
+  #   foo #=> "foo"
   #
   #   "foo".display(false)
   #   foo#=> "foo"
   def display(new_line = true)
     m = new_line ? :puts : :print
-    self.tap { |o| send(m, o) }
+    tap { |o| send(m, o) }
   end
 
-  alias :d :display
+  alias d display
 end

data/lib/shenanigans/object.rb

@@ -1,2 +1 @@
-require_relative 'object/it'
-require_relative 'object/display'
+require_relative "object/display"

data/lib/shenanigans/string/cmpi.rb

@@ -1,8 +1,9 @@
 class String
   # Compares strings ignoring case
-  #   "test".cmpi("tesT")
-  #   #=> true
+  #
+  # @example
+  #   "test".cmpi("tesT") #=> true
   def cmpi(other)
-    self.casecmp(other).zero?
+    casecmp(other).zero?
   end
 end

data/lib/shenanigans/string/in_groups_of.rb

@@ -1,14 +1,12 @@
 class String
   # Returns an array of the string broken down into groups of
   # <tt>size</tt> characters.
-  #   "aabbcc".in_groups_of(2)
-  #   #=> ['aa', 'bb', 'cc']
-  #   "".in_groups_of(2)
-  #   #=> []
-  #   "".in_groups_of(0)
-  #   #=> ArgumentError
+  #   "aabbcc".in_groups_of(2) #=> ['aa', 'bb', 'cc']
+  #   "".in_groups_of(2) #=> []
+  #   "".in_groups_of(0) #=> ArgumentError
   def in_groups_of(size)
     raise ArgumentError, "Size of group must be >= 1" if size < 1
+
     scan(/.{1,#{size}}/)
   end
 end

data/lib/shenanigans/string.rb

@@ -1,2 +1,2 @@
-require_relative 'string/in_groups_of'
-require_relative 'string/cmpi'
+require_relative "string/in_groups_of"
+require_relative "string/cmpi"

data/lib/shenanigans.rb

@@ -1,7 +1,7 @@
-require 'shenanigans/array'
-require 'shenanigans/fixnum'
-require 'shenanigans/hash'
-require 'shenanigans/kernel'
-require 'shenanigans/module'
-require 'shenanigans/object'
-require 'shenanigans/string'
+require "shenanigans/array"
+require "shenanigans/hash"
+require "shenanigans/integer"
+require "shenanigans/kernel"
+require "shenanigans/module"
+require "shenanigans/object"
+require "shenanigans/string"

metadata

@@ -1,57 +1,106 @@
 --- !ruby/object:Gem::Specification
 name: shenanigans
 version: !ruby/object:Gem::Version
-  version: 1.0.13
+  version: 1.0.16
 platform: ruby
 authors:
 - Michael Kohl
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-02-01 00:00:00.000000000 Z
-dependencies: []
+date: 2022-02-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.20
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.20
 description: A collection of extensions for various Ruby core classes.
-email: citizen428@gmail.com
+email: me@citizen428.net
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- Gemfile
 - LICENSE
 - README.rdoc
-- doc/Array.html
-- doc/Fixnum.html
-- doc/Hash.html
-- doc/Kernel.html
-- doc/Module.html
-- doc/Object.html
-- doc/String.html
-- doc/_index.html
-- doc/class_list.html
-- doc/css/common.css
-- doc/css/full_list.css
-- doc/css/style.css
-- doc/file.README.html
-- doc/file_list.html
-- doc/frames.html
-- doc/index.html
-- doc/js/app.js
-- doc/js/full_list.js
-- doc/js/jquery.js
-- doc/method_list.html
-- doc/top-level-namespace.html
 - lib/shenanigans.rb
 - lib/shenanigans/array.rb
 - lib/shenanigans/array/caret.rb
 - lib/shenanigans/array/random_subarray.rb
 - lib/shenanigans/array/reductions.rb
 - lib/shenanigans/array/zip_with.rb
-- lib/shenanigans/fixnum.rb
-- lib/shenanigans/fixnum/string_length.rb
 - lib/shenanigans/hash.rb
 - lib/shenanigans/hash/extract.rb
 - lib/shenanigans/hash/has_shape_pred.rb
 - lib/shenanigans/hash/to_ostruct.rb
+- lib/shenanigans/integer.rb
+- lib/shenanigans/integer/divisible_by.rb
+- lib/shenanigans/integer/string_length.rb
 - lib/shenanigans/kernel.rb
 - lib/shenanigans/kernel/fn.rb
 - lib/shenanigans/kernel/prompt.rb
@@ -61,32 +110,14 @@ files:
 - lib/shenanigans/module/private_accessor.rb
 - lib/shenanigans/object.rb
 - lib/shenanigans/object/display.rb
-- lib/shenanigans/object/it.rb
 - lib/shenanigans/string.rb
 - lib/shenanigans/string/cmpi.rb
 - lib/shenanigans/string/in_groups_of.rb
-- test/array/test_caret.rb
-- test/array/test_random_subarray.rb
-- test/array/test_reductions.rb
-- test/array/test_zip_with.rb
-- test/fixnum/test_string_length.rb
-- test/hash/test_extract.rb
-- test/hash/test_has_shape_pred.rb
-- test/hash/test_to_ostruct.rb
-- test/kernel/test_fn.rb
-- test/kernel/test_prompt.rb
-- test/kernel/test_require_optional.rb
-- test/kernel/test_with.rb
-- test/module/test_private_accessor.rb
-- test/object/test_display.rb
-- test/object/test_it.rb
-- test/string/test_cmpi.rb
-- test/string/test_in_groups_of.rb
 homepage: http://rubydoc.info/gems/shenanigans/frames
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -101,9 +132,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.3
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Think Facets, just less useful
 test_files: []

data/Gemfile

@@ -1,8 +0,0 @@
-source 'https://rubygems.org'
-
-gem "rake"
-
-group :developement do
-  gem "minitest", ">= 2.6.0"
-  gem "yard"
-end