vv 0.0.0.alpha.1 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bcfa5a3a0a6024aec90286551d5efebf4f92f2b7d29c81ca84bafaa58b3fa8d
-  data.tar.gz: 82caa47101ece4903671ecae58194688f781dd943d27636ce80df018bea9b634
+  metadata.gz: fe93872b369b2bef0d97aee37de5eb1c695868657bac36a0d092be41796eceaf
+  data.tar.gz: f8fd0ef72c7406cd5c1b2e54bf7ac50d402a1784bea259e4c9dba24190fe7b66
 SHA512:
-  metadata.gz: bb5a73c6de2c899c41bd96c14846e3702f9cc88aa4065c913ef6e39b47446d69a4f0f1b02a82447d27583fa2c42e19f123a3840e5fc9662e906a31596f2c7b13
-  data.tar.gz: 751751b4244d15ea1b606f5dfea02c16d6455de53307874e438702d0d0d7b8b092d57a39196ef47b84265864c06924d8cf9a676c97614311f599b046869dfb74
+  metadata.gz: 5e1b8989145f69d91378dbefa190a2ddb622fbd663c3d224c87f68d7901994a2a340f2ad18d931ab7d89325a9484e3c7d61adc6fc24316885558847700fd4044
+  data.tar.gz: 2f59c921b3cca9a1e8a2920e47fad61585fcf09129aa96ca9bc10685acbbba20614d92b975289b53e5f8a95e27ee4b53045cc3f3e48b83ee58565e0674c51fdc

data/lib/vv/array_methods.rb

@@ -0,0 +1,95 @@
+module VV
+  module ArrayMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    def blank?
+      self.size == 0
+    end
+
+    def empty?
+      self.blank?
+    end
+
+    def gravify
+      self.collect do |elem|
+        "`#{elem}`"
+      end
+    end
+
+    def gravify!
+      self.collect! do |elem|
+        "`#{elem}`"
+      end
+    end
+
+    def stringify_collection grave: false
+      return self.gravify.stringify_collection if grave
+
+      return String.empty_string if self.blank?
+      return self.first          if self.size == 1
+      return self.join " and "   if self.size == 2
+
+      new_collection = self[0..-3]
+      back_fragment  = self[-2..-1].join ", and "
+      new_collection << back_fragment
+      new_collection.join ", "
+    end
+
+    def spaced
+      self.join(" ")
+    end
+
+    def format!(other)
+      self.spaced.format! other
+    end
+
+    def second
+      self[1]
+    end
+
+    def third
+      self[2]
+    end
+
+    def fourth
+      self[3]
+    end
+
+    def fifth
+      self[4]
+    end
+
+    def sixth
+      self[5]
+    end
+
+    def seventh
+      self[6]
+    end
+
+    def eighth
+      self[7]
+    end
+
+    def ninth
+      self[8]
+    end
+
+    def tenth
+      self[9]
+    end
+
+  end
+
+end

data/lib/vv/false_methods.rb

@@ -0,0 +1,22 @@
+module VV
+  module FalseMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    def to_boolean
+      self
+    end
+
+  end
+
+end

data/lib/vv/gem_methods.rb

@@ -0,0 +1,22 @@
+module Gem
+
+  # dirname is almost always __dir__
+  def require_files pattern, dirname: nil
+    dirname ||= \
+    File.dirname caller_locations[0].path
+
+    glob = File.join dirname, pattern
+    Gem.find_files(glob).each do |filepath|
+      start = dirname.size + 1
+      ruby_require_path = filepath[start..-1]
+      if block_given?
+        yield ruby_require_path
+      else
+        require ruby_require_path
+      end
+    end
+
+  end
+  module_function :require_files
+
+end

data/lib/vv/hash_methods.rb

@@ -0,0 +1,42 @@
+module VV
+  module HashMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    def stringify_keys
+      transform_keys{ |key| key.to_s }
+    end
+
+    def stringify_keys!
+      transform_keys!{ |key| key.to_s }
+    end
+
+    def transform_keys
+      return enum_for(:transform_keys) unless block_given?
+      result = self.class.new
+      self.each_key do |key|
+        result[yield(key)] = self[key]
+      end
+      result
+    end
+
+    def transform_keys!
+      return self.enum_for(:transform_keys!) unless block_given?
+      self.keys.each do |key|
+        self[yield(key)] = self.delete(key)
+      end
+      self
+    end
+
+  end
+end

data/lib/vv/nil_methods.rb

@@ -0,0 +1,22 @@
+module VV
+  module NilMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    def to_boolean
+      false
+    end
+
+  end
+
+end

data/lib/vv/readline_methods.rb

@@ -0,0 +1,72 @@
+module Readline
+
+  def vv_enabled?
+    true
+  end
+  module_function :vv_enabled?
+
+  def safe_readline(prompt)
+    stty_save = `stty -g`.chomp
+    begin
+      Readline.readline prompt
+    rescue Interrupt
+      puts
+      system("stty", stty_save)
+      exit
+    end
+  end
+  module_function :safe_readline
+
+  def prompt message, exit_on_exit: true
+    message.concat " "
+
+    input = Readline.safe_readline message
+
+    if input.nil?
+      puts
+      exit
+    end
+
+    input.chomp!
+
+    exit if input == "exit" and exit_on_exit
+
+    input
+  end
+  module_function :prompt
+
+  def prompt_yn(message, default: nil)
+    default = true  if default == "y" or default == "Y"
+    default = false if default == "n" or default == "N"
+
+    option = case default
+             when nil
+               "[y/n]"
+             when false
+               "[y/N]"
+             when true
+               "[Y/n]"
+             end
+
+    option.prepend " "
+    message += option
+
+    answer = nil
+
+    loop do
+      input = prompt(message)
+
+      answer = default if input == ""
+      answer = true  if input == "y" or input == "Y"
+      answer = false if input == "n" or input == "N"
+
+      break unless answer.nil?
+
+      puts "Unrecognized input. Please enter response again."
+    end
+
+    answer
+  end
+  module_function :prompt_yn
+
+end

data/lib/vv/string_methods.rb

@@ -0,0 +1,320 @@
+module VV
+  module StringMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+      base.extend(SharedInstanceAndClassMethods)
+      base.include(SharedInstanceAndClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    module SharedInstanceAndClassMethods
+
+      def empty_string
+        ""
+      end
+
+      def forward_slash
+        "/"
+      end
+
+      def dash
+        "-"
+      end
+
+      def period
+        "."
+      end
+
+      def underscore_character
+        "_"
+      end
+
+      # See: `safe_filename?` and `safe_path?` methods
+      def safe_filename_characters
+        numbers    = '0-9'
+        lowercase  = 'a-z'
+        uppercase  = 'A-Z'
+
+        [ dash,
+          numbers,
+          lowercase,
+          uppercase,
+          underscore_character,
+          period ].join
+      end
+
+    end
+
+    def blank?
+      self == ""
+    end
+
+    def starts_with? *args
+      self.start_with?(*args)
+    end
+
+    def ends_with? *args
+      self.end_with?(*args)
+    end
+
+    def after(string, safe: true)
+      if safe && ! self.starts_with?(string)
+        message = "String does not start with #{string}"
+        raise RuntimeError, message
+      elsif not self.starts_with?(string)
+        return self
+      end
+
+      self[string.size..-1]
+    end
+
+    def with_ending(string)
+      self.chomp(string) + string
+    end
+
+    def squish!
+      self.gsub!(/\A[[:space:]]+/, "")
+      self.gsub!(/[[:space:]]+\z/, "")
+      self.gsub!(/[[:space:]]+/, " ")
+      self
+    end
+
+    def squish
+      self.dup.squish!
+    end
+
+    def format!(other)
+      mappings = {}
+      self.split('#{')[1..-1].map do | token_fragment |
+        format_string = token_fragment.split("}").first
+        token = format_string.squish
+
+        value = other.instance_variable_get(token).to_s
+        wrapped_format_string = '#{' + format_string + "}"
+        mappings[wrapped_format_string] = value
+      end
+
+      response = self.dup
+
+      mappings.each do |key, value|
+        response.gsub! key, value
+      end
+
+      response
+    end
+
+    def matches_glob pattern
+      File.fnmatch(pattern, self)
+    end
+
+    def to_regex
+      Regexp.new self
+    end
+
+    def to_regex_filter
+      regex_string = '[^' + self + ']'
+      regex_string.to_regex
+    end
+
+    def to_regexp_filter
+      self.to_regex_filter
+    end
+
+    def safe_filename?
+      unsafe   = self.blank?
+      unsafe ||= self.starts_with? period
+      unsafe ||= self.starts_with? dash
+
+      unsafe ||= self.end_with? period
+      unsafe ||= self.end_with? dash
+
+      unsafe ||= self =~ self.safe_filename_characters.to_regex_filter
+
+      ! unsafe
+    end
+
+    def safe_path?
+      separator = File::SEPARATOR
+
+      unsafe   = self.starts_with? separator
+      unsafe ||= self.ends_with?   separator
+      unsafe ||= self.split(separator).map(&:safe_filename?).map(&:!).any?
+
+      ! unsafe
+    end
+
+    def hex?
+      return false if self.blank?
+      match_non_hex_digits = /\H/
+      !self[match_non_hex_digits]
+    end
+
+    def number?
+      return false if self.blank?
+      self.gsub(/[^0-9]/, '') == self
+    end
+
+    def readable_number?
+      self.readable_to_i
+      true
+    rescue StandardError => e
+      return false if e.message == "String is not a number"
+      raise
+    end
+
+    def to_boolean
+      _true = self == "true"
+      return true if _true
+
+      _false = self == "false"
+      return false if _false
+
+      message = %w[ Unable to cast supplied string to boolean,
+                    only `"true"` and `"false"` can be coerced into
+                    boolean. ].spaced
+      raise RuntimeError, message
+    end
+
+    def readable_to_i
+      return self.to_i if self.number?
+
+      valid_postfix = self._numeral_postfixes.include? self.last
+      valid_body    = self[0...-1].number?
+      valid = valid_body && valid_postfix
+
+      message = "String is not a number"
+      raise StandardError, message unless valid
+
+      self[0...-1].to_i * self._numeral_postfixes[self.last]
+    end
+
+    def _numeral_postfixes
+      { k: 1000,
+        m: 1000_000,
+        b: 1000_000_000,
+        t: 1000_000_000_000 }.stringify_keys
+    end
+
+    def insta
+      return self if self.starts_with?("@")
+      "@#{self}"
+    end
+
+    def to position
+      self[0..position]
+    end
+
+    def from position
+      self[position..-1]
+    end
+
+    def _ensure_pluralize_available!
+      message = "String does not define pluralize."
+      pluralize_available = self.respond_to? :pluralize
+      raise NotImplementedError, message unless pluralize_available
+    end
+
+    def _ensure_singularize_available!
+      message = "String does not define singularize."
+      singularize_available = self.respond_to? :singularize
+      raise NotImplementedError, message unless singularize_available
+    end
+
+    def plural?(coward: true)
+      self._ensure_pluralize_available!
+      self._ensure_singularize_available!
+
+      plural = self == self.pluralize
+      return plural if !coward || !plural
+
+      non_ambiguous = self.pluralize != self.singularize
+
+      message = \
+      "String is ambiguously plural. Cowardly exiting."
+      raise RuntimeError, message unless non_ambiguous
+
+      true
+    end
+
+    def singular?(coward: true)
+      self._ensure_pluralize_available!
+      self._ensure_singularize_available!
+
+      singular = self == self.singularize
+      return singular if !coward || !singular
+
+      non_ambiguous = self.pluralize != self.singularize
+
+      message = \
+      "String is ambiguously singular. Cowardly exiting."
+      raise RuntimeError, message unless non_ambiguous
+
+      true
+    end
+
+    def last(limit = 1)
+      if limit == 0
+        ""
+      elsif limit >= size
+        self.dup
+      else
+        self.from(-limit)
+      end
+    end
+
+    def first limit=1
+      if limit == 0
+        ""
+      elsif limit >= size
+        dup
+      else
+        to(limit - 1)
+      end
+    end
+
+    def second
+      self[1]
+    end
+
+    def third
+      self[2]
+    end
+
+    def fourth
+      self[3]
+    end
+
+    def fifth
+      self[4]
+    end
+
+    def sixth
+      self[5]
+    end
+
+    def seventh
+      self[6]
+    end
+
+    def eighth
+      self[7]
+    end
+
+    def ninth
+      self[8]
+    end
+
+    def tenth
+      self[9]
+    end
+
+  end
+end

data/lib/vv/true_methods.rb

@@ -0,0 +1,22 @@
+module VV
+  module TrueMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    def to_boolean
+      self
+    end
+
+  end
+
+end

data/lib/vv/version.rb

@@ -1,3 +1,3 @@
 module VV
-  VERSION = '0.0.0.alpha.1'
+  VERSION = '0.0.1'
 end

data/lib/vv.rb

@@ -0,0 +1,27 @@
+require_relative "vv/gem_methods"
+
+Gem.require_files "vv/*.rb"
+
+class String
+  include VV::StringMethods
+end
+
+class Hash
+  include VV::HashMethods
+end
+
+class Array
+  include VV::ArrayMethods
+end
+
+class TrueClass
+  include VV::TrueMethods
+end
+
+class FalseClass
+  include VV::FalseMethods
+end
+
+class NilClass
+  include VV::NilMethods
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vv
 version: !ruby/object:Gem::Version
-  version: 0.0.0.alpha.1
+  version: 0.0.1
 platform: ruby
 authors:
 - Zach Aysan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-21 00:00:00.000000000 Z
+date: 2018-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -24,6 +24,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '12'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
 description: 
 email:
 - zachaysan@gmail.com
@@ -33,8 +61,16 @@ extra_rdoc_files: []
 files:
 - LICENSE.txt
 - README.markdown
+- lib/vv.rb
+- lib/vv/array_methods.rb
+- lib/vv/false_methods.rb
+- lib/vv/gem_methods.rb
+- lib/vv/hash_methods.rb
+- lib/vv/nil_methods.rb
+- lib/vv/readline_methods.rb
+- lib/vv/string_methods.rb
+- lib/vv/true_methods.rb
 - lib/vv/version.rb
-- spec/.gitkeep
 homepage: https://github.com/zachaysan/vv
 licenses:
 - MIT
@@ -50,14 +86,13 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Make ruby very v
-test_files:
-- spec/.gitkeep
+test_files: []