versionaire 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 34468329f30afcc69ad0decfe31ef293346aa16f
-  data.tar.gz: 34a6064108cc26f6d5ee3b69653962911addf75b
+  metadata.gz: 8f98e7ed286afbc8f36bc63f732a74de14c518bf
+  data.tar.gz: d93d7017c56fc9e89c01e40b5b5cb325eb318bdb
 SHA512:
-  metadata.gz: 42567538dadd2d31ab0013bde14b6abfd58dba8617fd5c45df909c1f56fc625b1a4d6a61d4a933fc21dbae2b34bc282ba0326740f880b85839424b5f322fa193
-  data.tar.gz: 8f52ad15a86d56ea3df8bdddb12d6041f8eb9b697218d3b0ff6f78190870a18a1bffc12aa051589e02c4367b4928f65db10ddd8f78c416e3c6ef7b3690aab0d8
+  metadata.gz: 194e775943432b6aea87d091ee276b06107f89b6139753decc86575569448100d6342f2c38a53f8870a46acad175893503133218405fd034a8905dc5e59d4a54
+  data.tar.gz: 3689fcd9696f240039ed5b65eaece574e30be23806a322c525e086ab96c29970f610ebc73ae44cc4c8bc212d87a3c9de6b246c1dedc92b67202173aab77d1b38

data/lib/versionaire/conversion.rb

@@ -5,39 +5,48 @@ module Versionaire
   # Conversion function (strict) for casting an object into a version.
   # rubocop:disable Style/MethodName
   def Version object
-    aid = VersionAid.new object
+    converter = Converter.new object
 
     case object
-      when String then aid.convert_from_string
-      when Array then aid.convert_from_array
-      when Hash then aid.convert_from_hash
+      when String then converter.from_string
+      when Array then converter.from_array
+      when Hash then converter.from_hash
       when Version then object
-      else fail Errors::Conversion, Errors::Conversion.primitive_message
+      else converter.from_object
     end
   end
   module_function :Version
 
   # Aids with converting objects into valid versions.
-  class VersionAid
+  class Converter
     def initialize value
       @value = value
     end
 
-    def convert_from_string
-      fail(Errors::Conversion, Errors::Conversion.string_message) unless value =~ Version.string_format
+    def from_string
+      body = %(Use: "<major>.<minor>.<maintenance>" or "v<major>.<minor>.<maintenance>".)
+      fail(Errors::Conversion, error_message(value, body)) unless value =~ Version.string_format
       Version.new string_to_arguments
     end
 
-    def convert_from_array
-      fail(Errors::Conversion, Errors::Conversion.array_message) unless (0..3).cover?(value.size)
+    def from_array
+      body = "Use: [], [<major>], [<major>, <minor>], or [<major>, <minor>, <maintenance>]."
+      fail(Errors::Conversion, error_message(value, body)) unless (0..3).cover?(value.size)
       Version.new array_to_arguments
     end
 
-    def convert_from_hash
-      fail(Errors::Conversion, Errors::Conversion.hash_message) unless required_keys?
+    def from_hash
+      body = "Use: {major: <major>}, " \
+             "{major: <major>, minor: <minor>}, or " \
+             "{major: <major>, minor: <minor>, maintenance: <maintenance>}."
+      fail(Errors::Conversion, error_message(value, body)) unless required_keys?
       Version.new value
     end
 
+    def from_object
+      fail Errors::Conversion, error_message(value, "Use: String, Array, Hash, or Version.")
+    end
+
     private
 
     attr_reader :value
@@ -53,6 +62,10 @@ module Versionaire
     def required_keys?
       value.keys.all? { |key| Version.keys.include? key }
     end
+
+    def error_message object, body
+      "Invalid version conversion: #{object}. #{body}"
+    end
   end
-  private_constant :VersionAid
+  private_constant :Converter
 end

data/lib/versionaire/errors/conversion.rb

@@ -5,18 +5,22 @@ module Versionaire
     # Thrown when attempting to convert (cast) a primitive to a version.
     class Conversion < Base
       def self.string_message
+        warn "[DEPRECATION]: .string_message is deprecated and will be removed in the next major release."
         %(Invalid string conversion. Use: "<major>.<minor>.<maintenance>" or "v<major>.<minor>.<maintenance>".)
       end
 
       def self.array_message
+        warn "[DEPRECATION]: .array_message is deprecated and will be removed in the next major release."
         "Invalid array conversion. Use: [], [<major>], [<major>, <minor>], or [<major>, <minor>, <maintenance>]."
       end
 
       def self.hash_message
+        warn "[DEPRECATION]: .array_message is deprecated and will be removed in the next major release."
         "Invalid hash conversion. Use: {major: <major>, minor: <minor>, maintenance: <maintenance>}."
       end
 
       def self.primitive_message
+        warn "[DEPRECATION]: .primitive_message is deprecated and will be removed in the next major release."
         "Invalid conversion. Use: String, Array, or Hash."
       end
     end

data/lib/versionaire/identity.rb

@@ -12,7 +12,7 @@ module Versionaire
     end
 
     def self.version
-      "1.0.0"
+      "1.1.0"
     end
 
     def self.version_label

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: versionaire
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -30,7 +30,7 @@ cert_chain:
   aSif+qBc6oHD7EQWPF5cZkzkIURuwNwPBngZGxIKaMAgRhjGFXzUMAaq++r59cS9
   xTfQ4k6fglKEgpnLAXiKdo2c8Ym+X4rIKFfedQ==
   -----END CERTIFICATE-----
-date: 2016-03-26 00:00:00.000000000 Z
+date: 2016-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler