vv 0.0.11 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2d912eb9fcb0485c2139ebe4518ae370ce45125c86d5bb626b3beb056068a7c
-  data.tar.gz: c0c9004e1998216defa6efc4a7568ef397920bc35754c43f23a6279be596dbf4
+  metadata.gz: 5f3bcbbe7ea69583dce95c3b9d9a702fda226a2bb9e63f524c0a76cc18b69142
+  data.tar.gz: 36b73375b12feb1240c7361309ad1b346e0893291c1d068eafd2f2eca20d8aac
 SHA512:
-  metadata.gz: 65d5efbd8f5b7e2e9da027954375920164b2e0b246b95edeb3b381a139b30d4e76570f77b0fa43c9c45dd55542fabacbd5bd996beb832a8c344fcca0b2740606
-  data.tar.gz: 31b97ec5a249b43d8419debf89cb59e48fa6c4786684be18eae8d61b9f8c6d4bd5e4dffe1af2617ce22b20d4aae202edff0acbf4110598627f418b764dabbb45
+  metadata.gz: '09b06bd73467b0f00bf81fc89ac494b153db055042ddbad586dc332b1ca460cb217728860a311ffb09b7f8ebd464dc1eb7d8153a3ce51d4a6b140cf84ecb9641'
+  data.tar.gz: d8401e963170293b4a591f49ef040350d3a6fdb557102b741717bd89ebbd40deb3f7984e5f71a0281cbe6344b6a904c96833a328ff60e59981342c6b811c3d43

data/lib/vv/cli.rb

@@ -38,9 +38,9 @@ module VV
     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
+      @config_path ||= File.config_home! name_version
+      @cache_path  ||= File.cache_home!  name_version
+      @data_path   ||= File.data_home!   name_version
     end
 
     def name

data/lib/vv/file_methods.rb

@@ -153,29 +153,35 @@ module VV
       alias_method :move_dir_into, :move_directory_into
       alias_method :mv_dir_into,   :move_directory_into
 
-      def config_home
+      def config_home sub_directory=nil
         path   = ENV['XDG_CACHE_HOME']
-        return path unless path.blank?
         path ||= File.join ENV['HOME'], ".config"
+
+        return path unless sub_directory
+
+        File.join path, sub_directory
       end
       alias_method :xdg_config_home, :config_home
 
       # Where application specific files should be stored
-      def data_home
+      def data_home sub_directory=nil
         path   = ENV['XDG_DATA_HOME']
-        return path unless path.blank?
         path ||= File.join ENV['HOME'], ".local", "share"
+
+        return path unless sub_directory
+
+        File.join path, sub_directory
       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"
+        path   = ENV['XDG_CACHE_HOME']
+        path ||= File.join ENV['HOME'], ".cache"
 
-        return response unless sub_directory
+        return path unless sub_directory
 
-        File.join response, sub_directory
+        File.join path, sub_directory
       end
       alias_method :xdg_cache_home, :cache_home
 
@@ -186,11 +192,29 @@ module VV
       end
       alias_method :xdg_cache_home!, :cache_home!
 
+      def config_home! sub_directory
+        path = config_home sub_directory
+        File.make_dir_if_not_exists path
+        path
+      end
+      alias_method :xdg_config_home!, :config_home!
+
+      def data_home! sub_directory
+        path = data_home sub_directory
+        File.make_dir_if_not_exists path
+        path
+      end
+      alias_method :xdg_data_home!, :data_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
+      alias_method :create_directory_if_not_exists,
+                   :make_directory_if_not_exists
+      alias_method :create_dir_if_not_exists,
+                   :make_directory_if_not_exists
 
       def make_directory directory
         FileUtils.mkdir(directory).first
@@ -208,6 +232,16 @@ module VV
       alias_method :remove_dir,   :remove_directory
       alias_method :rm_dir,       :remove_directory
 
+      def remove filepath, force: false
+        message = \
+        "Cowardly refusing to remove directory (see `remove_directory`)"
+        fail message if filepath.is_directory_path?
+
+        force ? FileUtils.rm_f(filepath) : FileUtils.rm(filepath)
+      end
+      alias_method :remove_file, :remove
+      alias_method :rm,          :remove
+
     end
 
     def vv_readlines

data/lib/vv/float_methods.rb

@@ -0,0 +1,47 @@
+module VV
+  module FloatMethods
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+
+      def vv_included?
+        true
+      end
+
+    end
+
+    def vv_json nan_coerces: false,
+                infinity_coerces: false,
+                max: nil,
+                min: nil
+
+      fail "Expecting numeric value for `max`" if max.is_a? String
+      fail "Expecting numeric value for `min`" if min.is_a? String
+
+      message = \
+      "Infinite not convertable sans `infinity_coerces: true`. "
+      message += "Set `max` and `min` for non-null coercion."
+      fail message if infinite? unless infinity_coerces
+
+      message = \
+      "NaN not convertable sans `nan_coerces: true`."
+      fail message if self.nan? unless nan_coerces
+
+      return nil.to_json if nan?
+
+      use_max   = ( max.present? and self > max )
+      use_max ||= ( infinite?    and self > 0 )
+      return max.to_json if use_max
+
+      use_min   = ( min.present? and self < min )
+      use_min ||= ( infinite?    and self < 0 )
+      return min.to_json if use_min
+
+      JSON.dump(self)
+    end
+
+  end
+end

data/lib/vv/hash_methods.rb

@@ -13,6 +13,21 @@ module VV
 
     end
 
+    # See Float#vv_json.
+    # Intended for common sense json doc generation with reasonable
+    # length, depth, and size limits.
+    def vv_json
+      raise NotImplementedError
+    end
+
+    def symbolize_keys
+      transform_keys{ |key| key.to_sym }
+    end
+
+    def symbolize_keys!
+      transform_keys!{ |key| key.to_sym }
+    end
+
     def stringify_keys
       transform_keys{ |key| key.to_s }
     end

data/lib/vv/integer_methods.rb

@@ -1,25 +1,39 @@
-class Integer
+module VV
+  module IntegerMethods
 
-  def spaces
-    characters String.space
-  end
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
 
-  def dashes
-    characters String.dash
-  end
+    module ClassMethods
 
-  def characters character, fail_on_negative: false
-    message = "Expected single character, not #{character}."
-    fail ArgumentError, message if character.length > 1
+      def vv_included?
+        true
+      end
 
-    message = "Expected non-negative integer, not `#{self}`."
-    fail message if self < 0 and fail_on_negative
+    end
 
-    ( self > 0 ) ? ( character * self ) : String.empty_string
-  end
+    def spaces
+      characters String.space
+    end
 
-  def to_i!
-    self
-  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
 end

data/lib/vv/string_methods.rb

@@ -296,10 +296,6 @@ module VV
       raise
     end
 
-    def to_i!
-      Integer(self)
-    end
-
     def to_boolean
       _true = self == "true"
       return true if _true
@@ -313,6 +309,36 @@ module VV
       raise RuntimeError, message
     end
 
+    def parse notation: :json
+      message = "Only JSON support at this time."
+      fail NotImplementedError, message unless notation == :json
+
+      JSON.parse self
+    end
+
+    def parse_json
+      self.parse notation: :json
+    end
+
+    def to_h parse: :json, symbolize_keys: false
+      message = "Only JSON support at this time."
+      fail NotImplementedError, message unless parse == :json
+
+      response = self.parse_json
+
+      response.symbolize_keys! if symbolize_keys
+
+      return response if response.to_h == response
+
+      message = \
+      "Parse string was #{response.class}, instead of Hash."
+      fail message
+    end
+
+    def to_i!
+      Integer(self)
+    end
+
     def readable_to_i
       return self.to_i if self.number?
 

data/lib/vv/utility/automate.rb

@@ -1,4 +1,9 @@
 module VV
+
+  # Automate runs standalone from the rest of the repo, so
+  # the code here intentionally avoids using helpers that
+  # VV adds to ruby classes.
+
   module Automate
 
     def version path:
@@ -55,7 +60,10 @@ module VV
     end
     module_function :version
 
-    def build( name: )
+    def build( name: , argv: nil )
+      simple = %w[ simple force ].include? argv.first
+      return build_simple name: name if simple
+
       puts %x{ find lib/ | \\
          xargs git ls-files --error-unmatch > /dev/null 2>&1 \\
          || ( echo && \\
@@ -71,6 +79,15 @@ module VV
     end
     module_function :build
 
+    def build_simple( name: )
+      puts %x{ rm #{name}-*.gem
+         gem uninstall --ignore-dependencies #{name} > /dev/null
+         gem build --force #{name}.gemspec
+         gem install --force --local $(readlink -f #{name}-*.gem | sort | tail -n 1 ) --pre
+       }
+    end
+    module_function :build_simple
+
     def push( name: )
       puts %x{ TAG_VERSION=$(./bin/version)
                git push origin HEAD && \\

data/lib/vv/version.rb

@@ -1,3 +1,3 @@
 module VV
-  VERSION = '0.0.11'
+  VERSION = '0.0.12'
 end

data/lib/vv.rb

@@ -1,3 +1,4 @@
+require "json"
 require "securerandom"
 require "readline"
 require "set"
@@ -48,6 +49,14 @@ class NilClass
   include VV::NilMethods
 end
 
+class Integer
+  include VV::IntegerMethods
+end
+
+class Float
+  include VV::FloatMethods
+end
+
 class Random
   include VV::RandomMethods
   extend  VV::RandomClassSettings

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vv
 version: !ruby/object:Gem::Version
-  version: 0.0.11
+  version: 0.0.12
 platform: ruby
 authors:
 - Zach Aysan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-21 00:00:00.000000000 Z
+date: 2019-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -66,6 +66,7 @@ files:
 - lib/vv/cli.rb
 - lib/vv/false_methods.rb
 - lib/vv/file_methods.rb
+- lib/vv/float_methods.rb
 - lib/vv/gem_methods.rb
 - lib/vv/hash_methods.rb
 - lib/vv/integer_methods.rb