chars 0.2.0 → 0.2.4

data/lib/chars/chars.rb

@@ -1,60 +1,66 @@
+# frozen_string_literal: true
+
 require 'chars/char_set'
 
 module Chars
   # The numeric decimal character set
-  NUMERIC = CharSet.new('0'..'9')
+  NUMERIC = CharSet['0'..'9']
 
   # The octal character set
-  OCTAL = CharSet.new('0'..'7')
+  OCTAL = CharSet['0'..'7']
 
   # The upper-case hexadecimal character set
-  UPPERCASE_HEXADECIMAL = NUMERIC + ('A'..'F')
+  UPPERCASE_HEXADECIMAL = NUMERIC | CharSet['A'..'F']
 
   # The lower-case hexadecimal character set
-  LOWERCASE_HEXADECIMAL = NUMERIC + ('a'..'f')
+  LOWERCASE_HEXADECIMAL = NUMERIC | CharSet['a'..'f']
 
   # The hexadecimal character set
-  HEXADECIMAL = UPPERCASE_HEXADECIMAL + LOWERCASE_HEXADECIMAL
+  HEXADECIMAL = UPPERCASE_HEXADECIMAL | LOWERCASE_HEXADECIMAL
 
   # The upper-case alpha character set
-  UPPERCASE_ALPHA = CharSet.new('A'..'Z')
+  UPPERCASE_ALPHA = CharSet['A'..'Z']
 
   # The lower-case alpha character set
-  LOWERCASE_ALPHA = CharSet.new('a'..'z')
+  LOWERCASE_ALPHA = CharSet['a'..'z']
 
   # The alpha character set
-  ALPHA = UPPERCASE_ALPHA + LOWERCASE_ALPHA
+  ALPHA = UPPERCASE_ALPHA | LOWERCASE_ALPHA
 
   # The alpha-numeric character set
-  ALPHA_NUMERIC = ALPHA + NUMERIC
+  ALPHA_NUMERIC = ALPHA | NUMERIC
 
   # The punctuation character set
-  PUNCTUATION = CharSet.new(' ', '\'', '"', '`', ',', ';', ':', '~', '-',
-                            '(', ')', '[', ']', '{', '}', '.', '?', '!')
+  PUNCTUATION = CharSet[' ', '\'', '"', '`', ',', ';', ':', '~', '-',
+                        '(', ')', '[', ']', '{', '}', '.', '?', '!']
 
   # The symbolic character set
-  SYMBOLS = PUNCTUATION + ['@', '#', '$', '%', '^', '&', '*', '_', '+',
-    '=', '|', '\\', '<', '>', '/']
+  SYMBOLS = PUNCTUATION | CharSet[
+    '@', '#', '$', '%', '^', '&', '*', '_', '+',
+    '=', '|', '\\', '<', '>', '/'
+  ]
 
   # The space character set
-  SPACE = CharSet.new(' ', "\f", "\n", "\r", "\t", "\v")
+  SPACE = CharSet[' ', "\f", "\n", "\r", "\t", "\v"]
 
   # The set of printable characters (not including spaces)
-  VISIBLE = ALPHA_NUMERIC + ['\'', '"', '`', ',', ';', ':', '~', '-',
-            '(', ')', '[', ']', '{', '}', '.', '?', '!', '@', '#', '$',
-            '%', '^', '&', '*', '_', '+', '=', '|', '\\', '<', '>', '/']
+  VISIBLE = ALPHA_NUMERIC | CharSet[
+    '\'', '"', '`', ',', ';', ':', '~', '-',
+    '(', ')', '[', ']', '{', '}', '.', '?', '!', '@', '#', '$',
+    '%', '^', '&', '*', '_', '+', '=', '|', '\\', '<', '>', '/'
+  ]
   
   # The set of printable characters (including spaces)
-  PRINTABLE = ALPHA_NUMERIC + PUNCTUATION + SYMBOLS + SPACE
+  PRINTABLE = ALPHA_NUMERIC | PUNCTUATION | SYMBOLS | SPACE
 
   # The control-char character set
-  CONTROL = CharSet.new(0..0x1f, 0x7f)
+  CONTROL = CharSet[0..0x1f, 0x7f]
 
   # The signed ASCII character set
-  SIGNED_ASCII = CharSet.new(0..0x7f)
+  SIGNED_ASCII = CharSet[0..0x7f]
 
   # The full 8-bit character set
-  ASCII = CharSet.new(0..0xff)
+  ASCII = CharSet[0..0xff]
 
   #
   # The decimal-digit character set.
@@ -62,7 +68,9 @@ module Chars
   # @return [CharSet]
   #   The decimal-digit character set.
   #
-  def Chars.numeric
+  # @see NUMERIC
+  #
+  def self.numeric
     NUMERIC
   end
 
@@ -72,7 +80,9 @@ module Chars
   # @return [CharSet]
   #   The octal-digit character set.
   #
-  def Chars.octal
+  # @see OCTAL
+  #
+  def self.octal
     OCTAL
   end
 
@@ -82,7 +92,9 @@ module Chars
   # @return [CharSet]
   #   The upper-case hexadecimal character set.
   #
-  def Chars.uppercase_hexadecimal
+  # @see UPPERCASE_HEXADECIMAL
+  #
+  def self.uppercase_hexadecimal
     UPPERCASE_HEXADECIMAL
   end
 
@@ -92,7 +104,9 @@ module Chars
   # @return [CharSet]
   #   The lower-case hexadecimal character set.
   #
-  def Chars.lowercase_hexadecimal
+  # @see LOWERCASE_HEXADECIMAL
+  #
+  def self.lowercase_hexadecimal
     LOWERCASE_HEXADECIMAL
   end
 
@@ -102,7 +116,9 @@ module Chars
   # @return [CharSet]
   #   The hexadecimal character set.
   #
-  def Chars.hexadecimal
+  # @see HEXADECIMAL
+  #
+  def self.hexadecimal
     HEXADECIMAL
   end
 
@@ -112,7 +128,9 @@ module Chars
   # @return [CharSet]
   #   The upper-case alphabetic character set.
   #
-  def Chars.uppercase_alpha
+  # @see UPPERCASE_ALPHA
+  #
+  def self.uppercase_alpha
     UPPERCASE_ALPHA
   end
 
@@ -122,7 +140,9 @@ module Chars
   # @return [CharSet]
   #   The lower-case alphabetic character set.
   #
-  def Chars.lowercase_alpha
+  # @see LOWERCASE_ALPHA
+  #
+  def self.lowercase_alpha
     LOWERCASE_ALPHA
   end
 
@@ -132,7 +152,9 @@ module Chars
   # @return [CharSet]
   #   The alphabetic character set.
   #
-  def Chars.alpha
+  # @see ALPHA
+  #
+  def self.alpha
     ALPHA
   end
 
@@ -142,7 +164,9 @@ module Chars
   # @return [CharSet]
   #   The alpha-numeric character set.
   #
-  def Chars.alpha_numeric
+  # @see ALPHA_NUMERIC
+  #
+  def self.alpha_numeric
     ALPHA_NUMERIC
   end
 
@@ -152,7 +176,9 @@ module Chars
   # @return [CharSet]
   #   The punctuation character set.
   #
-  def Chars.punctuation
+  # @see PUNCTUATION
+  #
+  def self.punctuation
     PUNCTUATION
   end
 
@@ -162,7 +188,9 @@ module Chars
   # @return [CharSet]
   #   The symbolic character set.
   #
-  def Chars.symbols
+  # @see SYMBOLS
+  #
+  def self.symbols
     SYMBOLS
   end
 
@@ -172,7 +200,9 @@ module Chars
   # @return [CharSet]
   #   The white-space character set.
   #
-  def Chars.space
+  # @see SPACE
+  #
+  def self.space
     SPACE
   end
 
@@ -182,7 +212,9 @@ module Chars
   # @return [CharSet]
   #   The visible character set.
   #
-  def Chars.visible
+  # @see VISIBLE
+  #
+  def self.visible
     VISIBLE
   end
 
@@ -192,7 +224,9 @@ module Chars
   # @return [CharSet]
   #   The printable character set.
   #
-  def Chars.printable
+  # @see PRINTABLE
+  #
+  def self.printable
     PRINTABLE
   end
 
@@ -202,7 +236,9 @@ module Chars
   # @return [CharSet]
   #   The control-character character set.
   #
-  def Chars.control
+  # @see CONTROL
+  #
+  def self.control
     CONTROL
   end
 
@@ -212,7 +248,9 @@ module Chars
   # @return [CharSet]
   #   The signed ASCII character set.
   #
-  def Chars.signed_ascii
+  # @see SIGNED_ASCII
+  #
+  def self.signed_ascii
     SIGNED_ASCII
   end
 
@@ -222,7 +260,9 @@ module Chars
   # @return [CharSet]
   #   The ASCII character set.
   #
-  def Chars.ascii
+  # @see ASCII
+  #
+  def self.ascii
     ASCII
   end
 end

data/lib/chars/extensions/integer.rb

@@ -8,10 +8,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the decimal-digit character set.
   #
-  # @see Chars.numeric
+  # @see Chars::NUMERIC
+  # @see Chars::CharSet#include_byte?
   #
   def numeric?
-    Chars::NUMERIC.include?(self)
+    Chars::NUMERIC.include_byte?(self)
   end
 
   #
@@ -20,10 +21,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the octal-digit character set.
   #
-  # @see Chars.octal
+  # @see Chars::OCTAL
+  # @see Chars::CharSet#include_byte?
   #
   def octal?
-    Chars::OCTAL.include?(self)
+    Chars::OCTAL.include_byte?(self)
   end
 
   #
@@ -34,10 +36,11 @@ class Integer
   #   Specifies whether the byte belongs to the upper-case hexadecimal
   #   character set.
   #
-  # @see Chars.uppercase_hexadecimal
+  # @see Chars::UPPERCASE_HEXADECIMAL
+  # @see Chars::CharSet#include_byte?
   #
   def uppercase_hex?
-    Chars::UPPERCASE_HEXADECIMAL.include?(self)
+    Chars::UPPERCASE_HEXADECIMAL.include_byte?(self)
   end
 
   #
@@ -48,10 +51,11 @@ class Integer
   #   Specifies whether the byte belongs to the lower-case hexadecimal
   #   character set.
   #
-  # @see Chars.lowercase_hexadecimal
+  # @see Chars::LOWERCASE_HEXADECIMAL
+  # @see Chars::CharSet#include_byte?
   #
   def lowercase_hex?
-    Chars::LOWERCASE_HEXADECIMAL.include?(self)
+    Chars::LOWERCASE_HEXADECIMAL.include_byte?(self)
   end
 
   #
@@ -60,10 +64,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the hexadecimal character set.
   #
-  # @see Chars.hexadecimal
+  # @see Chars::HEXADECIMAL
+  # @see Chars::CharSet#include_byte?
   #
   def hex?
-    Chars::HEXADECIMAL.include?(self)
+    Chars::HEXADECIMAL.include_byte?(self)
   end
 
   #
@@ -74,10 +79,11 @@ class Integer
   #   Specifies whether the byte belongs to the upper-case alphabetic
   #   character set.
   #
-  # @see Chars.uppercase_alpha
+  # @see Chars::UPPERCASE_ALPHA
+  # @see Chars::CharSet#include_byte?
   #
   def uppercase_alpha?
-    Chars::UPPERCASE_ALPHA.include?(self)
+    Chars::UPPERCASE_ALPHA.include_byte?(self)
   end
 
   #
@@ -88,10 +94,11 @@ class Integer
   #   Specifies whether the byte belongs to the lower-case alphabetic
   #   character set.
   #
-  # @see Chars.lowercase_alpha
+  # @see Chars::LOWERCASE_ALPHA
+  # @see Chars::CharSet#include_byte?
   #
   def lowercase_alpha?
-    Chars::LOWERCASE_ALPHA.include?(self)
+    Chars::LOWERCASE_ALPHA.include_byte?(self)
   end
 
   #
@@ -100,10 +107,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the alphabetic character set.
   #
-  # @see Chars.alpha
+  # @see Chars::ALPHA
+  # @see Chars::CharSet#include_byte?
   #
   def alpha?
-    Chars::ALPHA.include?(self)
+    Chars::ALPHA.include_byte?(self)
   end
 
   #
@@ -112,10 +120,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the alpha-numeric character set.
   #
-  # @see Chars.alpha_numeric
+  # @see Chars::ALPHA_NUMERIC
+  # @see Chars::CharSet#include_byte?
   #
   def alpha_numeric?
-    Chars::ALPHA_NUMERIC.include?(self)
+    Chars::ALPHA_NUMERIC.include_byte?(self)
   end
 
   #
@@ -124,10 +133,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the punctuation character set.
   #
-  # @see Chars.punctuation
+  # @see Chars::PUNCTUATION
+  # @see Chars::CharSet#include_byte?
   #
   def punctuation?
-    Chars::PUNCTUATION.include?(self)
+    Chars::PUNCTUATION.include_byte?(self)
   end
 
   #
@@ -136,10 +146,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the symbolic character set.
   #
-  # @see Chars.symbols
+  # @see Chars::SYMBOLS
+  # @see Chars::CharSet#include_byte?
   #
   def symbolic?
-    Chars::SYMBOLS.include?(self)
+    Chars::SYMBOLS.include_byte?(self)
   end
 
   #
@@ -148,10 +159,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the white-space character set.
   #
-  # @see Chars.space
+  # @see Chars::SPACE
+  # @see Chars::CharSet#include_byte?
   #
   def space?
-    Chars::SPACE.include?(self)
+    Chars::SPACE.include_byte?(self)
   end
 
   #
@@ -160,10 +172,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the visible character set.
   #
-  # @see Chars.visible
+  # @see Chars::VISIBLE
+  # @see Chars::CharSet#include_byte?
   #
   def visible?
-    Chars::VISIBLE.include?(self)
+    Chars::VISIBLE.include_byte?(self)
   end
 
   #
@@ -172,10 +185,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the printable character set.
   #
-  # @see Chars.printable
+  # @see Chars::PRINTABLE
+  # @see Chars::CharSet#include_byte?
   #
   def printable?
-    Chars::PRINTABLE.include?(self)
+    Chars::PRINTABLE.include_byte?(self)
   end
 
   #
@@ -185,10 +199,11 @@ class Integer
   #   Specifies whether the byte belongs to the control-character character
   #   set.
   #
-  # @see Chars.control
+  # @see Chars::CONTROL
+  # @see Chars::CharSet#include_byte?
   #
   def control?
-    Chars::CONTROL.include?(self)
+    Chars::CONTROL.include_byte?(self)
   end
 
   #
@@ -197,10 +212,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the signed-ASCII character set.
   #
-  # @see Chars.signed_ascii
+  # @see Chars::SIGNED_ASCII
+  # @see Chars::CharSet#include_byte?
   #
   def signed_ascii?
-    Chars::SIGNED_ASCII.include?(self)
+    Chars::SIGNED_ASCII.include_byte?(self)
   end
 
   #
@@ -209,10 +225,11 @@ class Integer
   # @return [Boolean]
   #   Specifies whether the byte belongs to the ASCII character set.
   #
-  # @see Chars.ascii
+  # @see Chars::ASCII
+  # @see Chars::CharSet#include_byte?
   #
   def ascii?
-    Chars::ASCII.include?(self)
+    Chars::ASCII.include_byte?(self)
   end
 
 end

data/lib/chars/extensions/string.rb

@@ -9,7 +9,8 @@ class String
   #   Specifies whether the String belongs to the decimal-digit character
   #   set.
   #
-  # @see Chars.numeric
+  # @see Chars::NUMERIC
+  # @see Chars::CharSet#===
   #
   def numeric?
     Chars::NUMERIC === self
@@ -22,7 +23,8 @@ class String
   #   Specifies whether the String belongs to the octal-digit character
   #   set.
   #
-  # @see Chars.octal
+  # @see Chars::OCTAL
+  # @see Chars::CharSet#===
   #
   def octal?
     Chars::OCTAL === self
@@ -36,7 +38,8 @@ class String
   #   Specifies whether the String belongs to the upper-case hexadecimal
   #   character set.
   #
-  # @see Chars.uppercase_hexadecimal
+  # @see Chars::UPPERCASE_HEXADECIMAL
+  # @see Chars::CharSet#===
   #
   def uppercase_hex?
     Chars::UPPERCASE_HEXADECIMAL === self
@@ -50,7 +53,8 @@ class String
   #   Specifies whether the String belongs to the lower-case hexadecimal
   #   character set.
   #
-  # @see Chars.lowercase_hexadecimal
+  # @see Chars::LOWERCASE_HEXADECIMAL
+  # @see Chars::CharSet#===
   #
   def lowercase_hex?
     Chars::LOWERCASE_HEXADECIMAL === self
@@ -62,7 +66,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the hexadecimal character set.
   #
-  # @see Chars.hexadecimal
+  # @see Chars::HEXADECIMAL
+  # @see Chars::CharSet#===
   #
   def hex?
     Chars::HEXADECIMAL === self
@@ -76,7 +81,8 @@ class String
   #   Specifies whether the String belongs to the upper-case alphabetic
   #   character set.
   #
-  # @see Chars.uppercase_alpha
+  # @see Chars::UPPERCASE_ALPHA
+  # @see Chars::CharSet#===
   #
   def uppercase_alpha?
     Chars::UPPERCASE_ALPHA === self
@@ -90,7 +96,8 @@ class String
   #   Specifies whether the String belongs to the lower-case alphabetic
   #   character set.
   #
-  # @see Chars.lowercase_alpha
+  # @see Chars::LOWERCASE_ALPHA
+  # @see Chars::CharSet#===
   #
   def lowercase_alpha?
     Chars::LOWERCASE_ALPHA === self
@@ -102,7 +109,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the alphabetic character set.
   #
-  # @see Chars.alpha
+  # @see Chars::ALPHA
+  # @see Chars::CharSet#===
   #
   def alpha?
     Chars::ALPHA === self
@@ -116,7 +124,8 @@ class String
   #   Specifies whether the String belongs to the alpha-numeric character
   #   set.
   #
-  # @see Chars.alpha_numeric
+  # @see Chars::ALPHA_NUMERIC
+  # @see Chars::CharSet#===
   #
   def alpha_numeric?
     Chars::ALPHA_NUMERIC === self
@@ -128,7 +137,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the punctuation character set.
   #
-  # @see Chars.punctuation
+  # @see Chars::PUNCTUATION
+  # @see Chars::CharSet#===
   #
   def punctuation?
     Chars::PUNCTUATION === self
@@ -140,7 +150,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the symbolic character set.
   #
-  # @see Chars.symbols
+  # @see Chars::SYMBOLS
+  # @see Chars::CharSet#===
   #
   def symbolic?
     Chars::SYMBOLS === self
@@ -152,7 +163,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the white-space character set.
   #
-  # @see Chars.space
+  # @see Chars::SPACE
+  # @see Chars::CharSet#===
   #
   def space?
     Chars::SPACE === self
@@ -164,7 +176,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the visible character set.
   #
-  # @see Chars.visible
+  # @see Chars::VISIBLE
+  # @see Chars::CharSet#===
   #
   def visible?
     Chars::VISIBLE === self
@@ -176,7 +189,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the printable character set.
   #
-  # @see Chars.printable
+  # @see Chars::PRINTABLE
+  # @see Chars::CharSet#===
   #
   def printable?
     Chars::PRINTABLE === self
@@ -190,7 +204,8 @@ class String
   #   Specifies whether the String belongs to the control-character
   #   character set.
   #
-  # @see Chars.control
+  # @see Chars::CONTROL
+  # @see Chars::CharSet#===
   #
   def control?
     Chars::CONTROL === self
@@ -203,7 +218,8 @@ class String
   #   Specifies whether the String belongs to the signed-ASCII character
   #   set.
   #
-  # @see Chars.signed_ascii
+  # @see Chars::SIGNED_ASCII
+  # @see Chars::CharSet#===
   #
   def signed_ascii?
     Chars::SIGNED_ASCII === self
@@ -215,7 +231,8 @@ class String
   # @return [Boolean]
   #   Specifies whether the String belongs to the ASCII character set.
   #
-  # @see Chars.ascii
+  # @see Chars::ASCII
+  # @see Chars::CharSet#===
   #
   def ascii?
     Chars::ASCII === self

data/lib/chars/version.rb

@@ -1,4 +1,4 @@
 module Chars
-  # Chars version
-  VERSION = '0.2.0'
+  # chars version
+  VERSION = '0.2.4'
 end