youyouaidi-revised 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0d00be139d3bf97f8c7e3dacd0877003cd2eb582c8ce08397dcd12a4f7dc7df7
+  data.tar.gz: 6b0a86e0cb1a3e1e416a3167fa00a0fcb99f2f8b4bab381f48def1fda72daa8e
+SHA512:
+  metadata.gz: b1c691c8e485b3954e1bc79316f70147c9207b56ff378ab1eaceba6faf06f478b7dcc51b866b884098e053b463baef709471206ec8501764f30245d5e119e747
+  data.tar.gz: b7049ffa8d4c7c805b0edc1426ff63dc5fe3d60a70389f333967fd6086346dfc94374cf034888f3e739a4d99a3dd171e545bca062a367eb328cc6b2ba7d743e8

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--backtrace

data/.rubocop.yml

@@ -0,0 +1,80 @@
+# .rubocop.yml
+AllCops:
+  TargetRubyVersion: 2.7
+
+Style/Documentation:
+  Enabled: false
+
+
+Gemspec/DateAssignment: # (new in 1.10)
+  Enabled: true
+Layout/LineEndStringConcatenationIndentation: # (new in 1.18)
+  Enabled: true
+Layout/SpaceBeforeBrackets: # (new in 1.7)
+  Enabled: true
+Lint/AmbiguousAssignment: # (new in 1.7)
+  Enabled: true
+Lint/DeprecatedConstants: # (new in 1.8)
+  Enabled: true
+Lint/DuplicateBranch: # (new in 1.3)
+  Enabled: true
+Lint/DuplicateRegexpCharacterClassElement: # (new in 1.1)
+  Enabled: true
+Lint/EmptyBlock: # (new in 1.1)
+  Enabled: true
+Lint/EmptyClass: # (new in 1.3)
+  Enabled: true
+Lint/EmptyInPattern: # (new in 1.16)
+  Enabled: true
+Lint/LambdaWithoutLiteralBlock: # (new in 1.8)
+  Enabled: true
+Lint/NoReturnInBeginEndBlocks: # (new in 1.2)
+  Enabled: true
+Lint/NumberedParameterAssignment: # (new in 1.9)
+  Enabled: true
+Lint/OrAssignmentToConstant: # (new in 1.9)
+  Enabled: true
+Lint/RedundantDirGlobSort: # (new in 1.8)
+  Enabled: true
+Lint/SymbolConversion: # (new in 1.9)
+  Enabled: true
+Lint/ToEnumArguments: # (new in 1.1)
+  Enabled: true
+Lint/TripleQuotes: # (new in 1.9)
+  Enabled: true
+Lint/UnexpectedBlockArity: # (new in 1.5)
+  Enabled: true
+Lint/UnmodifiedReduceAccumulator: # (new in 1.1)
+  Enabled: true
+Naming/InclusiveLanguage: # (new in 1.18)
+  Enabled: true
+Style/ArgumentsForwarding: # (new in 1.1)
+  Enabled: true
+Style/CollectionCompact: # (new in 1.2)
+  Enabled: true
+Style/DocumentDynamicEvalDefinition: # (new in 1.1)
+  Enabled: true
+Style/EndlessMethod: # (new in 1.8)
+  Enabled: true
+Style/HashConversion: # (new in 1.10)
+  Enabled: true
+Style/HashExcept: # (new in 1.7)
+  Enabled: true
+Style/IfWithBooleanLiteralBranches: # (new in 1.9)
+  Enabled: true
+Style/InPatternThen: # (new in 1.16)
+  Enabled: true
+Style/MultilineInPatternThen: # (new in 1.16)
+  Enabled: true
+Style/NegatedIfElseCondition: # (new in 1.2)
+  Enabled: true
+Style/NilLambda: # (new in 1.3)
+  Enabled: true
+Style/QuotedSymbols: # (new in 1.16)
+  Enabled: true
+Style/RedundantArgument: # (new in 1.4)
+  Enabled: true
+Style/StringChars: # (new in 1.12)
+  Enabled: true
+Style/SwapValues: # (new in 1.1)
+  Enabled: true

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+rvm:
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3
+  - jruby-19mode
+  - rbx
+  - ruby-head
+  - jruby-head

data/Gemfile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+group :test do
+  gem 'coveralls', require: false
+  gem 'pry'
+  gem 'rake', '~> 10.1'
+  gem 'rspec'
+  gem 'rspec-collection_matchers'
+  gem 'rspec-its'
+end
+
+# Specify your gem's dependencies in youyouaidi.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Nicolas Fricke
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,111 @@
+# Youyouaidi revised
+
+`Youyouaidi revised` is a Ruby Gem that offers a UUID class for **generating**, **parsing**, **validating** and **converting** UUIDs into / from **shorter representations**.
+
+This gem is a fork of the unmaintained repo at http://github.com/nicolas-fricke/youyouaidi. Many thanks to the original author! 😊
+
+While a **UUID consists of 36 characters** – 32 hexadecimal characters, divided by four dashes into five subgroups – the **short representation** (invoked via `#to_short_string`) consists of exactly **22 digit and lower- and uppercase characters**.
+
+This is what a valid, random (version 4) UUID looks like:
+```
+                          version    either 8, 9
+                           number    a, or b
+                                ▼    ▼
+                  caed3f49-b0ca-454b-adf8-5ee2a1764759
+# chars in group:     8   | 4  | 4  | 4  |    12
+```
+As shown, the first digit of the third group indicates the UUID version.
+The first digit of the fourth group always has to be one of either `8`, `9`, `a`, or `b`.
+All other digits are randomly assigned hexadecimals.
+
+And this is the same UUID in its short format: `6aUS5foeLu2VGDspRPc7bz`.
+
+For UUID generation, the `SecureRandom.uuid` method is used which generates valid, random *version 4* UUIDs.
+
+Find out more about UUIDs and the different versions on [Wikipedia](https://en.wikipedia.org/wiki/Uuid).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'youyouaidi-revised'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install youyouaidi-revised
+
+## Usage
+
+`UUID(...)` **was** patched in the kernel. Not anymore. We don't patch the kernel unless we have no other choice.
+
+### Initializing UUIDs
+
+```ruby
+uuid_string = '550e8400-e29b-41d4-a716-446655440000' # A valid UUID in string format, has exactly 32 hexadecimal characters in 5 groups
+uuid_short  = '2AuYQJcZeiIeCymkJ7tzTW'               # Same UUID in its short format, has exactly 22 characters of [0-9a-zA-Z]
+
+uuid = Youyouaidi::UUID uuid_string   # creates new Youyouaidi::UUID object
+# => #<Youyouaidi::UUID:0x000001021f2590 @converter=Youyouaidi::Converter, @uuid="550e8400-e29b-41d4-a716-446655440000">
+
+# Alternatively a short UUID can be passed:
+uuid = Youyouaidi::UUID uuid_short    # creates similar Youyouaidi::UUID object
+# => #<Youyouaidi::UUID:0x00000102201b80 @converter=Youyouaidi::Converter, @uuid="550e8400-e29b-41d4-a716-446655440000">
+
+# To generate a new random UUID simply do not pass a parameter:
+new_uuid = Youyouaidi::UUID.new       # generates a random UUID version 4 using the SecureRandom.uuid method
+# => #<Youyouaidi::UUID:0x00000102201b80 @converter=Youyouaidi::Converter, @uuid="27f8bc29-be8e-4dc7-ab30-0295b2a5e902">
+```
+
+
+### Validity check and conversions
+
+The validity check `Youyouaidi::UUID.valid? uuid_string` checks, if UUID contains exactly 32 hexadecimal characters which are divided by four dashes ('-') into five groups of sizes 8, 4, 4, 4, and 12.
+Also, it validates that the first character of the fourth group is either a `8`, `9`, an `a`, or a `b`.
+
+```ruby
+uuid_string = '550e8400-e29b-41d4-a716-446655440000' # A valid UUID in string format
+uuid = Youyouaidi::UUID uuid_string
+
+Youyouaidi::UUID.valid? uuid_string # Checks if `uuid_string' is a valid UUID, same as Youyouaidi::UUID.valid? uuid_string
+# => true
+
+uuid.to_s               # Returns the string representation of the UUID object
+# => '550e8400-e29b-41d4-a716-446655440000'
+
+uuid.to_short_string    # Returns the short string representation of the UUID object, #to_param is an alias for this method
+# => '2AuYQJcZeiIeCymkJ7tzTW'
+```
+
+
+### Comparing UUIDs
+
+```ruby
+uuid_string  = '550e8400-e29b-41d4-a716-446655440000' # A valid UUID in string format
+uuid         = Youyouaidi::UUID.parse uuid_string
+similar_uuid = Youyouaidi::UUID.parse uuid_string
+other_uuid   = Youyouaidi::UUID.parse '00000000-1111-2222-aaaa-eeeeeeeeeeee'
+
+uuid == similar_uuid # Two UUID objects representing same UUID (#=== behaves similar for this)
+# => true
+
+uuid == other_uuid   # Two UUID objects representing different UUIDs (#=== behaves similar for this)
+# => false
+
+uuid == uuid_string  # Comparing a UUID object and its string representation with `=='
+# => false
+
+uuid === uuid_string # Comparing a UUID object and its string representation with `===' (case insensetive)
+# => true
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/lorankloeze/youyouaidi-revised/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task default: :spec

data/lib/youyouaidi/converter.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# Based on Base62 module by sinefunc
+# => https://github.com/sinefunc/base62
+module Youyouaidi
+  class Converter
+    class << self
+      def encode(uuid)
+        base_encode uuid.to_i
+      end
+
+      def decode(encoded_uuid)
+        encoded_uuid = encoded_uuid.to_s
+        unless encoded_uuid.length == ENCODED_LENGTH
+          raise Youyouaidi::InvalidUUIDError,
+                "`#{encoded_uuid}' needs to have exactly #{ENCODED_LENGTH} characters (has #{encoded_uuid.length})"
+        end
+
+        begin
+          Youyouaidi::UUID.new convert_bignum_to_uuid_string base_decode encoded_uuid
+        rescue Youyouaidi::InvalidUUIDError => e
+          raise Youyouaidi::InvalidUUIDError, "`#{encoded_uuid}' could not be decoded to a valid UUID (#{e.message})"
+        end
+      end
+
+      private
+
+      BASE           = ('0'..'9').to_a + ('a'..'z').to_a + ('A'..'Z').to_a
+      ENCODED_LENGTH = 22 # Needs to be greater than `(Math.log 2**128, BASE.length).floor + 1`
+
+      def base_encode(numeric)
+        raise Youyouaidi::InvalidUUIDError, "`#{numeric}' needs to be a Numeric" unless numeric.is_a? Numeric
+
+        return '0' if numeric.zero?
+
+        s = String.new
+
+        while numeric.positive?
+          s << BASE[numeric.modulo(BASE.size)]
+          numeric /= BASE.size
+        end
+        s << BASE[0] while s.length < ENCODED_LENGTH
+        s.reverse
+      end
+
+      def base_decode(encoded_numeric)
+        s = encoded_numeric.to_s.reverse.chars
+
+        total = 0
+        s.each_with_index do |char, index|
+          ord = BASE.index(char)
+          unless ord
+            (raise Youyouaidi::InvalidUUIDError, "`#{encoded_numeric}' has `#{char}' which is not a valid character")
+          end
+
+          total += ord * (BASE.size**index)
+        end
+        total
+      end
+
+      def convert_bignum_to_uuid_string(decoded_uuid_bignum)
+        decoded_uuid = decoded_uuid_bignum.to_i.to_s(16).rjust(32, '0')
+        "#{decoded_uuid[0,
+                        8]}-#{decoded_uuid[8, 4]}-#{decoded_uuid[12, 4]}-#{decoded_uuid[16, 4]}-#{decoded_uuid[20, 12]}"
+      end
+    end
+  end
+end

data/lib/youyouaidi/invalid_uuid.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Youyouaidi
+  class InvalidUUIDError < TypeError
+  end
+end

data/lib/youyouaidi/uuid.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module Youyouaidi
+  # Main class
+  class UUID
+    attr_reader :uuid
+
+    def initialize(uuid_string = nil, options = {})
+      @converter = options[:converter] || Youyouaidi::Converter
+      if uuid_string
+        initialize_with_uuid_string uuid_string
+      else
+        initialize_without_param
+      end
+    end
+
+    def ==(other)
+      return false unless other.is_a? self.class
+
+      to_s == other.to_s
+    end
+
+    def ===(other_object)
+      return true if self == other_object
+
+      to_s == other_object.to_s.downcase
+    end
+
+    def to_i
+      @uuid.gsub('-', '').hex
+    end
+
+    def to_s
+      @uuid
+    end
+
+    def to_short_string
+      @converter.encode self
+    end
+    alias to_param to_short_string
+
+    private
+
+    def initialize_without_param
+      @uuid = SecureRandom.uuid
+    end
+
+    def initialize_with_uuid_string(uuid_string)
+      unless self.class.valid? uuid_string
+        raise Youyouaidi::InvalidUUIDError, "`#{uuid_string}' does not look like a valid UUID"
+      end
+
+      @uuid = uuid_string.to_s.downcase
+    end
+
+    class << self
+      def parse(uuid_param = nil, options = {})
+        @converter = options[:converter] || Youyouaidi::Converter
+        if valid? uuid_param
+          new uuid_param.to_s, options
+        elsif uuid_param.nil?
+          new nil, options
+        else
+          @converter.decode uuid_param
+        end
+      end
+
+      def valid?(uuid_canidate)
+        !(uuid_canidate.to_s =~ /^[\da-f]{8}(-[\da-f]{4}){2}-[89ab][\da-f]{3}-[\da-f]{12}$/i).nil?
+      end
+    end
+  end
+end

data/lib/youyouaidi/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Youyouaidi
+  VERSION = '1.0'
+end

data/lib/youyouaidi.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'youyouaidi/version'
+
+module Youyouaidi
+  # Your code goes here...
+  require 'youyouaidi/uuid'
+  require 'youyouaidi/invalid_uuid'
+  require 'youyouaidi/converter'
+end

data/spec/kernel_patch_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Kernel do
+  describe '.UUID' do
+    it 'is removed' do
+      expect { UUID }.to raise_error(NameError)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'rspec'
+require 'rspec/its'
+require 'rspec/collection_matchers'
+require 'pry'
+
+# Code coverage statistics at coveralls.io: https://coveralls.io/r/nicolas-fricke/youyouaidi
+# Do not generate coverage when using Rubinius, see: https://github.com/lemurheavy/coveralls-public/issues/144
+if ENV['CI'] || (defined?(:RUBY_ENGINE) && RUBY_ENGINE != 'rbx')
+  require 'coveralls'
+  Coveralls.wear! do
+    add_filter 'spec'
+  end
+end
+
+require 'bundler'
+Bundler.require
+
+require 'youyouaidi'
+
+RSpec.configure do |config|
+  # ## Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  # Raise error when using old :should expectation syntax.
+  # config.raise_errors_for_deprecations!
+end

data/spec/youyouaidi/converter_spec.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+# rubocop:disable Metrics/BlockLength
+describe Youyouaidi::Converter do
+  shared_examples_for 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message' do
+    describe 'raises error' do
+      subject { -> { action } }
+      it { should raise_error Youyouaidi::InvalidUUIDError }
+      describe 'error message' do
+        let(:caught_error) do
+          action
+          return nil
+        rescue Youyouaidi::InvalidUUIDError => e
+          return e
+        end
+        subject { caught_error }
+        it { should_not be_nil }
+        its(:message) { should include(*error_message_includes) }
+      end
+    end
+  end
+
+  let(:uuid) { Youyouaidi::UUID.new uuid_string }
+  let(:uuid_string) { '550e8400-e29b-41d4-a716-446655440000' }
+  let(:encoded_uuid) { '2AuYQJcZeiIeCymkJ7tzTW' }
+
+  uuids_with_encoding = {
+    '550e8400-e29b-41d4-a716-446655440000' => '2AuYQJcZeiIeCymkJ7tzTW',
+    '00000000-bbbb-2222-8888-000000000000' => '000001dyObGywDRlcScExy'
+  }
+
+  describe 'use case' do
+    subject { described_class.decode described_class.encode(uuid) }
+
+    it { should be_a Youyouaidi::UUID }
+    its(:to_s) { should eq uuid_string }
+  end
+
+  describe 'methods' do
+    describe '.encode' do
+      subject { described_class.encode uuid }
+
+      uuids_with_encoding.each do |valid_uuid, encoded_uuid|
+        context "for uuid `#{valid_uuid}'" do
+          let(:uuid_string) { valid_uuid }
+          it { should have(22).characters }
+          it { should eq encoded_uuid }
+        end
+      end
+    end
+
+    describe '.decode' do
+      let(:action) { described_class.decode encoded_param }
+
+      context 'with valid param' do
+        subject { action }
+
+        uuids_with_encoding.each do |valid_uuid, encoded_uuid|
+          context "for encoded uuid `#{encoded_uuid}'" do
+            let(:encoded_param) { encoded_uuid }
+            it { should be_a Youyouaidi::UUID }
+            its(:to_s) { should eq valid_uuid }
+          end
+        end
+      end
+
+      context 'with invalid param' do
+        subject { -> { action } }
+        context 'looking correct but converting to a non-valid UUID' do
+          let(:encoded_param) { 'qEsRTcgdJFVugbBqtaEoNf' }
+          let(:decoded_invalid_uuid) { '36bb9153-3a5a-1570-de9d-6faed4f1ceb0' }
+          let(:error_message_includes) { ["`#{encoded_param}'", "`#{decoded_invalid_uuid}'"] }
+          it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+        end
+
+        context 'with invalid characters' do
+          let(:invalid_char) { '_' }
+          let(:encoded_param) { "#{invalid_char}#{encoded_uuid[1..]}" }
+          let(:error_message_includes) { ["`#{encoded_param}'", "`#{invalid_char}'"] }
+          it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+        end
+
+        shared_examples_for 'a call with incorrect param string length' do
+          let(:error_message_includes) { ["`#{encoded_param}'", '22', encoded_param.length.to_s] }
+          it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+        end
+
+        context 'with too long encoded param' do
+          let(:encoded_param) { "#{encoded_uuid}abc" }
+          it_behaves_like 'a call with incorrect param string length'
+        end
+
+        context 'with too short encoded param' do
+          let(:encoded_param) { encoded_uuid[0..-3].to_s }
+          it_behaves_like 'a call with incorrect param string length'
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/BlockLength

data/spec/youyouaidi/uuid_spec.rb

@@ -0,0 +1,261 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+# rubocop:disable Metrics/BlockLength
+describe Youyouaidi::UUID do
+  shared_examples_for 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message' do
+    describe 'raises error' do
+      subject { -> { action } }
+      it { should raise_error Youyouaidi::InvalidUUIDError }
+      describe 'error message' do
+        let(:caught_error) do
+          action
+          return nil
+        rescue Youyouaidi::InvalidUUIDError => e
+          return e
+        end
+        subject { caught_error }
+        it { should_not be_nil }
+        its(:message) { should include(*error_message_includes) }
+      end
+    end
+  end
+
+  describe '.new' do
+    let(:param) { '' }
+    let(:action) { Youyouaidi::UUID.new param }
+    subject { -> { action } }
+
+    context 'without a param' do
+      let(:action) { Youyouaidi::UUID.new }
+      subject { action }
+
+      it { should be_a Youyouaidi::UUID }
+      describe 'having a valid UUID version 4' do
+        subject { action.to_s }
+
+        it { should be_a String }
+        it { should have(36).characters }
+        it { should match(/[\da-f]{8}-[\da-f]{4}-4[\da-f]{3}-[89ab][\da-f]{3}-[\da-f]{12}/i) }
+      end
+    end
+
+    context 'with valid uuid string' do
+      subject { action }
+
+      valid_uuids = %w[550e8400-e29b-41d4-a716-446655440000
+                       00000000-bbbb-2222-8888-000000000000]
+
+      valid_uuids.each do |valid_uuid|
+        context "for uuid `#{valid_uuid}'" do
+          let(:param) { valid_uuid }
+          it { should be_a Youyouaidi::UUID }
+          its(:to_s) { should eq param }
+        end
+      end
+    end
+
+    context 'with valid uuid in short format' do
+      let(:param) { '2AuYQJcZeiIeCymkJ7tzTW' }
+      let(:error_message_includes) { "`#{param}'" }
+      it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+    end
+
+    context 'with invalid uuid string' do
+      let(:param) { 'Kekse' }
+      let(:error_message_includes) { "`#{param}'" }
+      it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+    end
+
+    context 'with non-uuid-string input' do
+      let(:param) { 1234 }
+      let(:error_message_includes) { "`#{param}'" }
+      it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+    end
+  end
+
+  describe '.parse' do
+    let(:param) { '' }
+    let(:action) { Youyouaidi::UUID.parse param }
+    subject { action }
+
+    context 'with valid uuid string' do
+      let(:param) { '550e8400-e29b-41d4-a716-446655440000' }
+
+      it { should be_a Youyouaidi::UUID }
+    end
+
+    context 'with uuid in short format' do
+      let(:param) { '2AuYQJcZeiIeCymkJ7tzTW' }
+      let(:decoded_uuid) { '550e8400-e29b-41d4-a716-446655440000' }
+
+      it { should be_a Youyouaidi::UUID }
+      its(:to_s) { should eq decoded_uuid }
+    end
+
+    context 'with invalid uuid string' do
+      let(:param) { 'Kekse' }
+      let(:error_message_includes) { "`#{param}'" }
+      it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+    end
+
+    context 'with non-string input' do
+      let(:param) { 1234 }
+      let(:error_message_includes) { "`#{param}'" }
+      it_behaves_like 'a call that raises a Youyouaidi::InvalidUUIDError with a meaningful error message'
+    end
+  end
+
+  shared_examples_for 'equality check for two UUID objects' do
+    let(:first_uuid_string)  { 'aaaaaaaa-eeee-4444-aaaa-444444444444' }
+    let(:second_uuid_string) { '00000000-bbbb-2222-8888-000000000000' }
+    let(:first_uuid)  { Youyouaidi::UUID.new first_uuid_string }
+    let(:second_uuid) { Youyouaidi::UUID.new second_uuid_string }
+
+    subject { action }
+
+    context 'passing a UUID object' do
+      context 'when comparing same instance' do
+        let(:action) { first_uuid.send described_method, first_uuid }
+        it { should be_truthy }
+      end
+
+      context 'when comparing different instances' do
+        let(:action) { first_uuid.send described_method, second_uuid }
+        context 'with same UUID strings' do
+          let(:second_uuid_string) { first_uuid_string }
+          it { should be_truthy }
+        end
+
+        context 'with different UUID strings' do
+          it { should be_falsey }
+        end
+      end
+    end
+  end
+
+  describe '#== (equal operator)' do
+    let(:uuid_string)  { 'aaaaaaaa-eeee-4444-aaaa-444444444444' }
+    let(:uuid) { Youyouaidi::UUID.new uuid_string }
+
+    let(:described_method) { :== }
+    it_behaves_like 'equality check for two UUID objects'
+
+    subject { action }
+
+    context 'passing a non-UUID object' do
+      let(:action) { uuid == test_object }
+
+      context 'when this is the UUID as string' do
+        let(:test_object) { uuid_string }
+        it { should be_falsey }
+      end
+
+      context 'when this is a random other object' do
+        let(:test_object) { '123' }
+        it { should be_falsey }
+      end
+    end
+  end
+
+  describe '#=== (equal operator)' do
+    let(:uuid_string) { 'aaaaaaaa-eeee-4444-aaaa-444444444444' }
+    let(:uuid) { Youyouaidi::UUID.new uuid_string }
+
+    let(:described_method) { :=== }
+    it_behaves_like 'equality check for two UUID objects'
+
+    subject { action }
+
+    context 'passing a non-UUID object' do
+      # rubocop:disable Style/CaseEquality
+      let(:action) { uuid === test_object }
+      # rubocop:enable Style/CaseEquality
+
+      context 'when this is the same UUID as string' do
+        context 'when string is upcase' do
+          let(:test_object) { uuid_string.upcase }
+          it { should be_truthy }
+        end
+        context 'when string is downcase' do
+          let(:test_object) { uuid_string.downcase }
+          it { should be_truthy }
+        end
+      end
+
+      context 'when this is a random other object' do
+        let(:test_object) { '123' }
+        it { should be_falsey }
+      end
+    end
+  end
+
+  describe '#to_s' do
+    let(:uuid_string) { '550e8400-e29b-41d4-a716-446655440000' }
+    let(:uuid) { Youyouaidi::UUID.new uuid_string }
+    subject { uuid.to_s }
+
+    it { should be_a String }
+    it { should eq uuid_string }
+  end
+
+  describe '#to_i' do
+    let(:uuid_string) { '550e8400-e29b-41d4-a716-446655440000' }
+    let(:uuid) { Youyouaidi::UUID.new uuid_string }
+    subject { uuid.to_i }
+
+    it { should be_a Integer }
+    it { should eq 113_059_749_145_936_325_402_354_257_176_981_405_696 }
+  end
+
+  shared_examples_for 'method for short format' do
+    let(:uuid_string) { '550e8400-e29b-41d4-a716-446655440000' }
+    let(:encoded_uuid) { '2AuYQJcZeiIeCymkJ7tzTW' }
+    let(:uuid) { Youyouaidi::UUID.new uuid_string }
+
+    let(:action) { uuid.send method }
+    subject { action }
+
+    it { should be_a String }
+    it { should eq encoded_uuid }
+  end
+  describe '#to_short_string' do
+    let(:method) { :to_short_string }
+    it_behaves_like 'method for short format'
+  end
+  describe '#to_param' do
+    let(:method) { :to_param }
+    it_behaves_like 'method for short format'
+  end
+
+  describe '.valid?' do
+    let(:param) { '' }
+    subject { Youyouaidi::UUID.valid? param }
+
+    context 'with valid uuid' do
+      valid_uuids = %w[550e8400-e29b-41d4-a716-446655440000
+                       27f8bc29-be8e-4dc7-8b30-0295b2a5e902]
+
+      valid_uuids.each do |valid_uuid|
+        it "should return true for `#{valid_uuid}`" do
+          expect(Youyouaidi::UUID.valid?(valid_uuid)).to eq true
+        end
+      end
+    end
+
+    context 'with invalid uuid' do
+      uuid_string   = '550e8400-e29b-41d4-a716-446655440000'
+      encoded_uuid  = '2AuYQJcZeiIeCymkJ7tzTW'
+      invalid_uuids = ['Kekse', "aa#{uuid_string}", "#{uuid_string}bb",
+                       encoded_uuid.to_s, '550e8400-e29b-41d4-2716-446655440000']
+
+      invalid_uuids.each do |invalid_uuid|
+        it "should return false for `#{invalid_uuid}`" do
+          expect(Youyouaidi::UUID.valid?(invalid_uuid)).to eq false
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/BlockLength

data/youyouaidi-revised.gemspec

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'youyouaidi/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'youyouaidi-revised'
+  spec.version       = Youyouaidi::VERSION
+  spec.authors       = ['Nicolas Fricke', 'Loran Kloeze']
+  spec.email         = ['mail@nicolasfricke.de', 'loran@freedomnet.nl']
+  spec.summary       = 'UUID class'
+  spec.description   = 'Youyouaidi offers a UUID class for parsing, validating and encoding UUIDs'
+  spec.homepage      = 'https://github.com/LoranKloeze/youyouaidi-revised'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 2.7.4'
+
+  spec.files         = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 10.5'
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: youyouaidi-revised
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Nicolas Fricke
+- Loran Kloeze
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-11-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.5'
+description: Youyouaidi offers a UUID class for parsing, validating and encoding UUIDs
+email:
+- mail@nicolasfricke.de
+- loran@freedomnet.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/youyouaidi.rb
+- lib/youyouaidi/converter.rb
+- lib/youyouaidi/invalid_uuid.rb
+- lib/youyouaidi/uuid.rb
+- lib/youyouaidi/version.rb
+- spec/kernel_patch_spec.rb
+- spec/spec_helper.rb
+- spec/youyouaidi/converter_spec.rb
+- spec/youyouaidi/uuid_spec.rb
+- youyouaidi-revised.gemspec
+homepage: https://github.com/LoranKloeze/youyouaidi-revised
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: UUID class
+test_files:
+- spec/kernel_patch_spec.rb
+- spec/spec_helper.rb
+- spec/youyouaidi/converter_spec.rb
+- spec/youyouaidi/uuid_spec.rb