haml 4.0.7 → 5.0.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/.gitignore +18 -0
- data/.gitmodules +3 -0
- data/.travis.yml +54 -0
- data/.yardopts +1 -1
- data/CHANGELOG.md +96 -4
- data/FAQ.md +4 -14
- data/Gemfile +19 -0
- data/MIT-LICENSE +1 -1
- data/README.md +80 -42
- data/REFERENCE.md +116 -64
- data/Rakefile +46 -54
- data/TODO +24 -0
- data/benchmark.rb +66 -0
- data/haml.gemspec +38 -0
- data/lib/haml/.gitattributes +1 -0
- data/lib/haml/attribute_builder.rb +163 -0
- data/lib/haml/attribute_compiler.rb +223 -0
- data/lib/haml/attribute_parser.rb +148 -0
- data/lib/haml/buffer.rb +22 -132
- data/lib/haml/compiler.rb +89 -298
- data/lib/haml/engine.rb +25 -41
- data/lib/haml/error.rb +3 -0
- data/lib/haml/escapable.rb +49 -0
- data/lib/haml/exec.rb +38 -19
- data/lib/haml/filters.rb +18 -24
- data/lib/haml/generator.rb +41 -0
- data/lib/haml/helpers/action_view_extensions.rb +3 -2
- data/lib/haml/helpers/action_view_mods.rb +42 -60
- data/lib/haml/helpers/action_view_xss_mods.rb +1 -0
- data/lib/haml/helpers/safe_erubi_template.rb +19 -0
- data/lib/haml/helpers/safe_erubis_template.rb +4 -1
- data/lib/haml/helpers/xss_mods.rb +18 -12
- data/lib/haml/helpers.rb +132 -89
- data/lib/haml/options.rb +41 -47
- data/lib/haml/parser.rb +278 -216
- data/lib/haml/{template/plugin.rb → plugin.rb} +8 -15
- data/lib/haml/railtie.rb +38 -12
- data/lib/haml/sass_rails_filter.rb +17 -4
- data/lib/haml/template/options.rb +12 -2
- data/lib/haml/template.rb +12 -6
- data/lib/haml/temple_engine.rb +121 -0
- data/lib/haml/temple_line_counter.rb +29 -0
- data/lib/haml/util.rb +80 -199
- data/lib/haml/version.rb +2 -1
- data/lib/haml.rb +1 -0
- data/yard/default/.gitignore +1 -0
- data/yard/default/fulldoc/html/css/common.sass +15 -0
- data/yard/default/layout/html/footer.erb +12 -0
- metadata +50 -111
- data/test/engine_test.rb +0 -2013
- data/test/erb/_av_partial_1.erb +0 -12
- data/test/erb/_av_partial_2.erb +0 -8
- data/test/erb/action_view.erb +0 -62
- data/test/erb/standard.erb +0 -55
- data/test/filters_test.rb +0 -254
- data/test/gemfiles/Gemfile.rails-3.0.x +0 -5
- data/test/gemfiles/Gemfile.rails-3.1.x +0 -6
- data/test/gemfiles/Gemfile.rails-3.2.x +0 -5
- data/test/gemfiles/Gemfile.rails-4.0.x +0 -5
- data/test/haml-spec/LICENSE +0 -14
- data/test/haml-spec/README.md +0 -106
- data/test/haml-spec/lua_haml_spec.lua +0 -38
- data/test/haml-spec/perl_haml_test.pl +0 -81
- data/test/haml-spec/ruby_haml_test.rb +0 -23
- data/test/haml-spec/tests.json +0 -660
- data/test/helper_test.rb +0 -583
- data/test/markaby/standard.mab +0 -52
- data/test/mocks/article.rb +0 -6
- data/test/parser_test.rb +0 -105
- data/test/results/content_for_layout.xhtml +0 -12
- data/test/results/eval_suppressed.xhtml +0 -9
- data/test/results/helpers.xhtml +0 -70
- data/test/results/helpful.xhtml +0 -10
- data/test/results/just_stuff.xhtml +0 -70
- data/test/results/list.xhtml +0 -12
- data/test/results/nuke_inner_whitespace.xhtml +0 -40
- data/test/results/nuke_outer_whitespace.xhtml +0 -148
- data/test/results/original_engine.xhtml +0 -20
- data/test/results/partial_layout.xhtml +0 -5
- data/test/results/partial_layout_erb.xhtml +0 -5
- data/test/results/partials.xhtml +0 -21
- data/test/results/render_layout.xhtml +0 -3
- data/test/results/silent_script.xhtml +0 -74
- data/test/results/standard.xhtml +0 -162
- data/test/results/tag_parsing.xhtml +0 -23
- data/test/results/very_basic.xhtml +0 -5
- data/test/results/whitespace_handling.xhtml +0 -90
- data/test/template_test.rb +0 -354
- data/test/templates/_av_partial_1.haml +0 -9
- data/test/templates/_av_partial_1_ugly.haml +0 -9
- data/test/templates/_av_partial_2.haml +0 -5
- data/test/templates/_av_partial_2_ugly.haml +0 -5
- data/test/templates/_layout.erb +0 -3
- data/test/templates/_layout_for_partial.haml +0 -3
- data/test/templates/_partial.haml +0 -8
- data/test/templates/_text_area.haml +0 -3
- data/test/templates/_text_area_helper.html.haml +0 -4
- data/test/templates/action_view.haml +0 -47
- data/test/templates/action_view_ugly.haml +0 -47
- data/test/templates/breakage.haml +0 -8
- data/test/templates/content_for_layout.haml +0 -8
- data/test/templates/eval_suppressed.haml +0 -11
- data/test/templates/helpers.haml +0 -55
- data/test/templates/helpful.haml +0 -11
- data/test/templates/just_stuff.haml +0 -85
- data/test/templates/list.haml +0 -12
- data/test/templates/nuke_inner_whitespace.haml +0 -32
- data/test/templates/nuke_outer_whitespace.haml +0 -144
- data/test/templates/original_engine.haml +0 -17
- data/test/templates/partial_layout.haml +0 -3
- data/test/templates/partial_layout_erb.erb +0 -4
- data/test/templates/partialize.haml +0 -1
- data/test/templates/partials.haml +0 -12
- data/test/templates/render_layout.haml +0 -2
- data/test/templates/silent_script.haml +0 -45
- data/test/templates/standard.haml +0 -43
- data/test/templates/standard_ugly.haml +0 -43
- data/test/templates/tag_parsing.haml +0 -21
- data/test/templates/very_basic.haml +0 -4
- data/test/templates/whitespace_handling.haml +0 -87
- data/test/test_helper.rb +0 -81
- data/test/util_test.rb +0 -63
@@ -1,31 +1,24 @@
|
|
1
|
+
# frozen_string_literal: true
|
1
2
|
module Haml
|
2
3
|
|
3
4
|
# This module makes Haml work with Rails using the template handler API.
|
4
|
-
class Plugin
|
5
|
-
|
6
|
-
# Rails 3.1+, template handlers don't inherit from anything. In <= 3.0, they
|
7
|
-
# do. To avoid messy logic figuring this out, we just inherit from whatever
|
8
|
-
# the ERB handler does.
|
9
|
-
|
10
|
-
# In Rails 3.1+, we don't need to include Compilable.
|
11
|
-
if (ActionPack::VERSION::MAJOR == 3) && (ActionPack::VERSION::MINOR < 1)
|
12
|
-
include ActionView::Template::Handlers::Compilable
|
13
|
-
end
|
14
|
-
|
5
|
+
class Plugin
|
15
6
|
def handles_encoding?; true; end
|
16
7
|
|
17
8
|
def compile(template)
|
18
9
|
options = Haml::Template.options.dup
|
19
|
-
if
|
10
|
+
if template.respond_to?(:type)
|
20
11
|
options[:mime_type] = template.type
|
21
12
|
elsif template.respond_to? :mime_type
|
22
13
|
options[:mime_type] = template.mime_type
|
23
14
|
end
|
24
15
|
options[:filename] = template.identifier
|
25
|
-
Haml::Engine.new(template.source, options).compiler.precompiled_with_ambles(
|
16
|
+
Haml::Engine.new(template.source, options).compiler.precompiled_with_ambles(
|
17
|
+
[],
|
18
|
+
after_preamble: '@output_buffer = output_buffer ||= ActionView::OutputBuffer.new if defined?(ActionView::OutputBuffer)',
|
19
|
+
)
|
26
20
|
end
|
27
21
|
|
28
|
-
# In Rails 3.1+, #call takes the place of #compile
|
29
22
|
def self.call(template)
|
30
23
|
new.compile(template)
|
31
24
|
end
|
@@ -38,4 +31,4 @@ module Haml
|
|
38
31
|
end
|
39
32
|
end
|
40
33
|
|
41
|
-
ActionView::Template.register_template_handler(:haml, Haml::Plugin)
|
34
|
+
ActionView::Template.register_template_handler(:haml, Haml::Plugin)
|
data/lib/haml/railtie.rb
CHANGED
@@ -1,22 +1,48 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
1
|
+
# frozen_string_literal: true
|
2
|
+
require 'haml/template/options'
|
3
|
+
|
4
|
+
# check for a compatible Rails version when Haml is loaded
|
5
|
+
if (activesupport_spec = Gem.loaded_specs['activesupport'])
|
6
|
+
if activesupport_spec.version.to_s < '3.2'
|
7
|
+
raise Exception.new("\n\n** Haml now requires Rails 3.2 and later. Use Haml version 4.0.4\n\n")
|
7
8
|
end
|
8
9
|
end
|
9
10
|
|
10
11
|
module Haml
|
12
|
+
module Filters
|
13
|
+
module RailsErb
|
14
|
+
extend Plain
|
15
|
+
extend TiltFilter
|
16
|
+
extend PrecompiledTiltFilter
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
11
20
|
class Railtie < ::Rails::Railtie
|
12
21
|
initializer :haml do |app|
|
13
|
-
|
14
|
-
|
15
|
-
|
22
|
+
ActiveSupport.on_load(:action_view) do
|
23
|
+
require "haml/template"
|
24
|
+
|
25
|
+
if defined?(::Sass::Rails::SassTemplate) && app.config.assets.enabled
|
26
|
+
require "haml/sass_rails_filter"
|
27
|
+
end
|
28
|
+
|
29
|
+
# Any object under ActionView::Template will be defined as the root constant with the same
|
30
|
+
# name if it exists. If Erubi is loaded at all, ActionView::Template::Handlers::ERB::Erubi
|
31
|
+
# will turn out to be a reference to the ::Erubi module.
|
32
|
+
# In Rails 4.2, calling const_defined? results in odd exceptions, which seems to be
|
33
|
+
# solved by looking for ::Erubi first.
|
34
|
+
# However, in JRuby, the const_defined? finds it anyway, so we must make sure that it's
|
35
|
+
# not just a reference to ::Erubi.
|
36
|
+
if defined?(::Erubi) && const_defined?('ActionView::Template::Handlers::ERB::Erubi') &&
|
37
|
+
ActionView::Template::Handlers::ERB::Erubi != ::Erubi
|
38
|
+
require "haml/helpers/safe_erubi_template"
|
39
|
+
Haml::Filters::RailsErb.template_class = Haml::SafeErubiTemplate
|
40
|
+
else
|
41
|
+
require "haml/helpers/safe_erubis_template"
|
42
|
+
Haml::Filters::RailsErb.template_class = Haml::SafeErubisTemplate
|
43
|
+
end
|
44
|
+
Haml::Template.options[:filters] = { 'erb' => Haml::Filters::RailsErb }
|
16
45
|
end
|
17
46
|
end
|
18
47
|
end
|
19
48
|
end
|
20
|
-
|
21
|
-
require "haml/helpers/safe_erubis_template"
|
22
|
-
Haml::Filters::Erb.template_class = Haml::SafeErubisTemplate
|
@@ -1,11 +1,24 @@
|
|
1
|
+
# frozen_string_literal: true
|
1
2
|
module Haml
|
2
3
|
module Filters
|
3
4
|
# This is an extension of Sass::Rails's SassTemplate class that allows
|
4
5
|
# Rails's asset helpers to be used inside Haml Sass filter.
|
5
6
|
class SassRailsTemplate < ::Sass::Rails::SassTemplate
|
6
|
-
|
7
|
-
scope
|
8
|
-
|
7
|
+
if Gem::Version.new(Sprockets::VERSION) >= Gem::Version.new('3.0.0')
|
8
|
+
def render(scope=Object.new, locals={}, &block)
|
9
|
+
environment = ::Sprockets::Railtie.build_environment(::Rails.application)
|
10
|
+
scope = environment.context_class.new(
|
11
|
+
environment: environment,
|
12
|
+
filename: "/",
|
13
|
+
metadata: {}
|
14
|
+
)
|
15
|
+
super
|
16
|
+
end
|
17
|
+
else
|
18
|
+
def render(scope=Object.new, locals={}, &block)
|
19
|
+
scope = ::Rails.application.assets.context_class.new(::Rails.application.assets, "/", "/")
|
20
|
+
super
|
21
|
+
end
|
9
22
|
end
|
10
23
|
|
11
24
|
def sass_options(scope)
|
@@ -30,4 +43,4 @@ module Haml
|
|
30
43
|
register_tilt_filter "Sass", :extend => "Css", :template_class => SassRailsTemplate
|
31
44
|
register_tilt_filter "Scss", :extend => "Css", :template_class => ScssRailsTemplate
|
32
45
|
end
|
33
|
-
end
|
46
|
+
end
|
@@ -1,3 +1,4 @@
|
|
1
|
+
# frozen_string_literal: true
|
1
2
|
# We keep options in its own self-contained file
|
2
3
|
# so that we can load it independently in Rails 3,
|
3
4
|
# where the full template stuff is lazy-loaded.
|
@@ -6,11 +7,20 @@ module Haml
|
|
6
7
|
module Template
|
7
8
|
extend self
|
8
9
|
|
9
|
-
|
10
|
+
class Options < Hash
|
11
|
+
def []=(key, value)
|
12
|
+
super
|
13
|
+
if Haml::Options.buffer_defaults.key?(key)
|
14
|
+
Haml::Options.buffer_defaults[key] = value
|
15
|
+
end
|
16
|
+
end
|
17
|
+
end
|
18
|
+
|
19
|
+
@options = ::Haml::Template::Options.new
|
10
20
|
# The options hash for Haml when used within Rails.
|
11
21
|
# See {file:REFERENCE.md#options the Haml options documentation}.
|
12
22
|
#
|
13
|
-
# @return [
|
23
|
+
# @return [Haml::Template::Options<Symbol => Object>]
|
14
24
|
attr_accessor :options
|
15
25
|
end
|
16
26
|
end
|
data/lib/haml/template.rb
CHANGED
@@ -1,12 +1,19 @@
|
|
1
|
+
# frozen_string_literal: true
|
1
2
|
require 'haml/template/options'
|
2
|
-
|
3
|
-
|
4
|
-
require 'haml/helpers/
|
3
|
+
if defined?(ActiveSupport)
|
4
|
+
ActiveSupport.on_load(:action_view) do
|
5
|
+
require 'haml/helpers/action_view_mods'
|
6
|
+
require 'haml/helpers/action_view_extensions'
|
7
|
+
end
|
8
|
+
else
|
9
|
+
require 'haml/helpers/action_view_mods'
|
10
|
+
require 'haml/helpers/action_view_extensions'
|
11
|
+
end
|
5
12
|
require 'haml/helpers/xss_mods'
|
6
13
|
require 'haml/helpers/action_view_xss_mods'
|
7
14
|
|
8
15
|
module Haml
|
9
|
-
class
|
16
|
+
class TempleEngine
|
10
17
|
def precompiled_method_return_value_with_haml_xss
|
11
18
|
"::Haml::Util.html_safe(#{precompiled_method_return_value_without_haml_xss})"
|
12
19
|
end
|
@@ -26,7 +33,6 @@ module Haml
|
|
26
33
|
end
|
27
34
|
|
28
35
|
|
29
|
-
Haml::Template.options[:ugly] = defined?(Rails) ? !Rails.env.development? : true
|
30
36
|
Haml::Template.options[:escape_html] = true
|
31
37
|
|
32
|
-
require 'haml/
|
38
|
+
require 'haml/plugin'
|
@@ -0,0 +1,121 @@
|
|
1
|
+
# frozen_string_literal: false
|
2
|
+
require 'temple'
|
3
|
+
require 'haml/escapable'
|
4
|
+
require 'haml/generator'
|
5
|
+
|
6
|
+
module Haml
|
7
|
+
class TempleEngine < Temple::Engine
|
8
|
+
define_options(
|
9
|
+
attr_wrapper: "'",
|
10
|
+
autoclose: %w(area base basefont br col command embed frame
|
11
|
+
hr img input isindex keygen link menuitem meta
|
12
|
+
param source track wbr),
|
13
|
+
encoding: nil,
|
14
|
+
escape_attrs: true,
|
15
|
+
escape_html: false,
|
16
|
+
filename: '(haml)',
|
17
|
+
format: :html5,
|
18
|
+
hyphenate_data_attrs: true,
|
19
|
+
line: 1,
|
20
|
+
mime_type: 'text/html',
|
21
|
+
preserve: %w(textarea pre code),
|
22
|
+
remove_whitespace: false,
|
23
|
+
suppress_eval: false,
|
24
|
+
cdata: false,
|
25
|
+
parser_class: ::Haml::Parser,
|
26
|
+
compiler_class: ::Haml::Compiler,
|
27
|
+
trace: false,
|
28
|
+
filters: {},
|
29
|
+
)
|
30
|
+
|
31
|
+
use :Parser, -> { options[:parser_class] }
|
32
|
+
use :Compiler, -> { options[:compiler_class] }
|
33
|
+
use Escapable
|
34
|
+
filter :ControlFlow
|
35
|
+
filter :MultiFlattener
|
36
|
+
filter :StaticMerger
|
37
|
+
use Generator
|
38
|
+
|
39
|
+
def compile(template)
|
40
|
+
initialize_encoding(template, options[:encoding])
|
41
|
+
@precompiled = call(template)
|
42
|
+
end
|
43
|
+
|
44
|
+
# The source code that is evaluated to produce the Haml document.
|
45
|
+
#
|
46
|
+
# This is automatically converted to the correct encoding
|
47
|
+
# (see {file:REFERENCE.md#encodings the `:encoding` option}).
|
48
|
+
#
|
49
|
+
# @return [String]
|
50
|
+
def precompiled
|
51
|
+
encoding = Encoding.find(@encoding || '')
|
52
|
+
return @precompiled.force_encoding(encoding) if encoding == Encoding::ASCII_8BIT
|
53
|
+
return @precompiled.encode(encoding)
|
54
|
+
end
|
55
|
+
|
56
|
+
def precompiled_with_return_value
|
57
|
+
"#{precompiled};#{precompiled_method_return_value}"
|
58
|
+
end
|
59
|
+
|
60
|
+
# The source code that is evaluated to produce the Haml document.
|
61
|
+
#
|
62
|
+
# This is automatically converted to the correct encoding
|
63
|
+
# (see {file:REFERENCE.md#encodings the `:encoding` option}).
|
64
|
+
#
|
65
|
+
# @return [String]
|
66
|
+
def precompiled_with_ambles(local_names, after_preamble: '')
|
67
|
+
preamble = <<END.tr!("\n", ';')
|
68
|
+
begin
|
69
|
+
extend Haml::Helpers
|
70
|
+
_hamlout = @haml_buffer = Haml::Buffer.new(haml_buffer, #{Options.new(options).for_buffer.inspect})
|
71
|
+
_erbout = _hamlout.buffer
|
72
|
+
#{after_preamble}
|
73
|
+
END
|
74
|
+
postamble = <<END.tr!("\n", ';')
|
75
|
+
#{precompiled_method_return_value}
|
76
|
+
ensure
|
77
|
+
@haml_buffer = @haml_buffer.upper if @haml_buffer
|
78
|
+
end
|
79
|
+
END
|
80
|
+
"#{preamble}#{locals_code(local_names)}#{precompiled}#{postamble}"
|
81
|
+
end
|
82
|
+
|
83
|
+
private
|
84
|
+
|
85
|
+
def initialize_encoding(template, given_value)
|
86
|
+
if given_value
|
87
|
+
@encoding = given_value
|
88
|
+
else
|
89
|
+
@encoding = Encoding.default_internal || template.encoding
|
90
|
+
end
|
91
|
+
end
|
92
|
+
|
93
|
+
# Returns the string used as the return value of the precompiled method.
|
94
|
+
# This method exists so it can be monkeypatched to return modified values.
|
95
|
+
def precompiled_method_return_value
|
96
|
+
"_erbout"
|
97
|
+
end
|
98
|
+
|
99
|
+
def locals_code(names)
|
100
|
+
names = names.keys if Hash === names
|
101
|
+
|
102
|
+
names.each_with_object('') do |name, code|
|
103
|
+
# Can't use || because someone might explicitly pass in false with a symbol
|
104
|
+
sym_local = "_haml_locals[#{inspect_obj(name.to_sym)}]"
|
105
|
+
str_local = "_haml_locals[#{inspect_obj(name.to_s)}]"
|
106
|
+
code << "#{name} = #{sym_local}.nil? ? #{str_local} : #{sym_local};"
|
107
|
+
end
|
108
|
+
end
|
109
|
+
|
110
|
+
def inspect_obj(obj)
|
111
|
+
case obj
|
112
|
+
when String
|
113
|
+
%Q!"#{obj.gsub(/[\x00-\x7F]+/) {|s| s.inspect[1...-1]}}"!
|
114
|
+
when Symbol
|
115
|
+
":#{inspect_obj(obj.to_s)}"
|
116
|
+
else
|
117
|
+
obj.inspect
|
118
|
+
end
|
119
|
+
end
|
120
|
+
end
|
121
|
+
end
|
@@ -0,0 +1,29 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
module Haml
|
3
|
+
# A module to count lines of expected code. This would be faster than actual code generation
|
4
|
+
# and counting newlines in it.
|
5
|
+
module TempleLineCounter
|
6
|
+
class UnexpectedExpression < StandardError; end
|
7
|
+
|
8
|
+
def self.count_lines(exp)
|
9
|
+
type, *args = exp
|
10
|
+
case type
|
11
|
+
when :multi
|
12
|
+
args.map { |a| count_lines(a) }.reduce(:+) || 0
|
13
|
+
when :dynamic, :code
|
14
|
+
args.first.count("\n")
|
15
|
+
when :static
|
16
|
+
0 # It has not real newline "\n" but escaped "\\n".
|
17
|
+
when :case
|
18
|
+
arg, *cases = args
|
19
|
+
arg.count("\n") + cases.map do |cond, e|
|
20
|
+
(cond == :else ? 0 : cond.count("\n")) + count_lines(e)
|
21
|
+
end.reduce(:+)
|
22
|
+
when :escape
|
23
|
+
count_lines(args[1])
|
24
|
+
else
|
25
|
+
raise UnexpectedExpression.new("[HAML BUG] Unexpected Temple expression '#{type}' is given!")
|
26
|
+
end
|
27
|
+
end
|
28
|
+
end
|
29
|
+
end
|