casual_support 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8914e689b15b07fbb5628b8745f9b1de4b5d65f3
+  data.tar.gz: 105d5b5411cb70b844f5ceb3c7ea17bd652e2d3f
+SHA512:
+  metadata.gz: 78de00d5d5e5d3c970f3747ec4131aa1fbd83ae361825d46f558e39198fd16fa72402d626a4d48da9c744baf578d1c0ff422403a5682ecfbaf0fde9ead0d5807
+  data.tar.gz: 1503f2ba9311fc72509d78f09bf91ae6a12b533465a135f6ef457160e21a97ead6e1f23ce72659b8bebb579e6e071228a6316947307f980ced38b94c7abed360

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.4
+before_install: gem install bundler -v 1.12.3

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in casual_support.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 TODO: Write your name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,32 @@
+# casual_support
+
+Utility methods as extensions to Ruby core objects.  Stuff I want in Active Support.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'casual_support'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install casual_support
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "casual_support"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/casual_support.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'casual_support/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "casual_support"
+  spec.version       = CasualSupport::VERSION
+  spec.authors       = ["Jonathan Hefner"]
+  spec.email         = ["jonathan.hefner@gmail.com"]
+
+  spec.summary       = %q{Utility methods as core extensions.}
+  spec.description   = %q{Utility methods as extensions to Ruby core objects.  Stuff I want in Active Support.}
+  spec.homepage      = "https://github.com/jonathanhefner/casual_support"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'activesupport', '>= 3.1', '< 5.1'
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

data/lib/casual_support.rb

@@ -0,0 +1,8 @@
+require 'casual_support/version'
+require 'casual_support/date'
+require 'casual_support/enumerable'
+require 'casual_support/hash'
+require 'casual_support/integer'
+require 'casual_support/numeric'
+require 'casual_support/string'
+require 'casual_support/time'

data/lib/casual_support/date.rb

@@ -0,0 +1 @@
+require 'casual_support/date/to_ymd'

data/lib/casual_support/date/to_ymd.rb

@@ -0,0 +1,16 @@
+require 'date'
+
+class Date
+
+  # Formats date as "YYYY-MM-DD" (e.g. "1999-12-31").  Shortcut for
+  # +strftime("%Y-%m-%d")+.
+  #
+  # @return [String] the date formatted as "YYYY-MM-DD"
+  def to_ymd
+    # Date#strftime appears to be **much** faster than Time#strftime
+    # (nearly 3x faster!).  Thus it used here, unlike Time#to_ymd which
+    # uses sprintf.
+    self.strftime('%Y-%m-%d'.freeze)
+  end
+
+end

data/lib/casual_support/enumerable.rb

@@ -0,0 +1,2 @@
+require 'casual_support/enumerable/duplicates'
+require 'casual_support/enumerable/index_to'

data/lib/casual_support/enumerable/duplicates.rb

@@ -0,0 +1,24 @@
+module Enumerable
+
+  # Returns the first duplicate of each element, preserving order of
+  # appearance.  If a block is given, it will use the return
+  # value of the block for element comparison.
+  #
+  # Examples:
+  #   %w[a a b c d c b a].duplicates == %w[a c b]
+  #   %w[A a B b].duplicates(&:upcase) == %w[a b]
+  #
+  # @yield [elem] computes an indentifying value
+  # @yieldparam elem element from the +Enumerable+
+  # @yieldreturn value used for duplicate comparison
+  # @return [Enumerable] duplicate elements of the +Enumerable+
+  def duplicates
+    seen = Hash.new(0)
+    if block_given?
+      self.select{|elem| (seen[yield(elem)] += 1) == 2 }
+    else
+      self.select{|elem| (seen[elem] += 1) == 2 }
+    end
+  end
+
+end

data/lib/casual_support/enumerable/index_to.rb

@@ -0,0 +1,16 @@
+require 'casual_support/hash/setbang'
+
+module Enumerable
+
+  # Converts an +Enumerable+ into a +Hash+ by using its elements as keys
+  # and extracting values from each.
+  #
+  # @yield [elem] extracts a value
+  # @yieldparam elem element from the +Enumerable+
+  # @yieldreturn value to associate with the +elem+ key
+  # @return [Hash] hash with the +Enumerable+'s elements as keys
+  def index_to()
+    self.reduce({}){|h, k| h.set!(k, (yield k)) }
+  end
+
+end

data/lib/casual_support/hash.rb

@@ -0,0 +1 @@
+require 'casual_support/hash/setbang'

data/lib/casual_support/hash/setbang.rb

@@ -0,0 +1,16 @@
+class Hash
+
+  # Sets a value like +Hash#[]=+, but returns the modified Hash instead
+  # of the value.  Useful with +#reduce+, and 2x faster than using
+  # an equivalent +Hash#merge!+ (see
+  # benchmark[https://github.com/JuanitoFatas/fast-ruby#hashmerge-vs-hash-code]).
+  #
+  # @param key
+  # @param value
+  # @return [Hash] the modified hash
+  def set!(key, value)
+    self[key] = value
+    self
+  end
+
+end

data/lib/casual_support/integer.rb

@@ -0,0 +1 @@
+require 'casual_support/integer/to_hex'

data/lib/casual_support/integer/to_hex.rb

@@ -0,0 +1,20 @@
+class Integer
+
+  # Converts integer to a zero-padded lower-case hexadecimal string.
+  # If the length of the raw hexadecimal string exceeds the desired
+  # width, the string will be returned unaltered (without padding or
+  # truncation).
+  #
+  # Without the need for zero-padding, this method is ~7% slower than
+  # just +to_s(16)+.  However, when zero-padding is required, it is
+  # ~230% faster than +sprintf("%0#{width}x", self)+, and ~30% faster
+  # than +sprintf(FIXED_FORMAT_STRING, self)+.
+  #
+  # @param [Integer] width desired width of the zero-padded string
+  # @return [String] hexadecimal string
+  def to_hex(width = nil)
+    h = self.to_s(16)
+    width ? h.rjust(width, '0'.freeze) : h
+  end
+
+end

data/lib/casual_support/numeric.rb

@@ -0,0 +1,2 @@
+require 'casual_support/numeric/at_least_most'
+require 'casual_support/numeric/constrain'

data/lib/casual_support/numeric/at_least_most.rb

@@ -0,0 +1,21 @@
+class Numeric
+
+  # Enforces a lower bound for a number.
+  #
+  # @param [Numeric] limit lower bound
+  # @return [Numeric] the number constrained by the lower bound
+  def at_least(limit)
+    self < limit ? limit : self
+  end
+
+  # Enforces an upper bound for a number.
+  #
+  # @param [Numeric] limit upper bound
+  # @return [Numeric] the number constrained by the upper bound
+  def at_most(limit)
+    self > limit ? limit : self
+  end
+
+  alias_method :cap, :at_most
+
+end

data/lib/casual_support/numeric/constrain.rb

@@ -0,0 +1,16 @@
+class Numeric
+
+  # Constrains a number to a closed interval.
+  #
+  # @param [Numeric] low lower bound
+  # @param [Numeric] high upper bound
+  # @return [Numeric] the number constrained to the bounds
+  def constrain(low, high)
+    return low if self < low
+    return high if self > high
+    self
+  end
+
+  alias_method :clamp, :constrain
+
+end

data/lib/casual_support/string.rb

@@ -0,0 +1,4 @@
+require 'casual_support/string/before_after'
+require 'casual_support/string/drop'
+require 'casual_support/string/first_last'
+require 'casual_support/string/from_to'

data/lib/casual_support/string/before_after.rb

@@ -0,0 +1,59 @@
+class String
+
+  # Searches for the first occurrence of a delimiter, and returns the
+  # portion of the string before that.  If the delimiter is not found,
+  # returns the original string.
+  #
+  # Semantically equivalent to:
+  #   split(delim).first
+  #
+  # @param [String] delim delimiter to search for
+  # @return [String] portion of the string before the first +delim+
+  def before(delim)
+    i = self.index(delim)
+    i ? self.first(i) : self
+  end
+
+  # Searches for the last occurrence of a delimiter, and returns the
+  # portion of the string before that.  If the delimiter is not found,
+  # returns the original string.
+  #
+  # Semantically equivalent to:
+  #   split(delim)[0..-2].join(delim)
+  #
+  # @param [String] delim delimiter to search for
+  # @return [String] portion of the string before the last +delim+
+  def before_last(delim)
+    i = self.rindex(delim)
+    i ? self.first(i) : self
+  end
+
+  # Searches for the first occurrence of a delimiter, and returns the
+  # portion of the string after that.  If the delimiter is not found,
+  # returns the original string.
+  #
+  # Semantically equivalent to:
+  #   split(delim, 2).last
+  #
+  # @param [String] delim delimiter to search for
+  # @return [String] portion of the string after the first +delim+
+  def after(delim)
+    i = self.index(delim)
+    i ? self.drop(i + delim.length) : self
+  end
+
+  # Searches for the last occurrence of a delimiter, and returns the
+  # portion of the string after that.  If the delimiter is not found,
+  # returns the original string.
+  #
+  # Semantically equivalent to:
+  #   split(delim).last
+  #
+  # @param [String] delim delimiter to search for
+  # @return [String] portion of the string after the last +delim+
+  def after_last(delim)
+    i = self.rindex(delim)
+    i ? self.drop(i + delim.length) : self
+  end
+
+end

data/lib/casual_support/string/drop.rb

@@ -0,0 +1,13 @@
+class String
+
+  # Drops characters from the beginning of a string, and returns the
+  # remainder.  If the number of characters to drop is greater than the
+  # length of the string, an empty string is returned.
+  #
+  # @param [Integer] n number of characters to drop
+  # @return [String] string of remaining characters
+  def drop(n)
+    self[n.constrain(0, self.length), self.length]
+  end
+
+end

data/lib/casual_support/string/first_last.rb

@@ -0,0 +1,15 @@
+class String
+
+  # This replaces Active Support's +String#first+, but it returns an
+  # empty string when given a negative argument.  It is ~75% faster.
+  def first(limit = 1)
+    limit <= 0 ? '' : self[0, limit]
+  end
+
+  # This replaces Active Support's +String#last+, but it returns an
+  # empty string when given a negative argument.  It is ~75% faster.
+  def last(limit = 1)
+    limit <= 0 ? '' : self[length - limit, length]
+  end
+
+end

data/lib/casual_support/string/from_to.rb

@@ -0,0 +1,15 @@
+class String
+
+  # This replaces Active Support's +String#from+.  It is ~40% faster.
+  def from(position)
+    position += self.length if position < 0
+    self[position, length]
+  end
+
+  # This replaces Active Support's +String#to+.  It is ~40% faster.
+  def to(position)
+    position += self.length if position < 0
+    self[0, position + 1]
+  end
+
+end

data/lib/casual_support/time.rb

@@ -0,0 +1 @@
+require 'casual_support/time/ymd_hms'

data/lib/casual_support/time/ymd_hms.rb

@@ -0,0 +1,27 @@
+class Time
+
+  # Formats time as "YYYY-MM-DD" (e.g. "1999-12-31").  Equivalent to
+  # +strftime("%Y-%m-%d")+, but ~6% faster (or ~18% if the format
+  # string is an un-frozen literal, due to GC).
+  #
+  # @return [String] the time formatted as "YYYY-MM-DD"
+  def to_ymd
+    # Date#strftime appears to be **much** faster than Time#strftime
+    # (nearly 3x faster!).  If Time#strftime becomes optimized to that
+    # level in the future, it should be used instead of sprintf.
+    sprintf('%04d-%02d-%02d'.freeze, year, month, day)
+  end
+
+  # Formats time as "HH:MM:SS" (e.g. "23:59:59").  Equivalent to
+  # +strftime("%H:%M:%S")+, but ~10% faster (or ~20% if the format
+  # string is an un-frozen literal, due to GC).
+  #
+  # @return [String] the time formatted as "HH:MM:SS"
+  def to_hms
+    # Date#strftime appears to be **much** faster than Time#strftime
+    # (nearly 3x faster!).  If Time#strftime becomes optimized to that
+    # level in the future, it should be used instead of sprintf.
+    sprintf('%02d:%02d:%02d'.freeze, hour, min, sec)
+  end
+
+end

data/lib/casual_support/version.rb

@@ -0,0 +1,3 @@
+module CasualSupport
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: casual_support
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jonathan Hefner
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-05-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !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'
+description: Utility methods as extensions to Ruby core objects.  Stuff I want in
+  Active Support.
+email:
+- jonathan.hefner@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- casual_support.gemspec
+- lib/casual_support.rb
+- lib/casual_support/date.rb
+- lib/casual_support/date/to_ymd.rb
+- lib/casual_support/enumerable.rb
+- lib/casual_support/enumerable/duplicates.rb
+- lib/casual_support/enumerable/index_to.rb
+- lib/casual_support/hash.rb
+- lib/casual_support/hash/setbang.rb
+- lib/casual_support/integer.rb
+- lib/casual_support/integer/to_hex.rb
+- lib/casual_support/numeric.rb
+- lib/casual_support/numeric/at_least_most.rb
+- lib/casual_support/numeric/constrain.rb
+- lib/casual_support/string.rb
+- lib/casual_support/string/before_after.rb
+- lib/casual_support/string/drop.rb
+- lib/casual_support/string/first_last.rb
+- lib/casual_support/string/from_to.rb
+- lib/casual_support/time.rb
+- lib/casual_support/time/ymd_hms.rb
+- lib/casual_support/version.rb
+homepage: https://github.com/jonathanhefner/casual_support
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Utility methods as core extensions.
+test_files: []
+has_rdoc: