mini_sanity 1.1.0 → 2.0.0

data/lib/mini_sanity/util.rb

@@ -1,3 +0,0 @@
-require_relative "util/enumerable"
-require_relative "util/regexp"
-require_relative "util/string"

data/lib/mini_sanity/util/enumerable.rb

@@ -1,31 +0,0 @@
-module Enumerable
-
-  # Like {https://ruby-doc.org/core/Enumerable.html#method-i-first
-  # +Enumerable#first+}, but raises an exception if the Enumerable does
-  # not contain the requested number of elements.
-  #
-  # @example
-  #   [7, 8, 9].first     # == 7
-  #   [7, 8, 9].first(1)  # == [7]
-  #   [7, 8, 9].first(2)  # == [7, 8]
-  #   [7, 8, 9].first(4)  # raises exception
-  #   [].first            # raises exception
-  #
-  # @param n [Integer]
-  #   requested number of elements
-  # @return [Object, Array]
-  # @raise [MiniSanity::Error]
-  #   if the Enumerable does not contain the requested number of elements
-  def first!(n = nil)
-    result = n.nil? ? self.first : self.first(n)
-
-    if (result.nil? && !self.any?{ true }) || (!n.nil? && result.length < n)
-      raise MiniSanity::Error.new(nil,
-        "Enumerable having at least #{n || 1} elements",
-        self.inspect)
-    end
-
-    result
-  end
-
-end

data/lib/mini_sanity/util/regexp.rb

@@ -1,27 +0,0 @@
-class Regexp
-
-  # Like {https://ruby-doc.org/core/Regexp.html#method-i-match
-  # +Regexp#match+}, but raises an exception if the match fails.
-  #
-  # @example
-  #   /^([^@]+)@(.+)$/.match!("user@example.com")  # === MatchData
-  #   /^([^@]+)@(.+)$/.match!("@user")             # raises exception
-  #
-  # @param str [String]
-  #   string to search
-  # @param pos [Integer]
-  #   position in +str+ to begin the search
-  # @return [MatchData]
-  # @raise [MiniSanity::Error]
-  #   if the Regexp does not match +str+
-  def match!(str, pos = 0)
-    result = self.match(str, pos)
-    if result.nil?
-      raise MiniSanity::Error.new(nil,
-        "String matching #{self.inspect}#{" from position #{pos}" if pos != 0}",
-        str.inspect)
-    end
-    result
-  end
-
-end

data/lib/mini_sanity/util/string.rb

@@ -1,77 +0,0 @@
-class String
-
-  # Like {https://ruby-doc.org/core/String.html#method-i-match
-  # +String#match+}, but raises an exception if the match fails.
-  #
-  # @example
-  #   "user@example.com".match!(/^([^@]+)@(.+)$/)  # === MatchData
-  #   "@user".match!(/^([^@]+)@(.+)$/)             # raises exception
-  #
-  # @param pattern [Regexp]
-  #   pattern to search for
-  # @param pos [Integer]
-  #   position in the String to begin the search
-  # @return [MatchData]
-  # @raise [MiniSanity::Error]
-  #   if +pattern+ does not match the String
-  def match!(pattern, pos = 0)
-    result = self.match(pattern, pos)
-    if result.nil?
-      raise MiniSanity::Error.new(nil,
-        "String matching #{pattern.inspect}#{" from position #{pos}" if pos != 0}",
-        self.inspect)
-    end
-    result
-  end
-
-  # Like {https://ruby-doc.org/core/String.html#method-i-sub-21
-  # +String#sub!+}, but raises an exception if no substitution was
-  # performed.
-  #
-  # @example
-  #   "author: YOUR_NAME".change!(/\bYOUR_NAME\b/, "Me")  # == "author: Me"
-  #   "author: TODO".change!(/\bYOUR_NAME\b/, "Me")       # raises exception
-  #
-  # @param pattern [Regexp, String]
-  #   pattern to search for
-  # @param replacement [String, Hash, &block]
-  #   substitution value (see +String#sub!+ documentation for full details)
-  # @return [String]
-  # @raise [MiniSanity::Error]
-  #   if no substitution was performed
-  def change!(pattern, replacement = nil, &replacement_block)
-    result = if replacement
-      self.sub!(pattern, replacement)
-    else
-      self.sub!(pattern, &replacement_block)
-    end
-
-    if !result
-      raise MiniSanity::Error.new(nil,
-        "String matching #{pattern.inspect}",
-        self.inspect)
-    end
-
-    result
-  end
-
-  # Like {https://ruby-doc.org/core/String.html#method-i-sub
-  # +String#sub+}, but raises an exception if no substitution was
-  # performed.
-  #
-  # @example
-  #   "author: YOUR_NAME".change(/\bYOUR_NAME\b/, "Me")  # == "author: Me"
-  #   "author: TODO".change(/\bYOUR_NAME\b/, "Me")       # raises exception
-  #
-  # @param pattern [Regexp, String]
-  #   pattern to search for
-  # @param replacement [String, Hash, &block]
-  #   substitution value (see +String#sub+ documentation for full details)
-  # @return [String]
-  # @raise [MiniSanity::Error]
-  #   if no substitution was performed
-  def change(pattern, replacement = nil, &replacement_block)
-    self.dup.change!(pattern, replacement, &replacement_block)
-  end
-
-end