Class: Sass::Script::Functions::EvaluationContext

Inherits:
Object
  • Object
show all
Includes:
Sass::Script::Functions, Value::Helpers
Defined in:
lib/sass/script/functions.rb

Overview

The context in which methods in Sass::Script::Functions are evaluated. That means that all instance methods of EvaluationContext are available to use in functions.

Constant Summary collapse

TYPE_NAMES =

The human-readable names for [Sass::Script::Value::Base]. The default is just the downcased name of the type.

{:ArgList => 'variable argument list'}

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Value::Helpers

#bool, #calc?, #hex_color, #hsl_color, #list, #map, #null, #number, #parse_complex_selector, #parse_compound_selector, #parse_selector, #quoted_string, #rgb_color, #special_number?, #unquoted_string, #var?

Methods included from Sass::Script::Functions

#abs, #adjust_color, #adjust_hue, #alpha, #append, #blue, #call, #ceil, #change_color, #comparable, #complement, #content_exists, #counter, #counters, #darken, declare, #desaturate, #feature_exists, #floor, #function_exists, #get_function, #global_variable_exists, #grayscale, #green, #hsl, #hsla, #hue, #ie_hex_str, #if, #index, #inspect, #invert, #is_bracketed, #is_superselector, #join, #keywords, #length, #lighten, #lightness, #list_separator, #map_get, #map_has_key, #map_keys, #map_merge, #map_remove, #map_values, #max, #min, #mix, #mixin_exists, #nth, #opacify, #opacity, #percentage, #quote, #random, random_number_generator, random_seed=, #red, #rgb, #rgba, #round, #saturate, #saturation, #scale_color, #selector_append, #selector_extend, #selector_nest, #selector_parse, #selector_replace, #selector_unify, #set_nth, signature, #simple_selectors, #str_index, #str_insert, #str_length, #str_slice, #to_lower_case, #to_upper_case, #transparentize, #type_of, #unique_id, #unit, #unitless, #unquote, #variable_exists, #zip

Constructor Details

#initialize(environment) ⇒ EvaluationContext

Returns a new instance of EvaluationContext.

Parameters:



514
515
516
517
# File 'lib/sass/script/functions.rb', line 514

def initialize(environment)
  @environment = environment
  @options = environment.options
end

Instance Attribute Details

#environmentEnvironment (readonly)

The environment for this function. This environment's Environment#parent is the global environment, and its Environment#caller is a read-only view of the local environment of the caller of this function.

Returns:



506
507
508
# File 'lib/sass/script/functions.rb', line 506

def environment
  @environment
end

#options{Symbol => Object} (readonly)

The options hash for the Engine that is processing the function call

Returns:

  • ({Symbol => Object})


511
512
513
# File 'lib/sass/script/functions.rb', line 511

def options
  @options
end

Instance Method Details

#assert_integer(number, name = nil)

Asserts that the value is an integer.

Examples:

assert_integer 2px
assert_integer 2.5px
  => SyntaxError: "Expected 2.5px to be an integer"
assert_integer 2.5px, "width"
  => SyntaxError: "Expected width to be an integer but got 2.5px"

Parameters:

  • number (Sass::Script::Value::Base)

    The value to be validated.

  • name (::String) (defaults to: nil)

    The name of the parameter being validated.

Raises:

  • (ArgumentError)

    if number is not an integer or is not a number.



588
589
590
591
592
593
594
595
596
# File 'lib/sass/script/functions.rb', line 588

def assert_integer(number, name = nil)
  assert_type number, :Number, name
  return if number.int?
  if name
    raise ArgumentError.new("Expected $#{name} to be an integer but got #{number}")
  else
    raise ArgumentError.new("Expected #{number} to be an integer")
  end
end

#assert_type(value, type, name = nil)

Asserts that the type of a given SassScript value is the expected type (designated by a symbol).

Valid types are :Bool, :Color, :Number, and :String. Note that :String will match both double-quoted strings and unquoted identifiers.

Examples:

assert_type value, :String
assert_type value, :Number

Parameters:

  • value (Sass::Script::Value::Base)

    A SassScript value

  • type (Symbol, Array<Symbol>)

    The name(s) of the type the value is expected to be

  • name (String, Symbol, nil) (defaults to: nil)

    The name of the argument.

Raises:

  • (ArgumentError)

    if value is not of the correct type.



533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
# File 'lib/sass/script/functions.rb', line 533

def assert_type(value, type, name = nil)
  valid_types = Array(type)
  found_type = valid_types.find do |t|
    value.is_a?(Sass::Script::Value.const_get(t)) ||
      t == :Map && value.is_a?(Sass::Script::Value::List) && value.value.empty?
  end

  if found_type
    value.check_deprecated_interp if found_type == :String
    return
  end

  err = if valid_types.size == 1
          "#{value.inspect} is not a #{TYPE_NAMES[type] || type.to_s.downcase}"
        else
          type_names = valid_types.map {|t| TYPE_NAMES[t] || t.to_s.downcase}
          "#{value.inspect} is not any of #{type_names.join(', ')}"
        end
  err = "$#{name.to_s.tr('_', '-')}: " + err if name
  raise ArgumentError.new(err)
end

#assert_unit(number, unit, name = nil)

Asserts that the unit of the number is as expected.

Examples:

assert_unit number, "px"
assert_unit number, nil

Parameters:

  • number (Sass::Script::Value::Number)

    The number to be validated.

  • unit (::String)

    The unit that the number must have. If nil, the number must be unitless.

  • name (::String) (defaults to: nil)

    The name of the parameter being validated.

Raises:

  • (ArgumentError)

    if number is not of the correct unit or is not a number.



566
567
568
569
570
571
572
573
574
575
# File 'lib/sass/script/functions.rb', line 566

def assert_unit(number, unit, name = nil)
  assert_type number, :Number, name
  return if number.is_unit?(unit)
  expectation = unit ? "have a unit of #{unit}" : "be unitless"
  if name
    raise ArgumentError.new("Expected $#{name} to #{expectation} but got #{number}")
  else
    raise ArgumentError.new("Expected #{number} to #{expectation}")
  end
end