vv 0.0.14 → 0.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c8c547349232035004a745cf52e55bd36defde893a895fb1cd92227d96959b0
-  data.tar.gz: 7e2126cd0d4b9e25372567a17bff5a64f9ca635bad9dc1bab9f59dcdac10cc7e
+  metadata.gz: 4f7b33e4bf1daadb65c4aa05ccc583213a0808f78f6bf7b6205da479fe05cf34
+  data.tar.gz: ab9838d4ebeb70a227c77fd871da29343ad64a138eb7e0e3cd1b921e374ec17c
 SHA512:
-  metadata.gz: e74e8862eec31bca21f58fa8f3edeed18dad800b45d5cc8fb66da56bc0c24f5d923ba7283c7785091d2c05a25ff07edaf1b57a51a8d36ba2d78910254ddc2aea
-  data.tar.gz: 0c9110bf3f7246f722cd6e65c7d1f461d821afb64a3364585a116c7d437689dc78b55378771de511887cc3248992e95be88ffaa7f68ab9ddc2578a4290275a9d
+  metadata.gz: 938ce048bb3d4d71230c96ff80160ef82f472ff2307c431d04ba50281fecd70fd9227c05e01ec08d12eef1c63d4cf46961a8b581c8f9bb7c3a21dccd98f86269
+  data.tar.gz: c466b8987c0ff65dcfdea6fc37e76a484c24be303877714ab57fcd251c5f0db0c190452d268ece3753d96610bf3f6397f788411a347c3d7ff85fcef13856055d

data/lib/vv.rb

@@ -12,6 +12,11 @@ require_relative "vv/set_methods"
 Gem.require_files "vv/*.rb"
 Gem.require_files "vv/style/*.rb"
 Gem.require_files "vv/utility/*.rb"
+Gem.require_files "vv/serialization/*.rb"
+
+class Object
+  include VV::ObjectMethods
+end
 
 class Symbol
   include VV::SymbolMethods

data/lib/vv/array_methods.rb

@@ -15,6 +15,10 @@ module VV
 
     end
 
+    def vv_json
+      VV::JSON.generate self
+    end
+
     def spaced
       self.join(" ")
     end

data/lib/vv/float_methods.rb

@@ -40,7 +40,7 @@ module VV
       use_min ||= ( infinite?    and self < 0 )
       return min.to_json if use_min
 
-      JSON.dump(self)
+      ::JSON.dump(self)
     end
 
   end

data/lib/vv/hash_methods.rb

@@ -13,11 +13,8 @@ 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
+      VV::JSON.generate self
     end
 
     def symbolize_keys

data/lib/vv/integer_methods.rb

@@ -13,6 +13,55 @@ module VV
 
     end
 
+    def vv_json
+      self.to_json
+    end
+
+    def ceil_divide divisor
+      self % divisor > 0 ? ( self / divisor ) + 1 : self / divisor
+    end
+
+    def bits
+      bits_per_byte = 8
+      self.ceil_divide bits_per_byte
+    end
+
+    def kibibytes
+      self * 1024
+    end
+    alias_method :kibibyte, :kibibytes
+    alias_method :KiB,      :kibibytes
+
+    def mebibytes
+      self.kibibytes * 1024
+    end
+    alias_method :mebibyte, :mebibytes
+    alias_method :MiB,      :mebibytes
+
+    def gibibytes
+      self.mebibytes * 1024
+    end
+    alias_method :gibibyte, :gibibytes
+    alias_method :GiB,      :gibibytes
+
+    def tebibytes
+      self.gibibytes * 1024
+    end
+    alias_method :tebibyte, :tebibytes
+    alias_method :TiB,      :tebibytes
+
+    def pebibytes
+      self.tebibytes * 1024
+    end
+    alias_method :pebibyte, :pebibytes
+    alias_method :PiB,      :pebibytes
+
+    def exbibytes
+      self.pebibytes * 1024
+    end
+    alias_method :exbibyte, :exbibytes
+    alias_method :EiB,      :exbibytes
+
     def spaces
       characters String.space
     end

data/lib/vv/nil_methods.rb

@@ -13,6 +13,10 @@ module VV
 
     end
 
+    def vv_json
+      self.to_json
+    end
+
     def to_boolean
       false
     end

data/lib/vv/object_methods.rb

@@ -1,57 +1,75 @@
-class Object
+module VV
 
-  alias_method :responds_to?, :respond_to?
+  module ObjectMethods
 
-  def blank?
-    respond_to?(:empty?) ? !!empty? : !self
-  end unless method_defined? :blank?
+    alias_method :responds_to?, :respond_to?
 
-  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 set_attrs_via( *attributes, document: )
+      attributes.flatten!
+      document.keys.to_set.includes_all! attributes
+      attributes.each do |attribute|
+        value  = document.fetch(attribute)
+        setter = attribute.setter_sym
+        insta  = attribute.insta_sym
+        if self.respond_to? setter
+          self.public_send setter, value
+        else
+          self.instance_variable_set insta, value
+        end
+      end
+    end
 
-  def present?
-    !blank?
-  end unless method_defined? :present?
+    def blank?
+      respond_to?(:empty?) ? !!empty? : !self
+    end unless method_defined? :blank?
 
-  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
+    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
 
-    message = \
-    "Unexpected nested argument. If desired set `allow_unsafe: true`."
-    fail ArgumentError, message if nested unless allow_unsafe
+    def present?
+      !blank?
+    end unless method_defined? :present?
 
-    return collection.include? self if mixed
+    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
 
-    klass = self.class
-    ok = collection.reject {|s| s.is_a? klass }.blank?
+      message = \
+      "Unexpected nested argument. If desired set `allow_unsafe: true`."
+      fail ArgumentError, message if nested unless allow_unsafe
 
-    message = "Invalid types: #{klass} collection required."
-    fail ArgumentError, message unless ok
+      return collection.include? self if mixed
 
-    collection.include? self
-  end
+      klass = self.class
+      ok = collection.reject {|s| s.is_a? klass }.blank?
 
-  def one_of! *collection, mixed: false
-    return true if self.one_of?( *collection, mixed: mixed )
+      message = "Invalid types: #{klass} collection required."
+      fail ArgumentError, message unless ok
 
-    klass = self.class
-    collection = collection.stringify_collection grave: true
-    message = "#{klass} `#{self}` is invalid. Must be one of: #{collection}."
-    fail message
-  end
+      collection.include? self
+    end
 
-  def is_a! klass
-    message = \
-    "Expected `#{klass}` instance, not `#{self.class}`."
-    fail ArgumentError, message unless self.is_a? klass
-  end
-  alias_method :must_be_a!, :is_a!
+    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
+
+    def is_a! klass
+      message = \
+      "Expected `#{klass}` instance, not `#{self.class}`."
+      fail ArgumentError, message unless self.is_a? klass
+    end
+    alias_method :must_be_a!, :is_a!
+
+  end
 end

data/lib/vv/serialization/json.rb

@@ -0,0 +1,88 @@
+class VV::JSON
+
+  def self.default_max
+    1.mebibyte
+  end
+
+  def self.generate object,
+                    maximum_bytes=nil,
+                    **kwargs
+
+    max = maximum_bytes || self.default_max
+
+    generator = self.new( max, **kwargs )
+    generator.serialize object
+  end
+
+  def initialize maximum_bytes,
+                 float_kwargs: nil
+
+    @max = maximum_bytes
+    @response = ""
+    @float_kwargs = float_kwargs || {}
+  end
+
+  def serialize object
+
+    self.check_for_size_failure!
+
+    case object
+    when Hash
+      @response += "{"
+
+      object.each do |key, value|
+        self.serialize! key.to_s
+        @response += ":"
+
+        self.serialize! value
+        @response += ","
+      end
+
+      @response.chomp! ","
+      @response += "}"
+    when Array
+      @response += "["
+
+      object.each do |value|
+        self.serialize! value
+        @response += ","
+      end
+
+      @response.chomp! ","
+      @response += "]"
+    when String
+      self.size_failure! if ( object.size + 2 ) > @max
+      @response += object.to_json
+    when Float
+      @response += object.vv_json( **@float_kwargs )
+    else
+      if object.respond_to? :vv_json
+        @response += object.vv_json
+      else
+        fail "VV::JSON cannot generate JSON for `#{object.class}`."
+      end
+    end
+
+    self.check_for_size_failure!
+
+    @response
+  end
+  alias_method :serialize!, :serialize
+
+  def default_max
+    self.class.default_max
+  end
+
+  def check_for_size_failure!
+    size_failure! if @response.size > @max
+  end
+
+  def size_failure!
+    if @max == self.default_max
+      fail "VV::JSON generation size exceeds default max of 1 MiB"
+    else
+      fail "VV::JSON generation size exceeds max of `#{@max}` bytes"
+    end
+  end
+
+end

data/lib/vv/set_methods.rb

@@ -15,6 +15,10 @@ module VV
 
     end
 
+    def vv_json
+      self.to_a.vv_json
+    end
+
     module SetAndArrayMethods
 
       def gravify
@@ -39,7 +43,7 @@ module VV
         ok_type   = other.is_a? Array
         ok_type ||= other.is_a? Set
 
-        fail TypeError, "Expecting array" unless ok_type
+        fail TypeError, "Expecting array or set" unless ok_type
 
         ( self & other ).one?
       end
@@ -56,7 +60,7 @@ module VV
         ok_type   = other.is_a? Array
         ok_type ||= other.is_a? Set
 
-        fail TypeError, "Expecting array" unless ok_type
+        fail TypeError, "Expecting array or set" unless ok_type
         ( self & other ).any?
       end
       alias_method :include_any?, :includes_any?
@@ -68,6 +72,37 @@ module VV
       end
       alias_method :include_any!, :includes_any!
 
+      def includes_all? other
+        ok_type   = other.is_a? Array
+        ok_type ||= other.is_a? Set
+
+        fail TypeError, "Expecting array or set" unless ok_type
+        ( other.to_set & self ) == other.to_set
+      end
+      alias_method :include_all?, :includes_all?
+
+      def includes_all! other
+        return true if includes_all? other
+        other = other.to_set
+        remaining = other - ( other & self )
+        count = remaining.count
+
+        message = "Collection "
+        including = remaining.first(3).stringify_collection grave: true
+
+        fail "Assertion error" if count < 1
+
+        if count < 4
+          message += "does not include: #{including}."
+        else
+          message += \
+          "does not include #{count} items, including: #{including}."
+        end
+
+        fail message
+      end
+      alias_method :include_all!, :includes_all!
+
       def stringify_collection grave: false
         return self.gravify.stringify_collection if grave
 

data/lib/vv/string_methods.rb

@@ -323,11 +323,15 @@ module VV
       raise RuntimeError, message
     end
 
+    def vv_json
+      VV::JSON.generate self
+    end
+
     def parse notation: :json
       message = "Only JSON support at this time."
       fail NotImplementedError, message unless notation == :json
 
-      JSON.parse self
+      ::JSON.parse self
     end
 
     def parse_json
@@ -436,6 +440,15 @@ module VV
       self.insta.to_sym
     end
 
+    def setter
+      return self if self.ends_with?(String.equals_sign)
+      "#{self}="
+    end
+
+    def setter_sym
+      self.setter.to_sym
+    end
+
     def to position
       self[0..position]
     end

data/lib/vv/symbol_methods.rb

@@ -11,6 +11,10 @@ module VV
       end
     end
 
+    def vv_json
+      self.to_s.vv_json
+    end
+
     def insta
       self.to_s.insta
     end
@@ -19,6 +23,14 @@ module VV
       self.to_s.insta_sym
     end
 
+    def setter
+      self.to_s.setter
+    end
+
+    def setter_sym
+      self.to_s.setter_sym
+    end
+
     def plural? *args, **kwargs
       self.to_s.plural?( *args, **kwargs )
     end

data/lib/vv/utility/automate.rb

@@ -49,8 +49,9 @@ module VV
         puts "++  - minor increment"
         puts "+++ - major increment"
         puts
-        puts "x.y.z - to set version explicitly"
-        puts "reset - to revert to version in git"
+        puts "x.y.z  - to set version explicitly"
+        puts "reset  - to revert to version in git"
+        puts "commit - to commit the version change"
         puts
         exit
       end

data/lib/vv/version.rb

@@ -1,3 +1,3 @@
 module VV
-  VERSION = '0.0.14'
+  VERSION = '0.0.15'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vv
 version: !ruby/object:Gem::Version
-  version: 0.0.14
+  version: 0.0.15
 platform: ruby
 authors:
 - Zach Aysan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-05 00:00:00.000000000 Z
+date: 2019-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -77,6 +77,7 @@ files:
 - lib/vv/object_methods.rb
 - lib/vv/random_methods.rb
 - lib/vv/readline_methods.rb
+- lib/vv/serialization/json.rb
 - lib/vv/set_methods.rb
 - lib/vv/string_methods.rb
 - lib/vv/style/bold.rb
@@ -108,8 +109,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Make ruby very v