# frozen_string_literal: true module Liquid # Templates are central to liquid. # Interpretating templates is a two step process. First you compile the # source code you got. During compile time some extensive error checking is performed. # your code should expect to get some SyntaxErrors. # # After you have a compiled template you can then render it. # You can use a compiled template over and over again and keep it cached. # # Example: # # template = Liquid::Template.parse(source) # template.render('user_name' => 'bob') # class Template attr_accessor :root, :name attr_reader :resource_limits, :warnings class TagRegistry include Enumerable def initialize @tags = {} @cache = {} end def [](tag_name) return nil unless @tags.key?(tag_name) return @cache[tag_name] if Liquid.cache_classes lookup_class(@tags[tag_name]).tap { |o| @cache[tag_name] = o } end def []=(tag_name, klass) @tags[tag_name] = klass.name @cache[tag_name] = klass end def delete(tag_name) @tags.delete(tag_name) @cache.delete(tag_name) end def each(&block) @tags.each(&block) end private def lookup_class(name) Object.const_get(name) end end attr_reader :profiler class << self # Sets how strict the parser should be. # :lax acts like liquid 2.5 and silently ignores malformed tags in most cases. # :warn is the default and will give deprecation warnings when invalid syntax is used. # :strict will enforce correct syntax. attr_accessor :error_mode Template.error_mode = :lax attr_accessor :default_exception_renderer Template.default_exception_renderer = lambda do |exception| exception end attr_accessor :file_system Template.file_system = BlankFileSystem.new attr_accessor :tags Template.tags = TagRegistry.new private :tags= def register_tag(name, klass) tags[name.to_s] = klass end # Pass a module with filter methods which should be available # to all liquid views. Good for registering the standard library def register_filter(mod) StrainerFactory.add_global_filter(mod) end attr_accessor :default_resource_limits Template.default_resource_limits = {} private :default_resource_limits= # creates a new Template object from liquid source code # To enable profiling, pass in profile: true as an option. # See Liquid::Profiler for more information def parse(source, options = {}) new.parse(source, options) end end def initialize @rethrow_errors = false @resource_limits = ResourceLimits.new(Template.default_resource_limits) end # Parse source code. # Returns self for easy chaining def parse(source, options = {}) parse_context = configure_options(options) source = source.to_s.to_str unless source.valid_encoding? raise TemplateEncodingError, parse_context.locale.t("errors.syntax.invalid_template_encoding") end tokenizer = parse_context.new_tokenizer(source, start_line_number: @line_numbers && 1) @root = Document.parse(tokenizer, parse_context) self end def registers @registers ||= {} end def assigns @assigns ||= {} end def instance_assigns @instance_assigns ||= {} end def errors @errors ||= [] end # Render takes a hash with local variables. # # if you use the same filters over and over again consider registering them globally # with Template.register_filter # # if profiling was enabled in Template#parse then the resulting profiling information # will be available via Template#profiler # # Following options can be passed: # # * filters : array with local filters # * registers : hash with register variables. Those can be accessed from # filters and tags and might be useful to integrate liquid more with its host application # def render(*args) return '' if @root.nil? context = case args.first when Liquid::Context c = args.shift if @rethrow_errors c.exception_renderer = Liquid::RAISE_EXCEPTION_LAMBDA end c when Liquid::Drop drop = args.shift drop.context = Context.new([drop, assigns], instance_assigns, registers, @rethrow_errors, @resource_limits) when Hash Context.new([args.shift, assigns], instance_assigns, registers, @rethrow_errors, @resource_limits) when nil Context.new(assigns, instance_assigns, registers, @rethrow_errors, @resource_limits) else raise ArgumentError, "Expected Hash or Liquid::Context as parameter" end output = nil case args.last when Hash options = args.pop output = options[:output] if options[:output] static_registers = context.registers.static options[:registers]&.each do |key, register| static_registers[key] = register end apply_options_to_context(context, options) when Module, Array context.add_filters(args.pop) end # Retrying a render resets resource usage context.resource_limits.reset if @profiling && context.profiler.nil? @profiler = context.profiler = Liquid::Profiler.new end context.template_name ||= name begin # render the nodelist. @root.render_to_output_buffer(context, output || +'') rescue Liquid::MemoryError => e context.handle_error(e) ensure @errors = context.errors end end def render!(*args) @rethrow_errors = true render(*args) end def render_to_output_buffer(context, output) render(context, output: output) end private def configure_options(options) if (profiling = options[:profile]) raise "Profiler not loaded, require 'liquid/profiler' first" unless defined?(Liquid::Profiler) end @options = options @profiling = profiling @line_numbers = options[:line_numbers] || @profiling parse_context = options.is_a?(ParseContext) ? options : ParseContext.new(options) @warnings = parse_context.warnings parse_context end def apply_options_to_context(context, options) context.add_filters(options[:filters]) if options[:filters] context.global_filter = options[:global_filter] if options[:global_filter] context.exception_renderer = options[:exception_renderer] if options[:exception_renderer] context.strict_variables = options[:strict_variables] if options[:strict_variables] context.strict_filters = options[:strict_filters] if options[:strict_filters] end end end