Module: Lazier::String

Extended by:
ActiveSupport::Concern
Defined in:
lib/lazier/string.rb

Overview

Extensions for the String class.

Instance Method Summary collapse

Instance Method Details

#ensure_url_with_scheme(protocol = "http", secure: false) ⇒ Object

Makes sure the string starts with the scheme for the specified protocol.

Parameters:

  • protocol (String) (defaults to: "http") —

    The protocol for the URL.

  • secure (Boolean) (defaults to: false) —

    If the scheme should be secure or not.



24
25
26
27
 
# File 'lib/lazier/string.rb', line 24

def ensure_url_with_scheme(protocol = "http", secure: false)
  schema = protocol + (secure ? "s" : "")
  self !~ /^(#{protocol}(s?):\/\/)/ ? "#{schema}://#{self}" : self
end

#ensure_valid_utf8(replacement = "") ⇒ String

Makes sure the string only contains valid UTF-8 sequences.

Parameters:

  • replacement (String) (defaults to: "") —

    The string to use to replace invalid sequences.

Returns:

  • (String) —

    The string with any invalid UTF-8 sequences replaced.



15
16
17
18
 
# File 'lib/lazier/string.rb', line 15

def ensure_valid_utf8(replacement = "")
  # This odd line is because if need to specify a different encoding (without losing infos) to replace invalid bytes and then we go back to utf-8
  encode("utf-16", invalid: :replace, undef: :replace, replace: replacement).encode("utf-8")
end

#remove_accents ⇒ Object

Removes accents from the string, normalizing to the normal letter.

"èòàù".remove_accents
# => "eoau"

Returns:

  • The string with all accents removed.



60
61
62
 
# File 'lib/lazier/string.rb', line 60

def remove_accents
  ::I18n.transliterate(self)
end

#tokenize(no_blanks: true, strip: true, no_duplicates: false, pattern: /\s*,\s*/, presence_method: :present?) ⇒ Array

Splits a string containing tokens using a specified pattern and applying some sanitizations.

Parameters:

  • no_blanks (Boolean) (defaults to: true) —

    If filter out blank tokens.

  • strip (Boolean) (defaults to: true) —

    If strip single tokens.

  • no_duplicates (Boolean) (defaults to: false) —

    If return uniques elements.

  • pattern (String|Regexp) (defaults to: /\s*,\s*/) —

    The pattern to use.

  • presence_method (Symbol) (defaults to: :present?) —

    The method to use to check if a token is present or not.

Returns:

  • (Array) —

    An array of tokens.



44
45
46
47
48
49
50
 
# File 'lib/lazier/string.rb', line 44

def tokenize(no_blanks: true, strip: true, no_duplicates: false, pattern: /\s*,\s*/, presence_method: :present?)
  rv = split(pattern)
  rv.map!(&:strip) if strip
  rv.select!(&presence_method) if no_blanks
  rv.uniq! if no_duplicates
  rv
end

#value ⇒ String

Returns the string itself for use in form helpers.

Returns:

  • (String) —

    The string itself.



32
33
34
 
# File 'lib/lazier/string.rb', line 32

def value
  self
end