string_foundation 1.0.0 → 1.1.0

data/lib/string_foundation.rb

@@ -1,6 +1,8 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - STRING FOUNDATION
-# ==============================================================================
 # frozen_string_literal: true
+# ==============================================================================
 # Require methods.
-Dir.glob(File.join(File.dirname(__FILE__), 'string_foundation','*.rb')).each { |f| require f }
+Dir.glob(File.join(File.dirname(__FILE__), "string_foundation", "*.rb")).each do |file|
+  require file
+end

data/lib/string_foundation/blank.rb

@@ -0,0 +1,17 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - BLANK
+# frozen_string_literal: true
+# ==============================================================================
+class String
+
+  # Check whether a string is empty or only half-width spaces.
+  def blank?
+    self.empty? || /\A[[:space:]]*\z/.match(self).instance_of?(MatchData)
+  end
+
+  # Check whether a string is not empty or only half-width spaces.
+  def present?
+    !(self.blank?)
+  end
+
+end

data/lib/string_foundation/case.rb

@@ -1,22 +1,21 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - CASE
-# ==============================================================================
 # frozen_string_literal: true
+# ==============================================================================
 class String
 
   # Convert to lowerCamelCase.
   def to_lcamel
     ucamel = self.to_ucamel
-    ucamel.make_head_lower
+    ucamel.instance_eval { make_head_lower }
   end
 
   # Convert to UpperCamelCase.
   def to_ucamel
-    self.split_camel.map do |cw|
-      cw.split(/\.|_|-|\s/).map do |w|
-        w.capitalize
-      end.join
-    end.join
+    split_camel.map do |cw|
+      cw.split(/\.|_|-|\s/).map { |w| w.capitalize }.join
+    end
+    .join
   end
 
   # Convert to lower_snake_case.
@@ -27,11 +26,10 @@ class String
 
   # Convert to Upper_Snake_Case.
   def to_usnake
-    self.split_camel.map do |cw|
-      cw.split(/\.|_|-|\s/).map do |w|
-        w.capitalize
-      end.join('_')
-    end.join('_')
+    split_camel.map do |cw|
+      cw.split(/\.|_|-|\s/).map { |w| w.capitalize }.join("_")
+    end
+    .join("_")
   end
 
   # Convert to lower-kebab-case.
@@ -42,11 +40,10 @@ class String
 
   # Convert to Upper-Kebab-Case.
   def to_ukebab
-    self.split_camel.map do |cw|
-      cw.split(/\.|_|-|\s/).map do |w|
-        w.capitalize
-      end.join('-')
-    end.join('-')
+    split_camel.map do |cw|
+      cw.split(/\.|_|-|\s/).map { |w| w.capitalize }.join("-")
+    end
+    .join("-")
   end
 
   # Convert to lower space case.
@@ -57,11 +54,10 @@ class String
 
   # Convert to Upper Space Case.
   def to_uspace
-    self.split_camel.map do |cw|
-      cw.split(/\.|_|-|\s/).map do |w|
-        w.capitalize
-      end.join(' ')
-    end.join(' ')
+    split_camel.map do |cw|
+      cw.split(/\.|_|-|\s/).map { |w| w.capitalize }.join(" ")
+    end
+    .join(" ")
   end
 
   # Convert to lower.dot.case.
@@ -72,26 +68,20 @@ class String
 
   # Convert to Upper.Dot.Case.
   def to_udot
-    self.split_camel.map do |cw|
-      cw.split(/\.|_|-|\s/).map do |w|
-        w.capitalize
-      end.join('.')
-    end.join('.')
+    split_camel.map do |cw|
+      cw.split(/\.|_|-|\s/).map { |w| w.capitalize }.join(".")
+    end
+    .join(".")
   end
 
+
+  # ----------------------------------------------------------------------------
+  # Private
+  # ----------------------------------------------------------------------------
+  private
   # Split string according to camel case.
   def split_camel
-    self.split /(?=[A-Z])/
-  end
-
-  # Whether a character is uppder case or not.
-  def is_upper?
-    /[[:upper:]]/.match(self) ? true : false
-  end
-
-  # Whether a character is lower case or not.
-  def is_lower?
-    /[[:lower:]]/.match(self) ? true : false
+    self.split(/(?=[A-Z])/)
   end
 
   # Make first character lower case.

data/lib/string_foundation/convert.rb

@@ -1,10 +1,10 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - CONVERT
-# ==============================================================================
 # frozen_string_literal: true
-require_relative 'convertible'
-require_relative 'like'
-require_relative 'with'
+# ==============================================================================
+require_relative "convertible"
+require_relative "like"
+require_relative "with"
 class String
 
   # Convert to TrueClass or FalseClass.
@@ -13,7 +13,7 @@ class String
       raise TypeError.new("#{self} cannot be converted to TrueClass or FalseClass")
     end
 
-    (self == 'true')
+    (self == "true")
   end
 
   # Convert a booly string to TrueClass or FalseClass.
@@ -22,7 +22,7 @@ class String
       raise TypeError.new("#{self} cannot be converted to TrueClass or FalseClass")
     end
 
-    return true if self == 'true'  || (self.to_f? && self.to_f > 0)
+    return true if self == "true"  || (self.to_f? && self.to_f > 0)
     false
   end
 
@@ -30,20 +30,20 @@ class String
   def to_pretty
     return self.without_leading_zeros.to_i if self.like_i?
     return self.without_leading_zeros.to_f if self.like_f?
-    return self.to_bool                    if self.to_bool?
+    return self.to_bool if self.to_bool?
 
     (self.length > 0) ? self : nil
   end
 
   # Convert from newline character to specific characters.
   def nl_to(char)
-    char = '' if char.nil?
+    char = "" if char.nil?
     self.gsub(/(\r\n|\n)/, char)
   end
 
   # Convert from newline character to a HTML tag "<br>".
   def nl_to_br
-    self.nl_to('<br>')
+    self.nl_to("<br>")
   end
 
   alias_method :nl2, :nl_to

data/lib/string_foundation/convertible.rb

@@ -1,8 +1,8 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - CONVERTIBLE
-# ==============================================================================
 # frozen_string_literal: true
-require_relative 'with'
+# ==============================================================================
+require_relative "with"
 class String
 
   # Whether or not to be possible to covert String to Integer.
@@ -23,7 +23,7 @@ class String
 
   # Whether or not to be possible to covert String to Boolean.
   def to_bool?
-    return true if %w(true false).include?(self)
+    return true if ["true", "false"].include?(self)
     false
   end
 
@@ -31,7 +31,7 @@ class String
   # like boolean types.
   def to_booly?
     return true if self.length == 0
-    return true if %w(true false).include?(self)
+    return true if ["true", "false"].include?(self)
     return true if self.to_f?
 
     false

data/lib/string_foundation/is.rb

@@ -0,0 +1,13 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - IS
+# frozen_string_literal: true
+# ==============================================================================
+class String
+
+  def is_sym?(symbol)
+    raise ArgumentError.new("argument must be Symbol") unless symbol.instance_of?(Symbol)
+
+    (self == symbol.to_s)
+  end
+
+end

data/lib/string_foundation/length.rb

@@ -0,0 +1,56 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - LENGTH
+# frozen_string_literal: true
+# ==============================================================================
+class String
+
+  # Check whether characters length is a specific number.
+  def length?(length)
+    unless [Integer, Range, Fixnum, Bignum].include?(length.class)
+      raise ArgumentError.new("argument must be Integer (including Fixnum or Bignum) or Range")
+    end
+
+    return (self.length == length) unless length.instance_of?(Range)
+    self.length.between?(length.first, length.last)
+  end
+
+  # Check whether characters length is less than a specific number.
+  def length_lt?(length)
+    self.instance_eval { allow_only_integer(length) }
+
+    (self.length < length)
+  end
+
+  # Check whether characters length is less than or equal to a specific number.
+  def length_lte?(length)
+    self.instance_eval { allow_only_integer(length) }
+
+    (self.length <= length)
+  end
+
+  # Check whether characters length is greater than a specific number.
+  def length_gt?(length)
+    self.instance_eval { allow_only_integer(length) }
+
+    (self.length > length)
+  end
+
+  # Check whether characters length is greater than or equal to a specific number.
+  def length_gte?(length)
+    self.instance_eval { allow_only_integer(length) }
+
+    (self.length >= length)
+  end
+
+
+  # ----------------------------------------------------------------------------
+  # Private
+  # ----------------------------------------------------------------------------
+  private
+  # Allow only Integer.
+  def allow_only_integer(argument)
+    return if [Integer, Fixnum, Bignum].include?(argument.class)
+    raise ArgumentError.new("argument must be Integer (including Fixnum or Bignum)")
+  end
+
+end

data/lib/string_foundation/like.rb

@@ -1,8 +1,8 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - LIKE
-# ==============================================================================
 # frozen_string_literal: true
-require_relative 'convertible'
+# ==============================================================================
+require_relative "convertible"
 class String
 
   # Check whether a string is an integral number.
@@ -10,7 +10,7 @@ class String
     return false unless self.to_i?
 
     num = self.without_leading_zeros
-    (num.to_i == num.to_i) && !num.include?('.')
+    (num.to_i == num.to_i) && !num.include?(".")
   end
 
   # Check whether a string is a floating point number.
@@ -18,7 +18,7 @@ class String
     return false unless self.to_f?
 
     num = self.without_leading_zeros
-    (num.to_i != num.to_f) || num.include?('.')
+    (num.to_i != num.to_f) || num.include?(".")
   end
 
 end

data/lib/string_foundation/version.rb

@@ -1,7 +1,7 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - VERSION
-# ==============================================================================
 # frozen_string_literal: true
+# ==============================================================================
 module StringFoundation
-  VERSION = '1.0.0'
+  VERSION = "1.1.0"
 end

data/lib/string_foundation/with.rb

@@ -1,20 +1,20 @@
 # ==============================================================================
 # LIB - STRING FOUNDATION - WITH
-# ==============================================================================
 # frozen_string_literal: true
+# ==============================================================================
 class String
 
   # Remove leading zeros.
   def without_leading_zeros
-    return self if self == '0'
+    return self if self == "0"
 
-    is_positive = self.start_with?('0')
-    is_negative = self.start_with?('-0')
+    is_positive = self.start_with?("0")
+    is_negative = self.start_with?("-0")
     if is_positive || is_negative
-      sig = self[0, self.length].gsub(/(^0+)|(^-0+)/, '')
+      sig = self[0, self.length].gsub(/(^0+)|(^-0+)/, "")
 
-      sig = '0' + sig if sig.start_with?('.') || sig.length == 0
-      sig = '-' + sig if is_negative && sig != '0'
+      sig = "0" + sig if sig.start_with?(".") || sig.length == 0
+      sig = "-" + sig if is_negative && sig != "0"
 
       sig
     else

data/spec/spec_helper.rb

@@ -1,13 +1,13 @@
 # ==============================================================================
 # SPEC - SPEC HELPER
-# ==============================================================================
 # frozen_string_literal: true
+# ==============================================================================
 # Configure Simple Cov to get coverage and Codecov.
 # !! These should be written at the beginning of this file to work. !!
-require 'simplecov'
-require 'simplecov-console'
-require 'codecov'
-if ENV['CI']
+require "simplecov"
+require "simplecov-console"
+require "codecov"
+if ENV["CI"]
   SimpleCov.formatter = SimpleCov::Formatter::Codecov
 else
   SimpleCov.formatters = [
@@ -18,12 +18,12 @@ end
 SimpleCov.start
 
 # Require core files.
-require 'bundler/setup'
-require 'string_foundation'
-require 'support/enhanced_matchers_extension'
+require "bundler/setup"
+require "string_foundation"
+require "support/enhanced_matchers_extension"
 
 # Require components.
-require 'random_token'
+require "random_token"
 
 # ------------------------------------------------------------------------------
 # RSpec Settings
@@ -32,7 +32,7 @@ RSpec.configure do |config|
   config.include EnhancedMatchersExtension
 
   # Enable flags like --only-failures and --next-failure .
-  config.example_status_persistence_file_path = '.rspec_status'
+  config.example_status_persistence_file_path = ".rspec_status"
 
   config.expect_with :rspec do |c|
     c.syntax = :expect

data/spec/string_foundation/blank_spec.rb

@@ -0,0 +1,91 @@
+# ==============================================================================
+# SPEC - STRING FOUNDATION - BLANK SPEC
+# frozen_string_literal: true
+# ==============================================================================
+describe "[ Blank Methods ]" do
+  let(:string) { "" }
+
+  # ----------------------------------------------------------------------------
+  # Check Whether A String Is A Blank
+  # ----------------------------------------------------------------------------
+  describe "CHECK WHETHER A STRING IS A BLANK ::" do
+    subject { string.blank? }
+
+    context "when a string is empty," do
+      it { is_expected.to be true }
+    end
+
+    context "when a string is a word," do
+      let(:string) { "string" }
+
+      it { is_expected.to be false }
+    end
+
+    context "when a string includes half-width spaces," do
+      let(:string) { "this is string foundation." }
+
+      it { is_expected.to be false }
+    end
+
+    context "when a string includes only 1 half-width space," do
+      let(:string) { " " }
+
+      it { is_expected.to be true }
+    end
+
+    context "when a string includes only multiple half-width spaces," do
+      let(:string) { " " * 3 }
+
+      it { is_expected.to be true }
+    end
+
+    context "when a string is a newline," do
+      let(:string) { "\n" }
+
+      it { is_expected.to be true }
+    end
+  end
+
+
+  # ----------------------------------------------------------------------------
+  # Check Whether A String Is Present
+  # ----------------------------------------------------------------------------
+  describe "CHECK WHETHER A STRING IS PRESENT ::" do
+    subject { string.present? }
+
+    context "when a string is empty," do
+      it { is_expected.to be false }
+    end
+
+    context "when a string is a word," do
+      let(:string) { "string" }
+
+      it { is_expected.to be true }
+    end
+
+    context "when a string includes half-width spaces," do
+      let(:string) { "this is string foundation." }
+
+      it { is_expected.to be true }
+    end
+
+    context "when a string includes only 1 half-width space," do
+      let(:string) { " " }
+
+      it { is_expected.to be false }
+    end
+
+    context "when a string includes only multiple half-width spaces," do
+      let(:string) { " " * 3 }
+
+      it { is_expected.to be false }
+    end
+
+    context "when a string is a newline," do
+      let(:string) { "\n" }
+
+      it { is_expected.to be false }
+    end
+  end
+
+end