inum 2.0.5 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cb32378c9020ed24378f516a690610f0783bc7f8
-  data.tar.gz: b5ad93ed97447e1b339fc1b03e7647999776d615
+  metadata.gz: 22aedb5b28a96d4fb2b87466cbffc375c4a70021
+  data.tar.gz: bdf437ba85301196c9ddef1e7845dc7edbe26aec
 SHA512:
-  metadata.gz: bde688e1396bb28dc39d2506be12b6c5172cb4f65c072c00fc8a1097964b62056968791e2b19c649ccd2aa9f2f4815428b05b444bbb1afef221e4cdf8b1d04ff
-  data.tar.gz: 56387c80afda5178087060b581f281b9bf4b43b10112ef1cedf0bb3070956007d0a946f3427d4e9a5cec49ab0f4c2df956765244857d382e58e619d6d20b6f2e
+  metadata.gz: 452079b77b61139657ecec9728a330630f1a0fea0cd36d7c6f4ff55bf2cac2c8273662d107670f312f0fb1c3ee0d05a5111ccb726d00b49780e24574ad9b926b
+  data.tar.gz: a16a2b6c01fdbb707d836efc10104cc952d65e694464e046673d9c1fe0deb1cbadf1746273c816704b18ccaf7b9a0d3034318955bfd912d57080e5b3066a8280

data/lib/inum/base.rb

@@ -127,11 +127,11 @@ module Inum
       defined_enums.dup
     end
 
-    # Parse Object to Enum.
+    # Parse Object to Enum.(unsafe:An exception may occur.)
     #
     # @param object [Object] string or symbol or integer or Inum::Base.
-    # @return [Inum::Base] instance of Inum::Base.
-    def self.parse(object)
+    # @return [Inum::Base] instance of Inum::Base. or raise Exception.
+    def self.parse!(object)
       case object
         when String
           self.const_get(object)
@@ -146,6 +146,26 @@ module Inum
       end
     end
 
+    # Parse Object to Enum.
+    #
+    # @param object [Object] string or symbol or integer or Inum::Base.
+    # @return [Inum::Base] instance of Inum::Base. or nil.
+    def self.parse(object)
+      case object
+        when String
+          return nil unless labels.include?(object.to_sym)
+        when Symbol
+          return nil unless labels.include?(object)
+        when Integer
+          return nil unless values.include?(object)
+        when self
+          # do nothing.
+        else
+          return nil
+      end
+      parse!(object)
+    end
+
     # get all values of Enum.
     #
     # @return [Array<Integer>] all values of Enum.

data/lib/inum/version.rb

@@ -1,3 +1,3 @@
 module Inum
-  VERSION = "2.0.5"
+  VERSION = "2.1.0"
 end

data/spec/inum/base_spec.rb

@@ -187,6 +187,14 @@ describe Inum::Base do
       expect( @enum::parse(@enum::REDBULL) ).to eq( @enum::REDBULL )
     end
 
+    it 'parse return nil from a unknown value.' do
+      expect( @enum::parse('hoge') ).to eq( nil )
+    end
+
+    it 'parse! raise exception from a unknown value.' do
+      expect{ @enum::parse!('hoge') }.to raise_error( NameError )
+    end
+
     it 'values return Array<Integer>.' do
       expect(@enum::values.length).to eq(3)
       expect(@enum::values.instance_of?(Array)).to be_true

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inum
 version: !ruby/object:Gem::Version
-  version: 2.0.5
+  version: 2.1.0
 platform: ruby
 authors:
 - alfa-jpn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-10 00:00:00.000000000 Z
+date: 2013-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler