ruby-ulid 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 358b03a503f8a12c87f3f7daaf3b0acf6e55dc44f1aba7a38b9f9a38985c2c68
-  data.tar.gz: 15d25d443f4826b07fc9a74b092e35b9cd60dc34cc3615f03fee619d4fc39445
+  metadata.gz: 7b50cb3fee0b304a62ebd460e7d08b932d3c58c1f7810a1dc24b5166df10ceaf
+  data.tar.gz: b84a2ad766640fa7c87e4bbb5b0fdd637bf831407f235989cdd043ea5b1189aa
 SHA512:
-  metadata.gz: 5b18d13597bd2f3dcd85a15a26d9086fb9a80b91775292c9da82d93144b6abd37585996f1bf64dfc4ac12b6d6d49683012dfea8e04624005358459667864114c
-  data.tar.gz: d987aa9b60717577fae96eef68fca76b2395f11a580df4863a69dd0931d955e4cf68608c101959db18f5e3a26031fbe284ff90a0d107fa84bbebb63949bba66b
+  metadata.gz: e44eadac5ad4c83f1c8da74fbfa502a3b3b7293dda8eb44855bb477070687afd815d46237a9cc15266223f7cd0981b69670165767b366156d23728cdb76c878e
+  data.tar.gz: 349b2e8c2b16d5c9ae58270fdb5e87a3c364eef4b3ae2972680cb5de119ba737ed035db36bb7283fc96ff7c7a54663be5de8c0725e0de1975d8f66de34dd052c

data/README.md

@@ -8,7 +8,7 @@
 [ulid/spec](https://github.com/ulid/spec) is useful.
 Especially possess all `uniqueness`, `randomness`, `extractable timestamps` and `sortable` features.  
 This gem aims to provide the generator, monotonic generator, parser and handy manipulation features around ULID.  
-Also providing [ruby/rbs](https://github.com/ruby/rbs) signatures.
+Also providing [RBS](https://github.com/ruby/rbs) signatures.
 
 ---
 
@@ -47,21 +47,43 @@ $ gem install ruby-ulid
 Should be installed!
 ```
 
-Add this line to your Gemfile`.
+Add this line in your Gemfile.
 
 ```ruby
-gem('ruby-ulid', '~> 0.2.2')
+gem('ruby-ulid', '~> 0.4.0')
 ```
 
-### Generator and Parser
-
-The generated `ULID` is an object not just a string.
-It means easily get the timestamps and binary formats.
+### How to use
 
 ```ruby
 require 'ulid'
 
+defined? ULID
+# => "constant"
+```
+
+### Basic Generator
+
+The generated `ULID` is an object not just a string.
+
+```ruby
 ulid = ULID.generate #=> ULID(2021-04-27 17:27:22.826 UTC: 01F4A5Y1YAQCYAYCTC7GRMJ9AA)
+```
+
+### Parser
+
+You can get the objects from exists encoded ULIDs.
+
+```ruby
+ulid = ULID.parse('01ARZ3NDEKTSV4RRFFQ69G5FAV') #=> ULID(2016-07-30 23:54:10.259 UTC: 01ARZ3NDEKTSV4RRFFQ69G5FAV)
+```
+
+### ULID object
+
+You can extract timestamps and binary formats.
+
+```ruby
+ulid = ULID.parse('01F4A5Y1YAQCYAYCTC7GRMJ9AA') #=> ULID(2021-04-27 17:27:22.826 UTC: 01F4A5Y1YAQCYAYCTC7GRMJ9AA)
 ulid.to_time #=> 2021-04-27 17:27:22.826 UTC
 ulid.milliseconds #=> 1619544442826
 ulid.to_s #=> "01F4A5Y1YAQCYAYCTC7GRMJ9AA"
@@ -71,16 +93,9 @@ ulid.to_i #=> 1957909092946624190749577070267409738
 ulid.octets #=> [1, 121, 20, 95, 7, 202, 187, 60, 175, 51, 76, 60, 49, 73, 37, 74]
 ```
 
-You can get the objects from exists encoded ULIDs
-
-```ruby
-ulid = ULID.parse('01ARZ3NDEKTSV4RRFFQ69G5FAV') #=> ULID(2016-07-30 23:54:10.259 UTC: 01ARZ3NDEKTSV4RRFFQ69G5FAV)
-ulid.to_time #=> 2016-07-30 23:54:10.259 UTC
-```
-
 ### Sortable with the timestamp
 
-ULIDs are sortable when they are generated in different timestamp with milliseconds precision
+ULIDs are sortable when they are generated in different timestamp with milliseconds precision.
 
 ```ruby
 ulids = 1000.times.map do
@@ -91,7 +106,7 @@ ulids.uniq(&:to_time).size #=> 1000
 ulids.sort == ulids #=> true
 ```
 
-`ULID.generate` can take fixed `Time` instance. The shorthand is `ULID.at`
+`ULID.generate` can take fixed `Time` instance. The shorthand is `ULID.at`.
 
 ```ruby
 time = Time.at(946684800).utc #=> 2000-01-01 00:00:00 UTC
@@ -147,11 +162,11 @@ sample_ulids_by_the_time.take(5) #=>
 ulids.sort == ulids #=> true
 ```
 
-Same generator does not generate duplicated ULIDs even in multi threads environment. It is implemented with [Monitor](https://bugs.ruby-lang.org/issues/16255)
+Same generator does not generate duplicated ULIDs even in multi threads environment. It is implemented with [Monitor](https://bugs.ruby-lang.org/issues/16255).
 
 ### Filtering IDs with `Time`
 
-`ULID` can be element of the `Range`. If you generated the IDs in monotonic generator, ID based filtering is easy and reliable
+`ULID` can be element of the `Range`. If they were generated with monotonic generator, ID based filtering is easy and reliable.
 
 ```ruby
 include_end = ulid1..ulid2
@@ -187,7 +202,9 @@ time = Time.at(946684800, Rational('123456.789')).utc #=> 2000-01-01 00:00:00.12
 ULID.floor(time) #=> 2000-01-01 00:00:00.123 UTC
 ```
 
-### Scanner for string (e.g. `JSON`)
+### Some methods to help manipulations
+
+#### Scanner for string (e.g. `JSON`)
 
 For rough operations, `ULID.scan` might be useful.
 
@@ -230,7 +247,7 @@ ULID.scan(json).to_a
 ```
 
 `ULID#patterns` is a util for text based operations.
-The results and spec are not fixed. Should not be used except snippets/console operation
+The results and spec are not fixed. Should not be used except snippets/console operation.
 
 ```ruby
 ULID.parse('01F4GNBXW1AM2KWW52PVT3ZY9X').patterns
@@ -241,7 +258,7 @@ ULID.parse('01F4GNBXW1AM2KWW52PVT3ZY9X').patterns
 }
 ```
 
-### Some methods to help manipulations
+#### Get boundary ULIDs
 
 `ULID.min` and `ULID.max` return termination values for ULID spec.
 
@@ -256,10 +273,12 @@ ULID.min(time) #=> ULID(2000-01-01 00:00:00.123 UTC: 00VHNCZB3V0000000000000000)
 ULID.max(time) #=> ULID(2000-01-01 00:00:00.123 UTC: 00VHNCZB3VZZZZZZZZZZZZZZZZ)
 ```
 
+#### As element in Enumerable
+
 `ULID#next` and `ULID#succ` returns next(successor) ULID.
 Especially `ULID#succ` makes it possible `Range[ULID]#each`.
 
-NOTE: But basically `Range[ULID]#each` should not be used, incrementing 128 bits IDs are not reasonable operation in most case
+NOTE: However basically `Range[ULID]#each` should not be used. Iincrementing 128 bits IDs are not reasonable operation in most cases.
 
 ```ruby
 ULID.parse('01BX5ZZKBKZZZZZZZZZZZZZZZY').next.to_s #=> "01BX5ZZKBKZZZZZZZZZZZZZZZZ"
@@ -267,7 +286,7 @@ ULID.parse('01BX5ZZKBKZZZZZZZZZZZZZZZZ').next.to_s #=> "01BX5ZZKBM00000000000000
 ULID.parse('7ZZZZZZZZZZZZZZZZZZZZZZZZZ').next #=> nil
 ```
 
-`ULID#pred` returns predecessor ULID
+`ULID#pred` returns predecessor ULID.
 
 ```ruby
 ULID.parse('01BX5ZZKBK0000000000000001').pred.to_s #=> "01BX5ZZKBK0000000000000000"
@@ -275,6 +294,8 @@ ULID.parse('01BX5ZZKBK0000000000000000').pred.to_s #=> "01BX5ZZKBJZZZZZZZZZZZZZZ
 ULID.parse('00000000000000000000000000').pred #=> nil
 ```
 
+#### Test helpers
+
 `ULID.sample` returns random ULIDs.
 
 Basically ignores generating time.
@@ -300,33 +321,23 @@ ulid1 = ULID.parse('01F4A5Y1YAQCYAYCTC7GRMJ9AA') #=> ULID(2021-04-27 17:27:22.82
 ulid2 = ULID.parse('01F4PTVCSN9ZPFKYTY2DDJVRK4') #=> ULID(2021-05-02 15:23:48.917 UTC: 01F4PTVCSN9ZPFKYTY2DDJVRK4)
 ulids = ULID.sample(1000, period: ulid1..ulid2)
 ulids.uniq.size #=> 1000
-ulids.take(10)
+ulids.take(5)
 #=>
 #[ULID(2021-05-02 06:57:19.954 UTC: 01F4NXW02JNB8H0J0TK48JD39X),
 # ULID(2021-05-02 07:06:07.458 UTC: 01F4NYC372GVP7NS0YAYQGT4VZ),
 # ULID(2021-05-01 06:16:35.791 UTC: 01F4K94P6F6P68K0H64WRDSFKW),
 # ULID(2021-04-27 22:17:37.844 UTC: 01F4APHGSMFJZQTGXKZBFFBPJP),
-# ULID(2021-04-28 20:17:55.357 UTC: 01F4D231MXQJXAR8G2JZHEJNH3),
-# ULID(2021-04-30 07:18:54.307 UTC: 01F4GTA2332AS2VPHC4FMKC7R5),
-# ULID(2021-05-02 12:26:03.480 UTC: 01F4PGNXARG554Y3HYVBDW4T9S),
-# ULID(2021-04-29 09:52:15.107 UTC: 01F4EGP483ZX2747FQPWQNPPMW),
-# ULID(2021-04-29 03:18:24.152 UTC: 01F4DT4Z4RA0QV8WFQGRAG63EH),
-# ULID(2021-05-02 13:27:16.394 UTC: 01F4PM605ABF5SDVMEHBH8JJ9R)]
-ULID.sample(10, period: ulid1.to_time..ulid2.to_time)
+# ULID(2021-04-28 20:17:55.357 UTC: 01F4D231MXQJXAR8G2JZHEJNH3)]
+ULID.sample(5, period: ulid1.to_time..ulid2.to_time)
 #=>
 # [ULID(2021-04-29 06:44:41.513 UTC: 01F4E5YPD9XQ3MYXWK8ZJKY8SW),
 #  ULID(2021-05-01 00:35:06.629 UTC: 01F4JNKD85SVK1EAEYSJGF53A2),
 #  ULID(2021-05-02 12:45:28.408 UTC: 01F4PHSEYRG9BWBEWMRW1XE6WW),
 #  ULID(2021-05-01 03:06:09.130 UTC: 01F4JY7ZBABCBMX16XH2Q4JW4W),
-#  ULID(2021-04-29 21:38:58.109 UTC: 01F4FS45DX4049JEQK4W6TER6G),
-#  ULID(2021-04-29 17:14:14.116 UTC: 01F4F9ZDQ449BE8BBZFEHYQWG2),
-#  ULID(2021-04-30 16:18:08.205 UTC: 01F4HS5DPD1HWDVJNJ6YKJXKSK),
-#  ULID(2021-04-30 10:31:33.602 UTC: 01F4H5ATF2A1CSQF0XV5NKZ288),
-#  ULID(2021-04-28 16:49:06.484 UTC: 01F4CP4PDM214Q6H3KJP7DYJRR),
-#  ULID(2021-04-28 15:05:06.808 UTC: 01F4CG68ZRST94T056KRZ5K9S4)]
+#  ULID(2021-04-29 21:38:58.109 UTC: 01F4FS45DX4049JEQK4W6TER6G)]
 ```
 
-### ULID specification ambiguity around orthographical variants of the format
+#### Variants of format
 
 I'm afraid so, we should consider [Current ULID spec](https://github.com/ulid/spec/tree/d0c7170df4517939e70129b4d6462cc162f2d5bf#universally-unique-lexicographically-sortable-identifier) has `orthographical variants of the format` possibilities.
 
@@ -354,7 +365,7 @@ ULID.normalized?('-olarz3-noekisv4rrff-q6ig5fav--') #=> false
 ULID.normalized?('01ARZ3N0EK1SV4RRFFQ61G5FAV') #=> true
 ```
 
-### UUIDv4 converter for migration use-cases
+#### UUIDv4 converter for migration use-cases
 
 `ULID.from_uuidv4` and `ULID#to_uuidv4` is the converter.
 The imported timestamp is meaningless. So ULID's benefit will lost.
@@ -442,7 +453,7 @@ The results are not something to be proud of.
 
 See structure at [examples/rbs_sandbox](https://github.com/kachick/ruby-ulid/tree/main/examples/rbs_sandbox)
 
-I have checked the behavior with [ruby/rbs@2.6.0](https://github.com/ruby/rbs) && [soutaro/steep@1.0.1](https://github.com/soutaro/steep) &&  [soutaro/steep-vscode](https://github.com/soutaro/steep-vscode).
+I have checked the behavior with [ruby/rbs@2.6.0](https://github.com/ruby/rbs) + [soutaro/steep@1.0.1](https://github.com/soutaro/steep) +  [soutaro/steep-vscode](https://github.com/soutaro/steep-vscode).
 
 * ![rbs overview](./assets/ulid-rbs-overview.png?raw=true.png)
 * ![rbs mix](./assets/ulid-rbs-mix.png?raw=true.png)

data/lib/ruby-ulid.rb

@@ -1,5 +1,6 @@
 # coding: us-ascii
 # frozen_string_literal: true
+# shareable_constant_value: literal
 
 # Copyright (C) 2021 Kenichi Kamiya
 

data/lib/ulid/crockford_base32.rb

@@ -1,5 +1,6 @@
 # coding: us-ascii
 # frozen_string_literal: true
+# shareable_constant_value: literal
 
 # Copyright (C) 2021 Kenichi Kamiya
 

data/lib/ulid/monotonic_generator.rb

@@ -1,10 +1,13 @@
 # coding: us-ascii
 # frozen_string_literal: true
+# shareable_constant_value: literal
 
 # Copyright (C) 2021 Kenichi Kamiya
 
 class ULID
   class MonotonicGenerator
+    # @note When use https://github.com/ko1/ractor-tvar might realize Ractor based thread safe monotonic generator.
+    #       However it is a C extention, I'm pending to use it for now.
     include(MonitorMixin)
 
     # @dynamic prev

data/lib/ulid/ractor_unshareable_constants.rb

@@ -0,0 +1,12 @@
+# coding: us-ascii
+# frozen_string_literal: true
+
+class ULID
+  min = parse('00000000000000000000000000').freeze
+  max = parse('7ZZZZZZZZZZZZZZZZZZZZZZZZZ').freeze
+
+  ractor_can_make_shareable_time = RUBY_VERSION >= '3.1'
+
+  MIN = ractor_can_make_shareable_time ? Ractor.make_shareable(min) : min
+  MAX = ractor_can_make_shareable_time ? Ractor.make_shareable(max) : max
+end

data/lib/ulid/uuid.rb

@@ -1,5 +1,6 @@
 # coding: us-ascii
 # frozen_string_literal: true
+# shareable_constant_value: literal
 
 # Copyright (C) 2021 Kenichi Kamiya
 

data/lib/ulid/version.rb

@@ -1,6 +1,7 @@
 # coding: us-ascii
 # frozen_string_literal: true
+# shareable_constant_value: literal
 
 class ULID
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

data/lib/ulid.rb

@@ -1,5 +1,6 @@
 # coding: us-ascii
 # frozen_string_literal: true
+# shareable_constant_value: experimental_everything
 
 # Copyright (C) 2021 Kenichi Kamiya
 
@@ -42,8 +43,7 @@ class ULID
   STRICT_PATTERN_WITH_CROCKFORD_BASE32_SUBSET = /\A#{PATTERN_WITH_CROCKFORD_BASE32_SUBSET.source}\z/i.freeze
 
   # Optimized for `ULID.scan`, might be changed the definition with gathered `ULID.scan` spec changed.
-  # This can't contain `\b` for considering UTF-8 (e.g. Japanese), so intentional `false negative` definition.
-  SCANNING_PATTERN = /[0-7][#{CROCKFORD_BASE32_ENCODING_STRING}]{#{TIMESTAMP_ENCODED_LENGTH - 1}}[#{CROCKFORD_BASE32_ENCODING_STRING}]{#{RANDOMNESS_ENCODED_LENGTH}}/i.freeze
+  SCANNING_PATTERN = /\b[0-7][#{CROCKFORD_BASE32_ENCODING_STRING}]{#{TIMESTAMP_ENCODED_LENGTH - 1}}[#{CROCKFORD_BASE32_ENCODING_STRING}]{#{RANDOMNESS_ENCODED_LENGTH}}\b/i.freeze
 
   # Similar as Time#inspect since Ruby 2.7, however it is NOT same.
   # Time#inspect trancates needless digits. Keeping full milliseconds with "%3N" will fit for ULID.
@@ -83,7 +83,7 @@ class ULID
 
   RANDOM_INTEGER_GENERATOR = -> {
     SecureRandom.random_number(MAX_INTEGER)
-  }
+  }.freeze
 
   # @param [Range<Time>, Range<nil>, Range[ULID], nil] period
   # @overload sample(number, period: nil)
@@ -231,9 +231,9 @@ class ULID
   # @api private
   # @param [Time] time
   # @return [Integer]
-  private_class_method(def self.milliseconds_from_time(time)
+  private_class_method def self.milliseconds_from_time(time)
     (time.to_r * 1000).to_i
-  end)
+  end
 
   # @api private
   # @param [Time, Integer] moment
@@ -250,9 +250,9 @@ class ULID
   end
 
   # @return [Integer]
-  private_class_method(def self.reasonable_entropy
+  private_class_method def self.reasonable_entropy
     SecureRandom.random_number(MAX_ENTROPY)
-  end)
+  end
 
   # @param [String, #to_str] string
   # @return [ULID]
@@ -316,7 +316,7 @@ class ULID
 
   # @param [BasicObject] object
   # @return [String]
-  private_class_method(def self.safe_get_class_name(object)
+  private_class_method def self.safe_get_class_name(object)
     fallback = 'UnknownObject'
 
     # This class getter implementation used https://github.com/rspec/rspec-support/blob/4ad8392d0787a66f9c351d9cf6c7618e18b3d0f2/lib/rspec/support.rb#L83-L89 as a reference, thank you!
@@ -325,7 +325,7 @@ class ULID
       begin
         object.class
       rescue NoMethodError
-        # steep can't correctly handle singeton class assign. See https://github.com/soutaro/steep/pull/586 for further detail
+        # steep can't correctly handle singleton class assign. See https://github.com/soutaro/steep/pull/586 for further detail
         # So this annotation is hack for the type infer.
         # @type var object: BasicObject
         # @type var singleton_class: untyped
@@ -341,7 +341,7 @@ class ULID
     else
       name || fallback
     end
-  end)
+  end
 
   # @api private
   # @param [Integer] milliseconds
@@ -409,13 +409,26 @@ class ULID
   # @dynamic ==
   alias_method(:==, :eql?)
 
+  # Return `true` for same value of ULID, variant formats of strings, same Time in ULID precision(msec).
+  # Do not consider integer, octets and partial strings, then returns `false`.
+  #
   # @return [Boolean]
+  # @see .normalize
+  # @see .floor
   def ===(other)
     case other
     when ULID
       @integer == other.to_i
     when String
-      to_s == other.upcase
+      begin
+        normalized = ULID.normalize(other)
+      rescue Exception
+        false
+      else
+        to_s == normalized
+      end
+    when Time
+      to_time == ULID.floor(other)
     else
       false
     end
@@ -546,10 +559,9 @@ end
 require_relative('ulid/version')
 require_relative('ulid/crockford_base32')
 require_relative('ulid/monotonic_generator')
+require_relative('ulid/ractor_unshareable_constants')
 
 class ULID
-  MIN = parse('00000000000000000000000000').freeze
-  MAX = parse('7ZZZZZZZZZZZZZZZZZZZZZZZZZ').freeze
-
+  # Do not write as `ULID.private_constant` for avoiding YARD warnings `[warn]: in YARD::Handlers::Ruby::PrivateConstantHandler: Undocumentable private constants:`
   private_constant(:TIME_FORMAT_IN_INSPECT, :MIN, :MAX, :RANDOM_INTEGER_GENERATOR, :CROCKFORD_BASE32_ENCODING_STRING)
 end

data/sig/ulid.rbs

@@ -292,30 +292,20 @@ class ULID < Object
   # ulid2 = ULID.parse('01F4PTVCSN9ZPFKYTY2DDJVRK4') #=> ULID(2021-05-02 15:23:48.917 UTC: 01F4PTVCSN9ZPFKYTY2DDJVRK4)
   # ulids = ULID.sample(1000, period: ulid1..ulid2)
   # ulids.uniq.size #=> 1000
-  # ulids.take(10)
+  # ulids.take(5)
   # #=>
   # #[ULID(2021-05-02 06:57:19.954 UTC: 01F4NXW02JNB8H0J0TK48JD39X),
   # # ULID(2021-05-02 07:06:07.458 UTC: 01F4NYC372GVP7NS0YAYQGT4VZ),
   # # ULID(2021-05-01 06:16:35.791 UTC: 01F4K94P6F6P68K0H64WRDSFKW),
   # # ULID(2021-04-27 22:17:37.844 UTC: 01F4APHGSMFJZQTGXKZBFFBPJP),
-  # # ULID(2021-04-28 20:17:55.357 UTC: 01F4D231MXQJXAR8G2JZHEJNH3),
-  # # ULID(2021-04-30 07:18:54.307 UTC: 01F4GTA2332AS2VPHC4FMKC7R5),
-  # # ULID(2021-05-02 12:26:03.480 UTC: 01F4PGNXARG554Y3HYVBDW4T9S),
-  # # ULID(2021-04-29 09:52:15.107 UTC: 01F4EGP483ZX2747FQPWQNPPMW),
-  # # ULID(2021-04-29 03:18:24.152 UTC: 01F4DT4Z4RA0QV8WFQGRAG63EH),
-  # # ULID(2021-05-02 13:27:16.394 UTC: 01F4PM605ABF5SDVMEHBH8JJ9R)]
+  # # ULID(2021-04-28 20:17:55.357 UTC: 01F4D231MXQJXAR8G2JZHEJNH3)]
   # ULID.sample(10, period: ulid1.to_time..ulid2.to_time)
   # #=>
   # # [ULID(2021-04-29 06:44:41.513 UTC: 01F4E5YPD9XQ3MYXWK8ZJKY8SW),
   # #  ULID(2021-05-01 00:35:06.629 UTC: 01F4JNKD85SVK1EAEYSJGF53A2),
   # #  ULID(2021-05-02 12:45:28.408 UTC: 01F4PHSEYRG9BWBEWMRW1XE6WW),
   # #  ULID(2021-05-01 03:06:09.130 UTC: 01F4JY7ZBABCBMX16XH2Q4JW4W),
-  # #  ULID(2021-04-29 21:38:58.109 UTC: 01F4FS45DX4049JEQK4W6TER6G),
-  # #  ULID(2021-04-29 17:14:14.116 UTC: 01F4F9ZDQ449BE8BBZFEHYQWG2),
-  # #  ULID(2021-04-30 16:18:08.205 UTC: 01F4HS5DPD1HWDVJNJ6YKJXKSK),
-  # #  ULID(2021-04-30 10:31:33.602 UTC: 01F4H5ATF2A1CSQF0XV5NKZ288),
-  # #  ULID(2021-04-28 16:49:06.484 UTC: 01F4CP4PDM214Q6H3KJP7DYJRR),
-  # #  ULID(2021-04-28 15:05:06.808 UTC: 01F4CG68ZRST94T056KRZ5K9S4)]
+  # #  ULID(2021-04-29 21:38:58.109 UTC: 01F4FS45DX4049JEQK4W6TER6G)]
   # ```
   def self.sample: (?period: period) -> ULID
                  | (Integer number, ?period: period?) -> Array[ULID]
@@ -436,9 +426,28 @@ class ULID < Object
   # ULID.parse('4NNB20D9C1ME2NGMTX51ERZJX0') == ULID.parse('4nnb20d9c1me2ngmtx51erzjx0')
   # #=> true
   # ```
-  def eql?: (untyped other) -> bool
+  def eql?: (ULID other) -> bool
+          | (untyped other) -> false
   alias == eql?
-  def ===: (untyped other) -> bool
+
+  # Return `true` for same value of ULID, variant formats of strings, same Time in ULID precision(msec).
+  # Do not consider integer, octets and partial strings, then returns `false`.
+  #
+  # ```ruby
+  # ulid = ULID.parse('01G6Z7Q4RSH97E6QHAC7VK19G2')
+  # ulid === ULID.parse(ulid.to_s)
+  # #=> true
+  # ulid === ulid.to_s.downcase
+  # #=> true
+  # ulid === ulid.to_time
+  # #=> true
+  # ulid === ulid.to_i
+  # #=> false
+  # ulid === ulid.next
+  # #=> false
+  # ```
+  def ===: (ULID | String | Time other) -> bool
+         | (untyped other) -> false
 
   # ```ruby
   # ulid = ULID.generate

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: ruby-ulid
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Kenichi Kamiya
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-22 00:00:00.000000000 Z
+date: 2022-07-02 00:00:00.000000000 Z
 dependencies: []
 description: "    generator, monotonic generator, parser and manipulations for ULID
-  (ruby/rbs signatures included)\n"
+  (RBS included)\n"
 email:
 - kachick1+ruby@gmail.com
 executables: []
@@ -24,6 +24,7 @@ files:
 - lib/ulid.rb
 - lib/ulid/crockford_base32.rb
 - lib/ulid/monotonic_generator.rb
+- lib/ulid/ractor_unshareable_constants.rb
 - lib/ulid/uuid.rb
 - lib/ulid/version.rb
 - sig/ulid.rbs