File: //usr/share/rubygems-integration/all/gems/sassc-2.4.0/lib/sassc/script/value/string.rb
# frozen_string_literal: true
class SassC::Script::Value::String < SassC::Script::Value
# The Ruby value of the string.
attr_reader :value
# Whether this is a CSS string or a CSS identifier.
# The difference is that strings are written with double-quotes,
# while identifiers aren't.
#
# @return [Symbol] `:string` or `:identifier`
attr_reader :type
# Returns the quoted string representation of `contents`.
#
# @options opts :quote [String]
# The preferred quote style for quoted strings. If `:none`, strings are
# always emitted unquoted. If `nil`, quoting is determined automatically.
# @options opts :sass [String]
# Whether to quote strings for Sass source, as opposed to CSS. Defaults to `false`.
def self.quote(contents, opts = {})
quote = opts[:quote]
# Short-circuit if there are no characters that need quoting.
unless contents =~ /[\n\\"']|\#\{/
quote ||= '"'
return "#{quote}#{contents}#{quote}"
end
if quote.nil?
if contents.include?('"')
if contents.include?("'")
quote = '"'
else
quote = "'"
end
else
quote = '"'
end
end
# Replace single backslashes with multiples.
contents = contents.gsub("\\", "\\\\\\\\")
# Escape interpolation.
contents = contents.gsub('#{', "\\\#{") if opts[:sass]
if quote == '"'
contents = contents.gsub('"', "\\\"")
else
contents = contents.gsub("'", "\\'")
end
contents = contents.gsub(/\n(?![a-fA-F0-9\s])/, "\\a").gsub("\n", "\\a ")
"#{quote}#{contents}#{quote}"
end
# Creates a new string.
#
# @param value [String] See \{#value}
# @param type [Symbol] See \{#type}
# @param deprecated_interp_equivalent [String?]
# If this was created via a potentially-deprecated string interpolation,
# this is the replacement expression that should be suggested to the user.
def initialize(value, type = :identifier)
super(value)
@type = type
end
# @see Value#plus
def plus(other)
if other.is_a?(SassC::Script::Value::String)
other_value = other.value
else
other_value = other.to_s(:quote => :none)
end
SassC::Script::Value::String.new(value + other_value, type)
end
# @see Value#to_s
def to_s(opts = {})
return @value.gsub(/\n\s*/, ' ') if opts[:quote] == :none || @type == :identifier
self.class.quote(value, opts)
end
# @see Value#to_sass
def to_sass(opts = {})
to_s(opts.merge(:sass => true))
end
def inspect
String.quote(value)
end
end