string_foundation 1.0.0

data/lib/string_foundation/case.rb

@@ -0,0 +1,102 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - CASE
+# ==============================================================================
+# frozen_string_literal: true
+class String
+
+  # Convert to lowerCamelCase.
+  def to_lcamel
+    ucamel = self.to_ucamel
+    ucamel.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
+  end
+
+  # Convert to lower_snake_case.
+  def to_lsnake
+    usnake = self.to_usnake
+    usnake.downcase
+  end
+
+  # 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('_')
+  end
+
+  # Convert to lower-kebab-case.
+  def to_lkebab
+    ukebab = self.to_ukebab
+    ukebab.downcase
+  end
+
+  # 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('-')
+  end
+
+  # Convert to lower space case.
+  def to_lspace
+    uspace = self.to_uspace
+    uspace.downcase
+  end
+
+  # 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(' ')
+  end
+
+  # Convert to lower.dot.case.
+  def to_ldot
+    udot = self.to_udot
+    udot.downcase
+  end
+
+  # 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('.')
+  end
+
+  # 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
+  end
+
+  # Make first character lower case.
+  def make_head_lower
+    self[0].downcase + self[1..-1]
+  end
+
+end

data/lib/string_foundation/convert.rb

@@ -0,0 +1,51 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - CONVERT
+# ==============================================================================
+# frozen_string_literal: true
+require_relative 'convertible'
+require_relative 'like'
+require_relative 'with'
+class String
+
+  # Convert to TrueClass or FalseClass.
+  def to_bool
+    unless self.to_bool?
+      raise TypeError.new("#{self} cannot be converted to TrueClass or FalseClass")
+    end
+
+    (self == 'true')
+  end
+
+  # Convert a booly string to TrueClass or FalseClass.
+  def to_booly
+    unless self.to_booly?
+      raise TypeError.new("#{self} cannot be converted to TrueClass or FalseClass")
+    end
+
+    return true if self == 'true'  || (self.to_f? && self.to_f > 0)
+    false
+  end
+
+  # Convert to a pretty value.
+  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?
+
+    (self.length > 0) ? self : nil
+  end
+
+  # Convert from newline character to specific characters.
+  def nl_to(char)
+    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>')
+  end
+
+  alias_method :nl2, :nl_to
+  alias_method :nl2br, :nl_to_br
+end

data/lib/string_foundation/convertible.rb

@@ -0,0 +1,40 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - CONVERTIBLE
+# ==============================================================================
+# frozen_string_literal: true
+require_relative 'with'
+class String
+
+  # Whether or not to be possible to covert String to Integer.
+  def to_i?
+    Integer(Float(self.without_leading_zeros))
+    true
+  rescue ArgumentError
+    false
+  end
+
+  # Whether or not to be possible to covert String to Float.
+  def to_f?
+    Float(self.without_leading_zeros)
+    true
+  rescue ArgumentError
+    false
+  end
+
+  # Whether or not to be possible to covert String to Boolean.
+  def to_bool?
+    return true if %w(true false).include?(self)
+    false
+  end
+
+  # Whether or not to be possible to covert String to something which behaves
+  # like boolean types.
+  def to_booly?
+    return true if self.length == 0
+    return true if %w(true false).include?(self)
+    return true if self.to_f?
+
+    false
+  end
+
+end

data/lib/string_foundation/like.rb

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

data/lib/string_foundation/version.rb

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

data/lib/string_foundation/with.rb

@@ -0,0 +1,26 @@
+# ==============================================================================
+# LIB - STRING FOUNDATION - WITH
+# ==============================================================================
+# frozen_string_literal: true
+class String
+
+  # Remove leading zeros.
+  def without_leading_zeros
+    return self if self == '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 = '0' + sig if sig.start_with?('.') || sig.length == 0
+      sig = '-' + sig if is_negative && sig != '0'
+
+      sig
+    else
+      self
+    end
+  end
+
+  alias_method :without_zero_pad, :without_leading_zeros
+end

data/lib/string_foundation.rb

@@ -0,0 +1,6 @@
+# ==============================================================================
+# 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 }

data/spec/spec_helper.rb

@@ -0,0 +1,40 @@
+# ==============================================================================
+# 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']
+  SimpleCov.formatter = SimpleCov::Formatter::Codecov
+else
+  SimpleCov.formatters = [
+    SimpleCov::Formatter::HTMLFormatter,
+    SimpleCov::Formatter::Console,
+  ]
+end
+SimpleCov.start
+
+# Require core files.
+require 'bundler/setup'
+require 'string_foundation'
+require 'support/enhanced_matchers_extension'
+
+# Require components.
+require 'random_token'
+
+# ------------------------------------------------------------------------------
+# RSpec Settings
+# ------------------------------------------------------------------------------
+RSpec.configure do |config|
+  config.include EnhancedMatchersExtension
+
+  # Enable flags like --only-failures and --next-failure .
+  config.example_status_persistence_file_path = '.rspec_status'
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end