codekindly-utils 0.0.5 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6cab33b2f14cfaebc4d49796af47ab994c0a66e5
-  data.tar.gz: c3644a6bc9fdf6f481c0e844f3f79754f4a1ab1c
+  metadata.gz: f325579c294333c23f0f4aa054072e3a9d5b7cac
+  data.tar.gz: 88087f5c9db6f4a3e43f6e1b042c5b1b44e1014d
 SHA512:
-  metadata.gz: 16df12f16904f34b06f9f80d8ac0fc04a8ad2f4311c4314d575bb9cdef3211b932c7a0ec6285ba94286523f8009839129cdf4c96977d1e183e15a860d48db694
-  data.tar.gz: b83d409dd0f6f1ebe75c1a6cd6af383e80a9150adb7d93bb792c55bbdb2a0475eeb8b7b0b3fea3c2bfaf121bddafea1d50a9e286a801a8282f22ca43af6d097b
+  metadata.gz: fad5068a35c9277f4473027d0fac0ce9467632422197b40ff060932509eb572161049f776b2a3fd5f7418365546b45599ca7cb4feb62b74c09c341870c2f462b
+  data.tar.gz: d51b4dd853e25e92896a40539ce19e9914f6a08bc0c522be1a102923e6cc1494002f13abb9503bac095851c012734c6c8881a2f86a6d88cbe36900e4fbc67e1b

data/.gitignore

@@ -1,13 +1,14 @@
-/.bundle/
+.bundle/
 .DS_Store
-/.yardoc
+.rspec_status
+.ruby-version
 /_yardoc/
+/.yardoc
 /coverage/
 /doc/
+/Gemfile.lock
+/gemfiles/*.lock
 /pkg/
 /spec/reports/
 /tmp/
 /vendor/ruby
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,3 +1,2 @@
---format documentation
 --color
 --require spec_helper

data/.rubocop.yml

@@ -0,0 +1,4 @@
+AllCops:
+  Exclude:
+    - 'gemfiles/**/*'
+    - 'vendor/**/*'

data/Appraisals

@@ -0,0 +1,18 @@
+#!/usr/local/env ruby
+# frozen_string_literal: true
+
+appraise 'activerecord-4-2' do
+  gem 'activerecord', '~> 4.2.10'
+end
+
+appraise 'activerecord-5-0' do
+  gem 'activerecord', '~> 5.0.7'
+end
+
+appraise 'activerecord-5-1' do
+  gem 'activerecord', '~> 5.1.6'
+end
+
+appraise 'activerecord-5-2' do
+  gem 'activerecord', '~> 5.2.0'
+end

data/CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to CodeKindly::Utils
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/jlw/codekindly-utils.
+
+## Setup
+
+`bundle install --path vendor`
+
+## Run tests
+
+To run tests against all supported Ruby versions and all supported major dependency versions:
+
+```Shell
+./all_rubies appraisal-install
+./all_rubies appraisal-spec
+```
+
+## Submitting changes
+
+1. Fork the repository
+2. Make your code changes
+3. Add complete test scenarios for your changes
+4. Ensure your code follows the Ruby Style Guide: `bundle exec rubocop`
+5. Submit a pull request on GitHub
+
+## Publishing
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+To release a new version of the gem to RubyGems.org:
+
+```Shell
+bundle exec rake install
+gem push vendor/ruby/2.5.0/cache/codekindly-utils-x.y.z.gem
+```

data/Gemfile

@@ -1,6 +1,8 @@
-source "https://rubygems.org"
+# frozen_string_literal: true
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in codekindly-utils.gemspec
 gemspec

data/README.md

@@ -22,33 +22,15 @@ Or install it yourself as:
 
     $ gem install codekindly-utils
 
-## Publishing
-
-```Shell
-be rake install
-gem push vendor/ruby/2.2.0/cache/codekindly-utils-0.0.x.gem
-```
-
 ## Usage
 
 I occasionally use these utilities in the main logic of an app, but usually
 use them as conveniences in various rake tasks that are automated or part of my
 general workflow.
 
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run
-`rake spec` 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).
-
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/jlw/codekindly-utils.
+Bug reports and pull requests are welcome, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 

data/Rakefile

@@ -1,6 +1,8 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/all_rubies

@@ -0,0 +1,62 @@
+#!/bin/bash
+
+versions=('2.2.10' '2.3.7' '2.4.4' '2.5.1')
+
+switcher=`which rbenv`
+if [[ $switcher = *[!\ ]* ]]; then
+  verb="local"
+else
+  switcher=`which rvm`
+  if [[ $switcher = *[!\ ]* ]]; then
+    verb="use"
+  else
+    echo "Please install rbenv or rvm"
+    exit 1
+  fi
+fi
+
+case "$1" in
+  appraisal-install)
+    for version in ${versions[@]}
+    do
+      echo "Appraisal install for Ruby $version"
+      eval "$switcher $verb $version"
+      bundle exec appraisal install
+    done
+    ;;
+
+  appraisal-spec)
+    for version in ${versions[@]}
+    do
+      echo "Run appraisal specs with Ruby $version"
+      eval "$switcher $verb $version"
+      bundle exec appraisal rspec
+    done
+    ;;
+
+  bundle)
+    for version in ${versions[@]}
+    do
+      echo "Bundle for Ruby $version"
+      eval "$switcher $verb $version"
+      gem list --local bundler | grep bundler || gem install --no-ri --no-rdoc bundler
+      bundle install --path vendor
+      bundle update
+    done
+    ;;
+
+  spec)
+    for version in ${versions[@]}
+    do
+      echo "Run specs with Ruby $version"
+      eval "$switcher $verb $version"
+      bundle exec rspec spec
+    done
+    ;;
+
+  *)
+    echo $"Usage: $0 {bundle|spec|appraisal-install|appraisal-spec}"
+    exit 1
+esac
+
+exit 0

data/bin/console

@@ -1,7 +1,8 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require "bundler/setup"
-require "codekindly-utils"
+require 'bundler/setup'
+require 'codekindly-utils'
 
 # 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.
@@ -10,5 +11,5 @@ require "codekindly-utils"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/codekindly-utils.gemspec

@@ -1,29 +1,38 @@
+# frozen_string_literal: true
 
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "code_kindly/utils/version"
+require 'code_kindly/utils/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "codekindly-utils"
+  spec.name          = 'codekindly-utils'
   spec.version       = CodeKindly::Utils::VERSION
-  spec.authors       = ["Jeremy Weathers"]
-  spec.email         = ["jeremy@codekindly.com"]
+  spec.authors       = ['Jeremy Weathers']
+  spec.email         = ['jeremy@codekindly.com']
 
-  spec.summary       = %q{These are small utilities that I like to have around in my projects.}
-  spec.description   = %q{There is nothing terribly unique or interesting here and there are almost certainly better ways to do things than this. These are little snippets I've found useful in the past and continue to use through inertia.}
-  spec.homepage      = "https://github.com/jlw/codekindly-utils"
-  spec.license       = "MIT"
+  spec.summary       = 'These are small utilities that I like to have around in my projects.'
+  spec.description   = "There is nothing terribly unique or interesting here and there are almost certainly better ways to do things than this. These are little snippets I've found useful in the past and continue to use through inertia."
+  spec.homepage      = 'https://github.com/jlw/codekindly-utils'
+  spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.required_ruby_version = ">= 2.2"
+  spec.required_ruby_version = '>= 2.2'
 
-  spec.add_development_dependency "bundler", "~> 1.16"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_dependency 'highline'
+  spec.add_dependency 'map'
+
+  spec.add_development_dependency 'activerecord'
+  spec.add_development_dependency 'appraisal'
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'sqlite3'
 end

data/gemfiles/activerecord_4_2.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activerecord", "~> 4.2.10"
+
+gemspec path: "../"

data/gemfiles/activerecord_5_0.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activerecord", "~> 5.0.7"
+
+gemspec path: "../"

data/gemfiles/activerecord_5_1.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activerecord", "~> 5.1.6"
+
+gemspec path: "../"

data/gemfiles/activerecord_5_2.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "activerecord", "~> 5.2.0"
+
+gemspec path: "../"

data/lib/code_kindly/utils.rb

@@ -1,11 +1,20 @@
-require_relative "utils/version"
+# frozen_string_literal: true
 
-require_relative "utils/boolean"
-require_relative "utils/dir"
-require_relative "utils/file"
-require_relative "utils/o_s"
-require_relative "utils/rake_task"
-require_relative "utils/shell"
+require_relative 'utils/version'
 
-require_relative "utils/active_record"
-require_relative "utils/s_q_l"
+require_relative 'utils/deprecation'
+
+require_relative 'utils/boolean'
+require_relative 'utils/presence'
+
+require_relative 'utils/command'
+require_relative 'utils/dir'
+require_relative 'utils/file'
+require_relative 'utils/os'
+require_relative 'utils/rake_task'
+require_relative 'utils/shell'
+
+if Kernel.const_defined? :ActiveRecord
+  require_relative 'utils/active_record'
+  require_relative 'utils/sql'
+end

data/lib/code_kindly/utils/active_record.rb

@@ -1,73 +1,96 @@
+# frozen_string_literal: true
+
+require 'active_record'
+
 module CodeKindly
   module Utils
     class ActiveRecord
+      include Deprecation
+
+      Rails = Kernel.const_defined?(:Rails) ? ::Rails : nil
+
       class << self
         def active_record_classes_by_connection
-          @active_record_classes_by_connection ||= begin
-            sets = {}.with_indifferent_access
-            find_active_record_classes.each do |klass|
-              config_name = configurations.keys.select { |k| configurations[k]["database"] == klass.connection.current_database }.first
-              config_name ||= ::Rails.env
-              sets[config_name] ||= []
-              sets[config_name] << klass
-            end
-            sets
-          end
+          deprecate :active_record_classes_by_connection,
+                    :classes_by_connection,
+                    :'0.1.0'
+          classes_by_connection
         end
 
-        def clear_scope (scope)
-          if 0 == scope.count
-            puts "Nothing to clear"
-          else
-            puts "Clearing #{scope.count} #{scope.name} records"
-            scope.delete_all
-          end
+        def classes_by_connection
+          @classes_by_connection ||= find_classes_by_connection
         end
 
-        def configurations
-          return unless active_record_available?
-          @configurations ||= YAML.load_file(::Rails.root.join(*%w[config database.yml]))
+        def clear_scope(scope)
+          if scope.count.zero?
+            puts 'Nothing to clear'
+            return
+          end
+          puts "Clearing #{scope.count} #{scope.name} records"
+          scope.delete_all
         end
 
         def config(name = nil)
-          return unless active_record_available?
-          name ||= ::Rails.env
-          configurations[name]
+          configs[name || default_name]
         end
 
-        def default_connection_class (connection = nil)
-          return unless active_record_available?
-          connection ||= ::Rails.env
-          @default_connection_class ||= {}.with_indifferent_access
-          @default_connection_class[connection] ||= active_record_classes_by_connection.fetch(connection, []).first
-          @default_connection_class[connection] ||= active_record_classes_by_connection.fetch(active_record_classes_by_connection.keys).first
+        def configs
+          @configs ||= ::ActiveRecord::Base.configurations
         end
 
-      private
+        def configurations
+          deprecate :configurations, :configs, :'0.1.0'
+          configs
+        end
 
-        def active_record_available?
-          begin
-            ::ActiveRecord
-            true
-          rescue NameError
-            raise NotImplementedError, "ActiveRecord is not loaded."
-            false
+        def default_connection_class(connection = nil)
+          connection ||= default_name
+          @default_connection_class ||= {}.with_indifferent_access
+          @default_connection_class[connection] ||= begin
+            it = classes_by_connection.fetch(connection, []).first
+            key = classes_by_connection.keys.first
+            it ||= classes_by_connection.fetch(key).first
+            it
           end
         end
 
-        def application_active_record_class? (klass)
+        private
+
+        def application_active_record_class?(klass)
           return false unless klass < ::ActiveRecord::Base
           return false     if klass.abstract_class
           return false     if klass.name =~ /ActiveRecord::/
           true
         end
 
-        def find_active_record_classes
-          if ::Rails.env.development?
-            ::Dir.glob(::Rails.root.join("app", "models").to_s + "/**/*.rb") { |f| require f }
+        def default_name
+          @default_name ||= Rails.try(:env) || configs.keys.first || 'default'
+        end
+
+        def find_classes
+          if Rails.try(:env).try(:development?)
+            model_files = Rails.root.join('app', 'models').to_s + '/**/*.rb'
+            ::Dir.glob(model_files) { |f| require f }
+          end
+          ObjectSpace.each_object(Class).select do |klass|
+            application_active_record_class?(klass)
+          end.sort_by(&:name)
+        end
+
+        # rubocop:disable Metrics/AbcSize
+        def find_classes_by_connection
+          sets = {}.with_indifferent_access
+          find_classes.each do |klass|
+            config_name = configs.keys.select do |k|
+              configs[k]['database'] == klass.connection.current_database
+            end.first
+            config_name ||= default_name
+            sets[config_name] ||= []
+            sets[config_name] << klass
           end
-          ObjectSpace.each_object(Class).select { |klass| application_active_record_class?(klass) }.sort_by(&:name)
+          sets
         end
+        # rubocop:enable Metrics/AbcSize
       end
     end
   end

data/lib/code_kindly/utils/boolean.rb

@@ -1,32 +1,48 @@
+# frozen_string_literal: true
+
 module CodeKindly
   module Utils
     class Boolean
+      include Deprecation
+
       # modified from ActiveRecord::ConnectionAdapters::Column (4.2.9)
-      TRUE_VALUES  = [true, 1, "1", "t", "T", "true", "TRUE", "on", "ON", "y", "yes"]
-      FALSE_VALUES = [false, 0, "0", "f", "F", "false", "FALSE", "off", "OFF", "n", "no"]
+      TRUES  = [true, 1, '1', 't', 'true', 'on', 'y', 'yes']
+               .map(&:freeze).freeze
+      FALSES = [false, 0, '0', 'f', 'false', 'off', 'n', 'no']
+               .map(&:freeze).freeze
 
       class << self
-        def from (value)
-          return true  if is_true?(value)
-          return false if is_false?(value)
+        def from(value)
+          return true  if true?(value)
+          return false if false?(value)
           nil
         end
 
-        def is_false? (value)
-          return true if FALSE_VALUES.include?(value)
+        def false?(value)
+          return true if FALSES.include?(value)
           if value.respond_to?(:downcase)
-            return true if FALSE_VALUES.include?(value.downcase)
+            return true if FALSES.include?(value.downcase)
           end
           false
         end
 
-        def is_true? (value)
-          return true if TRUE_VALUES.include?(value)
+        def true?(value)
+          return true if TRUES.include?(value)
           if value.respond_to?(:downcase)
-            return true if TRUE_VALUES.include?(value.downcase)
+            return true if TRUES.include?(value.downcase)
           end
           false
         end
+
+        def is_false?(value)
+          deprecate :is_false?, :false?, :'0.1.0'
+          false?(value)
+        end
+
+        def is_true?(value)
+          deprecate :is_true?, :true?, :'0.1.0'
+          true?(value)
+        end
       end
     end
   end

data/lib/code_kindly/utils/command.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module CodeKindly
+  module Utils
+    class Command
+      include Presence
+
+      class << self
+        def run(command)
+          new(command).run
+        end
+      end
+
+      attr_reader :command
+
+      def initialize(command)
+        @command = command
+      end
+
+      def run
+        require 'open3'
+        command = @command
+        command.join(' ') if command.is_a?(Array)
+        @std_in, @std_out, @std_err = Open3.capture3(command)
+        self
+      end
+
+      def result
+        return nil if blank? @std_out
+        @std_out.chomp!
+        blank? @std_out ? nil : @std_out
+      end
+    end
+  end
+end

data/lib/code_kindly/utils/deprecation.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CodeKindly
+  module Utils
+    module Deprecation
+      class << self
+        private
+
+        def deprecate(old_m, new_m = nil, version = nil)
+          msg = "[DEPRECATION] `#{old_m}` is deprecated"
+          version ? " and will be removed in version #{version}." : '.'
+          msg += " Please use `#{new_m}` instead." if new_m
+          warn msg
+        end
+      end
+
+      private
+
+      def deprecate(old_m, new_m = nil, version = nil)
+        self.class.deprecate(old_m, new_m, version)
+      end
+    end
+  end
+end

data/lib/code_kindly/utils/dir.rb

@@ -1,17 +1,21 @@
+# frozen_string_literal: true
+
 module CodeKindly
   module Utils
     class Dir
+      SKIP_DIRS = ['.', '..', '.DS_Store', '.keep'].map(&:freeze).freeze
+
       class << self
-        def all (path)
-          require "fileutils"
+        def all(path)
+          require 'fileutils'
           return [] unless ::Dir.exist?(path)
           files = ::Dir.entries(path)
-          files.reject!{ |f| "." == f || ".." == f || ".DS_Store" == f || ".keep" == f }
+          files.reject! { |f| SKIP_DIRS.include? f }
           files.sort
         end
 
-        def find (path)
-          require "fileutils"
+        def find(path)
+          require 'fileutils'
           all(path).select { |entry| ::File.directory?("#{path}/#{entry}") }
         end
       end

data/lib/code_kindly/utils/file.rb

@@ -1,58 +1,56 @@
+# frozen_string_literal: true
+
 module CodeKindly
   module Utils
     class File
+      include Presence
+
       class << self
-        def all (path)
+        def all(path)
           CodeKindly::Utils::Dir.all path
         end
 
-        def choose_from_options (directory_path, h = nil)
-          require "highline"
-          h ||= HighLine.new
-          file_opts = file_options(directory_path)
-          return nil if file_opts.blank?
-          msg = "Select an existing file:"
-          file_opts.each do |k,v|
-            msg += "\n  #{k}: #{v}"
-          end
-          msg += "\n  0: None of the above"
-          option = h.ask(msg, Integer)
+        def choose_from_options(dir_path, h_l = nil)
+          require 'highline'
+          h_l ||= HighLine.new
+          file_opts = file_options(dir_path)
+          return nil if blank? file_opts
+          msg = file_opts.inject('') { |(k, v), m| m + "\n  #{k}: #{v}" }
+          option = h_l.ask("Select a file:#{msg}\n  0: None", Integer)
           file_path = file_opts.fetch(option, nil)
-          if file_path.present?
-            file_path = ::File.join(directory_path, file_path)
-          end
-          file_path
+          return if file_path.nil?
+          ::File.join(dir_path, file_path)
         end
 
-        def file_options (path)
-          require "map"
+        def file_options(path)
+          require 'map'
           options = Map.new
           key = 0
           find(path).each do |file|
-            options[key+=1] = file
+            options[key += 1] = file
           end
           options
         end
 
-        def find (path)
-          require "fileutils"
+        def find(path)
+          require 'fileutils'
           all(path).select { |entry| ::File.file?("#{path}/#{entry}") }
         end
 
-        def trash! (file_string)
-          require "open3"
-          stdin, stdout, stderr = Open3.popen3("ls #{file_string}")
-          if stdout.gets
-            # move to trash (or delete) existing downloaded files
-            # sudo gem install osx-trash (http://www.dribin.org/dave/blog/archives/2008/05/24/osx_trash/)
-            stdin, stdout, stderr = Open3.popen3("which trash")
-            trash = stdout.gets
-            command = case
-              when trash then "#{trash.strip} #{file_string}" # output of `which` has ending \n
-              when ::File.directory?("~/.Trash") then "mv #{file_string} ~/.Trash"
-              else "rm #{file_string}"
-            end
-            Kernel.system(command)
+        # move to trash (or delete) existing downloaded files
+        # sudo gem install osx-trash (http://www.dribin.org/dave/blog/archives/2008/05/24/osx_trash/)
+        def trash!(file_string)
+          Kernel.system(command_to_trash_files(file_string))
+        end
+
+        private
+
+        def command_to_trash_files(file_string)
+          return if Command.run("ls #{file_string}").result.nil?
+          trash = OS.which('trash')
+          if trash then "#{trash.chomp} #{file_string}"
+          elsif ::File.directory?('~/.Trash') then "mv #{file_string} ~/.Trash"
+          else "rm #{file_string}"
           end
         end
       end

data/lib/code_kindly/utils/os.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module CodeKindly
+  module Utils
+    class OS
+      class << self
+        def notify(message)
+          return if terminal_notifier.nil?
+          Command.run [
+            terminal_notifier,
+            "-message \"#{message}\"",
+            '-sound Submarine'
+          ].join(' ')
+        end
+
+        def which(program)
+          Command.run("which #{program}").result
+        end
+
+        private
+
+        def terminal_notifier
+          unless instance_variable_defined? :@terminal_notifier
+            @terminal_notifer = which('terminal-notifier')
+          end
+          @terminal_notifier
+        end
+      end
+    end
+  end
+end

data/lib/code_kindly/utils/presence.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CodeKindly
+  module Utils
+    module Presence
+      def self.blank?(value)
+        # http://apidock.com/rails/Object/blank%3F
+        value.respond_to?(:empty?) ? !!value.empty? : !value
+      end
+
+      def blank?(value)
+        self.class.blank?(value)
+      end
+
+      def self.present?(value)
+        !blank?(value)
+      end
+
+      def present?(value)
+        self.class.present?(value)
+      end
+    end
+  end
+end

data/lib/code_kindly/utils/rake_task.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 module CodeKindly
   module Utils
     class RakeTask
-      def self.run (task)
+      def self.run(task)
         Rake::Task[task].reenable
         Rake::Task[task].invoke
       end

data/lib/code_kindly/utils/shell.rb

@@ -1,11 +1,16 @@
+# frozen_string_literal: true
+
 module CodeKindly
   module Utils
     class Shell
+      include Deprecation
+
       class << self
-        def run (command)
-          require "open3"
-          command = command.join(" ") if command.is_a?(Array)
-          stdout_str, stderr_str, status = Open3.capture3(command)
+        def run(command)
+          deprecate :'Shell.run', :'Command.run', :'0.1.0'
+          require 'open3'
+          command = command.join(' ') if command.is_a?(Array)
+          Open3.capture3 command
         end
       end
     end

data/lib/code_kindly/utils/sql.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'active_record'
+
+module CodeKindly
+  module Utils
+    class SQL
+      class << self
+        def method_missing(method, *args)
+          m_name = method.to_s
+          return process(m_name, *args) if respond_to_missing?(m_name)
+          select_mn = 'select_' + m_name
+          return process(select_mn, *args) if respond_to_missing?(select_mn)
+          super
+        end
+
+        def respond_to_missing?(method, _include_all = false)
+          return false unless default_connection_class
+          default_connection_class.connection.respond_to?(method)
+        end
+
+        protected
+
+        def default_connection_class
+          @default_connection_class ||= begin
+            CodeKindly::Utils::ActiveRecord.default_connection_class
+          end
+        end
+
+        def process(method_name, query, connection_class = NilClass)
+          connection_class = find_connection_class(query, connection_class)
+          query = query.to_sql if query.is_a?(::ActiveRecord::Relation)
+          connection_class.connection.send(method_name, query)
+        end
+
+        private
+
+        def find_connection_class(query, klass)
+          return query.klass if query.is_a?(::ActiveRecord::Relation)
+          if klass.respond_to? :to_sym
+            klass = CodeKindly::Utils::ActiveRecord.default_connection_class(klass)
+          else
+            klass = klass.class unless klass.is_a?(Class)
+            klass = NilClass if klass < ::ActiveRecord::Base
+          end
+          klass = default_connection_class if klass == NilClass
+          klass
+        end
+      end
+    end
+  end
+end

data/lib/code_kindly/utils/version.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 module CodeKindly
   module Utils
-    VERSION = "0.0.5"
+    VERSION = '0.0.6'.freeze
   end
 end

data/lib/codekindly-utils.rb

@@ -1,7 +1,10 @@
-require_relative "code_kindly/utils"
+# frozen_string_literal: true
+
+require_relative 'code_kindly/utils'
 
 if Kernel.const_defined? :CK
-  warn "`CK` is already defined as a constant, so you will need to use the full `CodeKindly::Utils` module name in this project."
+  warn '`CK` is already defined as a constant, so you will need to use' \
+       ' the full `CodeKindly::Utils` module name in this project.'
 else
   CK = CodeKindly::Utils
 end

metadata

@@ -1,15 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: codekindly-utils
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors:
 - Jeremy Weathers
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-04-16 00:00:00.000000000 Z
+date: 2018-10-01 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: map
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -24,20 +80,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +122,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: There is nothing terribly unique or interesting here and there are almost
   certainly better ways to do things than this. These are little snippets I've found
   useful in the past and continue to use through inertia.
@@ -63,22 +161,33 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
+- Appraisals
+- CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- all_rubies
 - bin/console
 - bin/setup
 - codekindly-utils.gemspec
+- gemfiles/activerecord_4_2.gemfile
+- gemfiles/activerecord_5_0.gemfile
+- gemfiles/activerecord_5_1.gemfile
+- gemfiles/activerecord_5_2.gemfile
 - lib/code_kindly/utils.rb
 - lib/code_kindly/utils/active_record.rb
 - lib/code_kindly/utils/boolean.rb
+- lib/code_kindly/utils/command.rb
+- lib/code_kindly/utils/deprecation.rb
 - lib/code_kindly/utils/dir.rb
 - lib/code_kindly/utils/file.rb
-- lib/code_kindly/utils/o_s.rb
+- lib/code_kindly/utils/os.rb
+- lib/code_kindly/utils/presence.rb
 - lib/code_kindly/utils/rake_task.rb
-- lib/code_kindly/utils/s_q_l.rb
 - lib/code_kindly/utils/shell.rb
+- lib/code_kindly/utils/sql.rb
 - lib/code_kindly/utils/version.rb
 - lib/codekindly-utils.rb
 homepage: https://github.com/jlw/codekindly-utils

data/lib/code_kindly/utils/o_s.rb

@@ -1,16 +0,0 @@
-module CodeKindly
-  module Utils
-    class OS
-      class << self
-        def notify (message)
-          require "open3"
-          stdin, stdout, stderr = Open3.popen3("which terminal-notifier")
-          tn_path = stdout.gets
-          if tn_path.present?
-            Kernel.system("#{tn_path.chomp} -message \"#{message}\" -sound Submarine")
-          end
-        end
-      end
-    end
-  end
-end

data/lib/code_kindly/utils/s_q_l.rb

@@ -1,41 +0,0 @@
-module CodeKindly
-  module Utils
-    class SQL
-      class << self
-        def method_missing (method, *args)
-          method_name = method.to_s
-          return process(method_name, *args) if respond_to_missing?(method_name)
-          select_method_name = "select_" + method_name
-          return process(select_method_name, *args) if respond_to_missing?(select_method_name)
-          super
-        end
-
-        def respond_to_missing? (method, _include_all = false)
-          default_connection_class && default_connection_class.connection.respond_to?(method)
-        end
-
-      protected
-
-        def default_connection_class
-          @default_connection_class ||= CodeKindly::Utils::ActiveRecord.default_connection_class
-        end
-
-        def process (method_name, query, connection_class = NilClass)
-          if query.is_a?(::ActiveRecord::Relation)
-            connection_class = query.klass
-            query = query.to_sql
-          else
-            if connection_class.respond_to? :to_sym
-              connection_class = CodeKindly::Utils::ActiveRecord.default_connection_class(connection_class)
-            else
-              connection_class = connection_class.class unless connection_class.is_a?(Class)
-              connection_class = NilClass if connection_class < ::ActiveRecord::Base
-            end
-          end
-          connection_class = default_connection_class if connection_class == NilClass
-          connection_class.connection.send(method_name, query)
-        end
-      end
-    end
-  end
-end