vv 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cd4725920ce804b99be1c23848495c6e9ca83649fd7ab3a69b8af0d21ec6e48
-  data.tar.gz: 4b229f3cc218a33e3cc85bab68ecb1662e41d3a6ab8474c80d031ca04873ab64
+  metadata.gz: 052ef19db592bebd51a14310cc4eea838dbd10645f43c05f15cb774292222990
+  data.tar.gz: 2e23028b168d6cb104a0b631c9b80bcb11696120854fbd603126bc962aa380f9
 SHA512:
-  metadata.gz: 70a7280f7746478071e4f19dd6887ccaba0b4e313010cf9b0502955e5670643767b274813570e27f643d6f08183594a7c031796a7e03e89e8d30b943519ad3de
-  data.tar.gz: 78e143160fbefec25c96fd74201b084634c8a9bd8afbdb49de706e88b9f7e662cd35e9351f63c62004114563f123e3e5c67b00d814d913779da80349350cfbf6
+  metadata.gz: a62626e31c21dbe0c5fd426681c2b0007cb4f0a0e844e77a0f1bf5faa9c49edcc7b2da9a4d2e6650220982f95708d3563ffa68090e2371233f6b66f4db780aa9
+  data.tar.gz: 998917dbf37b9900ef500517674d42fad1c64cacbd4aab294a13c29c5c795cbda0926cd0efd0106969287a58fa3fe0f5398e2980e83e39e7786120d54e871f9d

data/lib/vv/array_methods.rb

@@ -3,6 +3,7 @@ module VV
 
     def self.included(base)
       base.extend(ClassMethods)
+      base.attr_accessor :cli_print_separator
     end
 
     module ClassMethods
@@ -93,6 +94,43 @@ module VV
       self[9]
     end
 
+    def cli_print width: 80,
+                  padding: 0,
+                  position: 0,
+                  separator: nil
+
+      @cli_print_separator ||= String.space
+      separator ||= @cli_print_separator
+
+      pad_length = padding - position
+      position += pad_length
+      print pad_length.spaces
+
+      separator_required = false
+      self.each do | elem |
+        printable = String.capture_stdout {
+          elem.cli_print width: width,
+                         padding: padding,
+                         position: position
+        }
+        string = printable.dup
+        string.prepend separator if separator_required
+        delta = string.unstyled.length
+
+        if position + delta > width
+          puts
+          print padding.spaces
+          print printable
+          position = padding + printable.unstyled.length
+        else
+          print string
+          position += delta
+        end
+        separator_required = true
+      end
+      position
+    end
+
   end
 
 end

data/lib/vv/cli.rb

@@ -0,0 +1,304 @@
+module VV
+
+  class CLI
+
+    attr_reader :option_router,
+                :settings,
+                :cache_path,
+                :config_path,
+                :data_path
+
+    def initialize version: nil,
+                   name: nil,
+                   config_path: nil,
+                   cache_path:  nil,
+                   data_path:   nil
+
+      default_version = "0.0.1"
+      @version = version || default_version
+
+      @config_path = config_path
+      @cache_path  = cache_path
+      @data_path   = data_path
+
+      @option_router = OptionRouter.new( name: name ) do |router|
+        yield router if block_given?
+      end
+
+      @settings = nil
+
+      self.set_default_paths
+    end
+
+    def set_default_paths
+      @config_path ||= File.join File.config_home, name_version
+      @cache_path  ||= File.join File.cache_home,  name_version
+      @data_path   ||= File.join File.data_home,   name_version
+    end
+
+    def name
+      @option_router.name
+    end
+
+    def name_version
+      [ self.name.unstyled, @version ].join("-")
+    end
+
+    def parse_flags argv
+      argv = argv.split " " if argv.is_a? String
+      @settings = @option_router.parse argv
+    end
+
+  end
+
+  class OptionRouter
+
+    attr_reader :flag_settings, :name
+
+    attr_accessor :version, :help, :testing
+
+    def initialize name: nil
+      @flag_settings = LookupTable.new
+      @commands = Hash.new
+      @current_flag = nil
+
+      @name   = name
+      @name ||= "check".style :lightblue, :italic
+
+      self.set_reserved_flags
+      self.set_reserved_commands
+
+      yield self if block_given?
+    end
+
+    def register flags, type: :string
+      flags = [ flags.to_s ] unless flags.is_a? Array
+      type.one_of! :string,
+                   :integer,
+                   :decimal,
+                   :float,
+                   :boolean,
+                   :trilean,
+                   :ternary,
+                   :reserved
+
+      help = block_given? ? yield.squish : nil
+
+      first_flag = flags.first
+
+      flags.each do |flag|
+        if @flag_settings[flag].blank?
+          next if flag == first_flag
+          @flag_settings.alias key: flag, to: first_flag
+          next
+        end
+
+        set_type = @flag_settings[flag][:type]
+        type_ok = set_type != :reserved
+
+        message = "Duplicate flag `#{flag}` cannot be set."
+        fail message if type_ok
+        fail "Reserved flag `#{flag}` cannot be set."
+      end
+
+      settings = { type: type }
+      settings[:help] = help unless help.blank?
+
+      @flag_settings[first_flag] = settings
+    end
+
+    def set_new_flag
+      message = \
+      "Duplicate command line flag #{@flag} encountered."
+
+      @flag = lookup_canonical_flag @flag
+      fail message if @response.include? @flag
+
+      self.set_flag
+    end
+
+    def set_flag
+      @flag = lookup_canonical_flag @flag
+
+      @current_flag = @flag if @value.nil?
+
+      self.set_value
+    end
+
+    def set_value
+      value   = @value
+      value &&= @value.to_d if decimal?
+      value ||= true
+      @response[@flag] = value
+    end
+
+    # This needs a refactor.
+    def parse argv
+      @flags_cease = false
+      @response = {}
+
+      argv.each do |arg|
+        next add_input_arg arg if @flags_cease
+
+        @flag, *@value = arg.split String.equals_sign
+        self.standardize_value
+
+        next @flags_cease = true if self.termination_flag?
+        next handle_command if @commands.include? @flag
+        next set_flag  if @flag_settings.include? @flag
+
+        self.ensure_known_flag!
+
+        next handle_short_flags if self.short_flag?
+        next handle_current     if @current_flag.present?
+
+        self.cease_flag_consideration
+      end
+
+      @response
+    end
+
+    def end_of_commands
+      "--"
+    end
+
+    def reserve flags
+      register flags, type: :reserved
+    end
+
+    def create_flag flag, type: nil
+      raise NotImplementedError
+    end
+
+    def set_reserved_commands
+      set_command :help,    alias_flag: "-h"
+      set_command :version, alias_flag: "-V"
+    end
+
+    def set_reserved_flags
+      [ %w[ -h -?  --help              ],
+        %w[ -V     --version           ],
+        %w[ -v     --verbose           ],
+        %w[ -vv    --very-verbose      ],
+        %w[ -vvv   --very-very-verbose ],
+        %w[ -q     --quiet             ],
+        %w[ -s -qq --absolute-silence  ],
+        %w[ -- ] ].each do |flags|
+
+        self.register flags, type: :reserved
+      end
+    end
+
+    def set_command command, alias_flag: nil
+      command = command.to_s
+      if @commands.include? command
+        raise "Command #{command} already set."
+      end
+
+      @commands[command] = [ :alias_flag, alias_flag ]
+    end
+
+    def lookup_canonical_flag flag
+      @flag_settings.lookup_canonical flag
+    end
+
+    def help_doc
+      ending_flag = %w[ -- ]
+      keys  = @flag_settings.canonical_keys - ending_flag
+      keys += ending_flag
+
+      cli_flags = keys.map do |key|
+        flags = [ key ] + @flag_settings.aliases[key].to_a
+        "[#{flags.join(" | ")}]"
+      end
+
+      { "usage: #{@name}" => cli_flags }
+    end
+
+    def termination_flag?
+      @flag == "--"
+    end
+
+    def handle_command
+      command = @commands[@flag]
+
+      if command.first == :alias_flag
+        @flag = command.second
+        self.set_flag
+      else
+        raise NotImplementedError
+      end
+    end
+
+    def handle_short_flags
+      short_flags = \
+      @flag.after(String.dash).split String.empty_string
+
+      duplicates = \
+      short_flags.count != short_flags.uniq.count
+
+      message = \
+      "Duplicate command line flags in #{@flag}."
+      fail message if duplicates
+    end
+
+    def handle_current
+
+      @value = @flag
+      @flag  = @current_flag
+
+      collection = \
+      @flag_settings[@flag][:type] == :collection
+      if collection
+        @response[@flag] ||= []
+        @response[@flag] << @value
+      else
+        @current_flag = nil
+        self.set_flag
+      end
+
+    end
+
+    def add_input_arg arg
+      @response[:input_arguments] ||= []
+      @response[:input_arguments] << arg
+    end
+
+    def standardize_value
+      present = @value.present?
+      @value = @value.join( String.equals_sign ) if present
+      @value = nil unless @value.present?
+    end
+
+    def short_flag?
+      return false if long_flag?
+      @flag.starts_with? String.dash
+    end
+
+    def long_flag?
+      @flag.starts_with? 2.dashes
+    end
+
+    def ensure_known_flag!
+      message = "Unknown flag `#{@flag}` provided."
+      fail message if @value.present? or self.long_flag?
+    end
+
+    def cease_flag_consideration
+      @flags_cease  = true
+      @current_flag = nil
+      @flag.concat String.equals_sign, @value if @value
+      add_input_arg @flag
+      @flag = @value = nil
+    end
+
+    def flag_type
+      @flag_settings[@flag][:type]
+    end
+
+    def decimal?
+      flag_type == :decimal
+    end
+  end
+
+end

data/lib/vv/file_methods.rb

@@ -75,6 +75,138 @@ module VV
         File::SEPARATOR
       end
 
+      def copy_into filepath,
+                    directory,
+                    allow_hidden: true,
+                    allow_absolute: true
+
+        message = "Filepath `#{filepath}` is unsafe."
+        fail message unless filepath.safe_path?
+
+        message = "Filepath `#{filepath}` is a directory."
+        fail message if filepath.is_directory_path?
+
+        message = "No such `#{directory}` directory."
+        fail message unless directory.is_directory_path?
+
+        FileUtils.cp filepath, directory
+      end
+
+      def rename_directory from,
+                           to,
+                           allow_hidden: true,
+                           allow_absolute: true
+        safe   = from.safe_dir_path? allow_hidden: allow_hidden,
+                                     allow_absolute: allow_absolute
+
+        safe &&= to.safe_dir_path? allow_hidden: allow_hidden,
+                                   allow_absolute: allow_absolute
+
+        message = "Refusing to rename unsafe directory"
+        fail message unless safe
+
+        message = "Source #{from} is not a directory"
+        fail message unless from.is_directory_path?
+
+        message = "Target directory name `#{to}` already exists"
+        fail message if to.is_directory_path?
+
+        return FileUtils.mv from, to
+
+      end
+      alias_method :rename_dir, :rename_directory
+
+      # TODO: Think about making a `directory` method on
+      #       string so from / to is super clear.
+      def move_directory *args, **kwargs
+        message = \
+        %w[ Moving directories is confusing. Call either
+            `rename_directory` or `move_directory_into`
+            depending on your needs. There are many aliases. ]
+          .spaced
+
+        fail NoMethodError, message
+      end
+
+      def move_directory_into dir,
+                              into,
+                              allow_hidden: true,
+                              allow_absolute: true
+
+        safe   = dir.safe_dir_path?  allow_hidden: allow_hidden,
+                                     allow_absolute: allow_absolute
+
+        safe &&= into.safe_dir_path? allow_hidden: allow_hidden,
+                                     allow_absolute: allow_absolute
+
+        message = "Refusing to rename unsafe directory"
+        fail message unless safe
+
+        message = "Target #{into} is not a directory"
+        fail message unless into.is_directory_path?
+
+        message = "Source #{dir} is not a directory"
+        fail message unless dir.is_directory_path?
+
+        FileUtils.mv dir, into
+      end
+      alias_method :move_dir_into, :move_directory_into
+      alias_method :mv_dir_into,   :move_directory_into
+
+      def config_home
+        path   = ENV['XDG_CACHE_HOME']
+        return path unless path.blank?
+        path ||= File.join ENV['HOME'], ".config"
+      end
+      alias_method :xdg_config_home, :config_home
+
+      def data_home
+        path   = ENV['XDG_DATA_HOME']
+        return path unless path.blank?
+        path ||= File.join ENV['HOME'], ".local", "share"
+      end
+      alias_method :output_home,   :data_home
+      alias_method :xdg_data_home, :data_home
+
+      def cache_home sub_directory=nil
+        response   = ENV['XDG_CACHE_HOME']
+        response ||= File.join ENV['HOME'], ".cache"
+
+        return response unless sub_directory
+
+        File.join response, sub_directory
+      end
+      alias_method :xdg_cache_home, :cache_home
+
+      def cache_home! sub_directory
+        path = cache_home sub_directory
+        File.make_dir_if_not_exists path
+        path
+      end
+      alias_method :xdg_cache_home!, :cache_home!
+
+      def make_directory_if_not_exists directory
+        FileUtils.mkdir_p(directory).first
+      end
+      alias_method :make_dir_if_not_exists,
+                   :make_directory_if_not_exists
+
+      def make_directory directory
+        FileUtils.mkdir(directory).first
+      end
+      alias_method :create_directory, :make_directory
+      alias_method :create_dir,       :make_directory
+      alias_method :make_dir,         :make_directory
+
+      def remove_directory directory, quiet_if_gone: false
+        no_directory_exists = ! directory.is_directory_path?
+        return if quiet_if_gone && no_directory_exists
+        FileUtils.remove_dir directory
+      end
+      alias_method :rm_directory, :remove_directory
+      alias_method :remove_dir,   :remove_directory
+      alias_method :rm_dir,       :remove_directory
+
     end
 
     def vv_readlines

data/lib/vv/hash_methods.rb

@@ -38,5 +38,41 @@ module VV
       self
     end
 
+    def cli_print width: 80,
+                  position: 0,
+                  padding: 0
+
+      key_padding = nil
+
+      String.capture_stdout {
+        key_padding = self.keys.map { | key |
+          key.cli_print width: width,
+                        position: position,
+                        padding: padding
+        }.max
+      }
+
+      key_padding += 1
+
+      self.each do | key, value |
+        position = key.cli_print width: width,
+                                 position: position,
+                                 padding: padding
+
+        print ( key_padding - position ).spaces
+
+        value_padding = position = key_padding
+
+        position = value.cli_print width: width,
+                                   position: position,
+                                   padding: value_padding
+
+        puts
+        position = 0
+      end
+
+      position
+    end
+
   end
 end

data/lib/vv/integer_methods.rb

@@ -0,0 +1,25 @@
+class Integer
+
+  def spaces
+    characters String.space
+  end
+
+  def dashes
+    characters String.dash
+  end
+
+  def characters character, fail_on_negative: false
+    message = "Expected single character, not #{character}."
+    fail ArgumentError, message if character.length > 1
+
+    message = "Expected non-negative integer, not `#{self}`."
+    fail message if self < 0 and fail_on_negative
+
+    ( self > 0 ) ? ( character * self ) : String.empty_string
+  end
+
+  def to_i!
+    self
+  end
+
+end

data/lib/vv/object_methods.rb

@@ -1,11 +1,50 @@
 class Object
 
+  alias_method :responds_to?, :respond_to?
+
   def blank?
     respond_to?(:empty?) ? !!empty? : !self
   end unless method_defined? :blank?
 
+  def cli_printable **kwargs
+    String.get_stdout { self.cli_print( **kwargs ) }
+  rescue NoMethodError
+    message = \
+    "`cli_printable` requires `cli_print` on child class"
+    fail NoMethodError, message
+  end unless method_defined? :cli_printable
+
   def present?
     !blank?
   end unless method_defined? :present?
 
+  def one_of? *collection, mixed: false, allow_unsafe: false
+    nested   = collection.first.is_a? Array
+    nested ||= collection.first.is_a? Hash
+    nested ||= collection.first.is_a? Set
+
+    message = \
+    "Unexpected nested argument. If desired set `allow_unsafe: true`."
+    fail ArgumentError, message if nested unless allow_unsafe
+
+    return collection.include? self if mixed
+
+    klass = self.class
+    ok = collection.reject {|s| s.is_a? klass }.blank?
+
+    message = "Invalid types: #{klass} collection required."
+    fail ArgumentError, message unless ok
+
+    collection.include? self
+  end
+
+  def one_of! *collection, mixed: false
+    return true if self.one_of?( *collection, mixed: mixed )
+
+    klass = self.class
+    collection = collection.stringify_collection grave: true
+    message = "#{klass} `#{self}` is invalid. Must be one of: #{collection}."
+    fail message
+  end
+
 end

data/lib/vv/string_methods.rb

@@ -25,12 +25,22 @@ module VV
         ("A".."Z").to_a
       end
 
-      def letters_and_numbers(capitals: false)
+      def letters_and_numbers capitals: false
         response  = self.letters
         response += self.capitals if capitals
         response += self.numbers
       end
 
+      def capture_stdout(&block)
+        original_stdout = $stdout
+        $stdout = StringIO.new
+        yield
+        $stdout.string
+      ensure
+        $stdout = original_stdout
+      end
+      alias_method :get_stdout, :capture_stdout
+
     end
 
     module SharedInstanceAndClassMethods
@@ -47,14 +57,26 @@ module VV
         "-"
       end
 
+      def equals_sign
+        "="
+      end
+
       def period
         "."
       end
 
+      def colon
+        ":"
+      end
+
       def underscore_character
         "_"
       end
 
+      def space
+        " "
+      end
+
       def newline
         "\n"
       end
@@ -75,6 +97,12 @@ module VV
 
     end
 
+    # Instance methods start
+
+    def includes? *args
+      self.include?(*args)
+    end
+
     def starts_with? *args
       self.start_with?(*args)
     end
@@ -98,6 +126,10 @@ module VV
       self.chomp(string) + string
     end
 
+    def with_newline
+      self.with_ending newline
+    end
+
     def squish!
       self.gsub!(/\A[[:space:]]+/, "")
       self.gsub!(/[[:space:]]+\z/, "")
@@ -146,9 +178,10 @@ module VV
       self.to_regex_filter
     end
 
-    def safe_filename?
+    def safe_filename?( allow_hidden: false )
       unsafe   = self.blank?
-      unsafe ||= self.starts_with? period
+
+      unsafe ||= self.starts_with?(period) unless allow_hidden
       unsafe ||= self.starts_with? dash
 
       unsafe ||= self.end_with? period
@@ -159,16 +192,52 @@ module VV
       ! unsafe
     end
 
-    def safe_path?
+    def safe_path?( allow_hidden: false, allow_absolute: false )
+      safe = self.safe_dir_path? allow_hidden: allow_hidden,
+                                 allow_absolute: allow_absolute
+
+      unsafe   = ( ! safe )
+      unsafe ||= self.ends_with? File::SEPARATOR
+
+      ! unsafe
+    end
+
+    def safe_dir_path? allow_hidden: false,
+                       allow_absolute: true
       separator = File::SEPARATOR
 
-      unsafe   = self.starts_with? separator
-      unsafe ||= self.ends_with?   separator
-      unsafe ||= self.split(separator).map(&:safe_filename?).map(&:!).any?
+      unsafe   = false
+      unsafe ||= self.starts_with?(separator) unless allow_absolute
+      unsafe ||= self.after(separator, safe: false)
+                   .split(separator).map do |fragment|
+        fragment.safe_filename? allow_hidden: allow_hidden
+      end.map(&:!).any?
 
       ! unsafe
     end
 
+    def is_directory_path?
+      File.directory? self
+    end
+
+    def is_file_path?
+      File.file? self
+    end
+
+    def file_join *args
+      unsafe = args.reject(&:safe_path?)
+
+      return File.join self, *args if unsafe.blank?
+
+      frags = unsafe.first(3).stringify_collection grave: true
+      count = unsafe.count
+
+      message = \
+      "#{count} unsafe path fragments including: #{frags}"
+
+      fail ArgumentError, message
+    end
+
     def hex?
       return false if self.blank?
       match_non_hex_digits = /\H/
@@ -225,6 +294,17 @@ module VV
         t: 1000_000_000_000 }.stringify_keys
     end
 
+    def unstyle
+      self.gsub( /\e\[+\d+m/, empty_string )
+        .gsub( /\e\[((\d+)+\;)+\d+m/, empty_string )
+    end
+    alias_method :unstyled, :unstyle
+
+    def unstyle!
+      self.gsub!( /\e\[+\d+m/,          empty_string )
+      self.gsub!( /\e\[((\d+)+\;)+\dm/, empty_string )
+    end
+
     def style *args
       color = bold = underline = italic = nil
 
@@ -273,6 +353,10 @@ module VV
       "@#{self}"
     end
 
+    def insta_sym
+      self.insta.to_sym
+    end
+
     def to position
       self[0..position]
     end
@@ -381,5 +465,47 @@ module VV
       self[9]
     end
 
+    def cli_print width: 80,
+                  padding: 0,
+                  position: 0,
+                  hard_wrap: false
+
+      raise NotImplemented if hard_wrap
+      raise NotImplemented if self.includes? newline
+
+      pad_length = padding - position
+      position += pad_length
+      print pad_length.spaces
+
+      unstyled_length = self.unstyled.length
+      remaining_length = width - position
+      if unstyled_length <= remaining_length
+        print self
+        position += unstyled_length
+        return position
+      end
+
+      space_index   = self[0..remaining_length].rindex(" ")
+      space_index ||= self.index(" ")
+
+      if space_index
+        sub = self[0..space_index]
+        print sub
+        puts
+        position = 0
+        start = space_index + 1
+        return self[start..-1].cli_print width: width,
+                                         padding: padding,
+                                         position: position,
+                                         hard_wrap: hard_wrap
+      else
+        print self
+        puts
+        position = 0
+      end
+
+      return position
+    end
+
   end
 end

data/lib/vv/symbol_methods.rb

@@ -0,0 +1,31 @@
+module VV
+  module SymbolMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+      def vv_included?
+        true
+      end
+    end
+
+    def insta
+      self.to_s.insta
+    end
+
+    def insta_sym
+      self.to_s.insta_sym
+    end
+
+    def plural? *args, **kwargs
+      self.to_s.plural?( *args, **kwargs )
+    end
+
+    def singular? *args, **kwargs
+      self.to_s.singular?( *args, **kwargs )
+    end
+
+  end
+end

data/lib/vv/utility/automate.rb

@@ -73,11 +73,89 @@ module VV
 
     def push( name: )
       puts %x{ TAG_VERSION=$(./bin/version)
+               git push origin HEAD && \\
+               gem push $(readlink -f #{name}-*.gem | sort | tail -n 1) && \\
                git push origin v${TAG_VERSION}
-               gem push $(readlink -f #{name}-*.gem | sort | tail -n 1 )
-      }
+       }
     end
     module_function :push
 
+    def run command: nil, annoying_command: nil
+      command ||= "rake"
+      annoying_command ||= command
+      args = ARGV.to_a
+
+      # breaking out of binding.pry is hard without exec
+      exec command if args.empty?
+
+      return annoying_command(args, command: annoying_command)
+    end
+    module_function :run
+
+    def annoying_command args, command: nil
+      command ||= "rake"
+
+      test_dir = File.join File.expand_path(Dir.pwd), "test"
+      temp_test_dir = "temp_test_dir_#{Random.identifier 6}"
+
+      message = "Cannot find test directory `#{test_dir}`."
+      fail message unless test_dir.is_directory_path?
+
+      fail "Unexpected arg count" if args.size > 2
+
+      helper_file = "test_helper.rb"
+      file, line_number = args
+
+      if line_number.nil?
+        file, line_number = file.split(String.colon)[0..1]
+      end
+
+      File.rename_directory test_dir, temp_test_dir
+      sleep 0.01
+      File.make_directory test_dir
+
+      path = file.split(File.separator).last
+      new_filename = temp_test_dir.file_join path
+      helper_file  = temp_test_dir.file_join helper_file
+      File.copy_into new_filename, test_dir
+      File.copy_into helper_file,  test_dir
+
+      if line_number
+        line_number = line_number.to_i!
+        i = j = line_number - 1
+        lines = File.vv_readlines test_dir.file_join(path)
+
+        while i > 0
+          line = lines[i]
+          break if line.start_with? "  def "
+          i -= 1
+        end
+
+        while j < lines.count
+          line = lines[j]
+          break if line.start_with? "  end"
+          j += 1
+        end
+        content = (lines[0..3] + lines[i..j] + lines[-2..-1] ).join("\n")
+        content += "\n"
+
+        File.write test_dir.file_join(path), content
+      end
+
+      full_command = \
+        [ command,
+          "rm -r #{test_dir}",
+          "mv #{temp_test_dir} #{test_dir}" ].join(" && ")
+
+      exec full_command
+
+    # The below shouldn't run in normal operation, since
+    # exec will replace the current process
+    ensure
+      File.remove_directory test_dir
+      File.rename_directory temp_test_dir, test_dir
+    end
+    module_function :annoying_command
+
   end
 end

data/lib/vv/utility/lookup_table.rb

@@ -0,0 +1,87 @@
+class LookupTable
+
+  attr_reader :canonnicals, :aliases, :data
+
+  def initialize
+    @canonicals = Hash.new
+    @aliases = Hash.new
+    @data = Hash.new
+  end
+
+  def alias( key:, to: )
+    _ensure_alias_possible key
+
+    @canonicals[key] = to
+
+    @aliases[to] ||= Set.new
+    @aliases[to] << key
+  end
+
+  def []= key, value
+    @data[ self.canonical key ] = value
+  end
+
+  def [] key
+    @data[ self.canonical key ]
+  end
+
+  def canonical key
+    @canonicals[key] || key
+  end
+
+  def canonical_keys
+    @data.keys + (@aliases.keys - @data.keys)
+  end
+
+  def include? key
+    @data.include?( self.canonical key )
+  end
+
+  def to_h
+    keys = self.canonical_keys
+
+    keys.inject({}) {|acc, key|
+      data     = @data[key]    || {}
+      aliases  = @aliases[key] || {}
+      acc[key] = { data: data, aliases: aliases.to_a }
+      acc
+    }
+  end
+
+  # Make Object class method called `delegate_missing`?
+  def method_missing(method, *args, **kwargs, &block)
+    super
+  rescue NoMethodError
+    begin
+      if args.size > 0 && kwargs.size > 0
+        return self.to_h.public_send method, *args, **kwargs, &block
+      elsif args.size > 0
+        return self.to_h.public_send method, *args, &block
+      elsif kwargs.size > 0
+        return self.to_h.public_send method, **kwargs, &block
+      else
+        return self.to_h.public_send method, &block
+      end
+    rescue NoMethodError
+    end
+    raise
+  end
+
+  def lookup_canonical key
+    return key if self.canonical_keys.include? key
+
+    @canonicals[key]
+  end
+
+  protected
+
+  def _ensure_alias_possible key
+    return if @aliases[key].blank?
+    aliases = @aliases[key]
+    count = aliases.count
+    message = \
+    "Cannot alias `#{key}` because #{count} others currently alias it."
+    fail message
+  end
+
+end

data/lib/vv/version.rb

@@ -1,3 +1,3 @@
 module VV
-  VERSION = '0.0.8'
+  VERSION = '0.0.9'
 end

data/lib/vv.rb

@@ -1,4 +1,8 @@
 require 'securerandom'
+require 'set'
+require 'bigdecimal'
+require 'bigdecimal/util'
+require 'fileutils'
 
 require_relative "vv/gem_methods"
 
@@ -6,6 +10,10 @@ Gem.require_files "vv/*.rb"
 Gem.require_files "vv/style/*.rb"
 Gem.require_files "vv/utility/*.rb"
 
+class Symbol
+  include VV::SymbolMethods
+end
+
 class String
   include VV::StringMethods
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vv
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Zach Aysan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-29 00:00:00.000000000 Z
+date: 2019-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -63,10 +63,12 @@ files:
 - README.markdown
 - lib/vv.rb
 - lib/vv/array_methods.rb
+- lib/vv/cli.rb
 - lib/vv/false_methods.rb
 - lib/vv/file_methods.rb
 - lib/vv/gem_methods.rb
 - lib/vv/hash_methods.rb
+- lib/vv/integer_methods.rb
 - lib/vv/nil_methods.rb
 - lib/vv/object_methods.rb
 - lib/vv/random_methods.rb
@@ -77,8 +79,10 @@ files:
 - lib/vv/style/format.rb
 - lib/vv/style/italic.rb
 - lib/vv/style/underline.rb
+- lib/vv/symbol_methods.rb
 - lib/vv/true_methods.rb
 - lib/vv/utility/automate.rb
+- lib/vv/utility/lookup_table.rb
 - lib/vv/version.rb
 homepage: https://github.com/zachaysan/vv
 licenses: