1
0
Fork 0
mirror of https://github.com/haml/haml.git synced 2022-11-09 12:33:31 -05:00
HTML Abstraction Markup Language - A Markup Haiku
Find a file
2015-12-01 23:19:53 +09:00
benchmark Update benchmark suite for CI 2015-12-01 23:06:02 +09:00
bin Update benchmark suite for CI 2015-12-01 23:06:02 +09:00
exe Create hamlit CLI 2015-10-24 20:32:19 +09:00
ext/hamlit Faster Hamlit::AttributeBuilder.build by C extension 2015-11-29 22:11:29 +09:00
lib Version 2.0.1 2015-11-30 21:56:26 +09:00
sample Change sinatra sample to work 2015-11-21 06:42:31 +09:00
test Implement data builder with C extension 2015-11-29 16:36:26 +09:00
.gitignore Prepare extension in C 2015-11-26 01:07:06 +09:00
.gitmodules Add houdini as submodule 2015-11-28 01:39:51 +09:00
.travis.yml Update benchmark suite for CI 2015-12-01 23:06:02 +09:00
CHANGELOG.md Cosmetic fixes for CHANGELOG.md 2015-12-01 23:19:53 +09:00
Gemfile Fix Gemfile to run with Ruby 2.0 2015-11-23 02:53:56 +09:00
hamlit.gemspec Submodules are not added 2015-11-30 21:55:21 +09:00
LICENSE.txt Vendoring Haml modules for parser 2015-11-19 16:21:54 +09:00
Rakefile Create rake bench task 2015-11-30 21:00:06 +09:00
README.md Update benchmark result 2015-11-30 22:15:31 +09:00
REFERENCE.md Fix wording in reference 2015-11-28 19:54:00 +09:00

Hamlit

Gem Version Build Status

Hamlit is a high performance Haml implementation.

Introduction

What is Hamlit?

Hamlit is another implementation of Haml. With some limitations by design for performance, Hamlit is 8.54x times faster than original haml gem in this benchmark, which is an HTML-escaped version of slim-template/slim's one for fairness. (Result on Travis)

Hamlit Benchmark

       hamlit v2.0.1:   122622.3 i/s
         faml v0.7.0:    94239.1 i/s - 1.30x slower
         slim v3.0.6:    89143.0 i/s - 1.38x slower
       erubis v2.7.0:    65047.8 i/s - 1.89x slower
  haml v5.0.0.beta.2:    14363.6 i/s - 8.54x slower

Why is Hamlit faster?

Less string concatenation by design

As written in limitations, Hamlit drops some not-so-important features which require works on runtime. With the optimized language design, we can reduce the string concatenation to build attributes.

Temple optimizers

Hamlit is built with Temple, which is a framework to build template engines and also used in Slim. By using the framework and its optimizers, Hamlit can reduce string allocation and concatenation easily.

Static analyzer

Hamlit analyzes Ruby expressions with Ripper and render it on compilation if the expression is static. And Hamlit can also compile string literal with string interpolation to reduce string allocation and concatenation on runtime.

C extension to build attributes

While Hamlit has static analyzer and static attributes are rendered on compilation, dynamic attributes must be rendered on runtime. So Hamlit optimizes rendering on runtime with C extension.

Usage

See REFERENCE.md for detail features of Hamlit.

Rails

Add this line to your application's Gemfile or just replace gem "haml" with gem "hamlit". It enables rendering by Hamlit for *.haml automatically.

gem 'hamlit'

If you want to use view generator, consider using hamlit-rails.

Sinatra

Replace gem "haml" with gem "hamlit" in Gemfile, and require "hamlit". See sample/sinatra for working sample.

While Haml disables escape_html option by default, Hamlit enables it for security. If you want to disable it, please write:

set :haml, { escape_html: false }

Command line interface

You can see compiled code or rendering result with "hamlit" command.

$ gem install hamlit
$ hamlit --help
Commands:
  hamlit compile HAML    # Show compile result
  hamlit help [COMMAND]  # Describe available commands or one specific command
  hamlit parse HAML      # Show parse result
  hamlit render HAML     # Render haml template
  hamlit temple HAML     # Show temple intermediate expression

$ cat in.haml
- user_id = 123
%a{ href: "/users/#{user_id}" }

# Show compiled code
$ hamlit compile in.haml
_buf = [];  user_id = 123;
; _buf << ("<a href='/users/".freeze); _buf << (::Hamlit::Utils.escape_html((user_id))); _buf << ("'></a>\n".freeze); _buf = _buf.join

# Render html
$ hamlit render in.haml
<a href='/users/123'></a>

Contributing

Development

Contributions are welcomed. It'd be good to see Temple's EXPRESSIONS.md to learn Temple which is a template engine framework used in Hamlit.

$ git clone https://github.com/k0kubun/hamlit
$ cd hamlit
$ bundle install

# Run all tests
$ bundle exec rake test

# Run one test
$ bundle exec ruby -Ilib:test -rtest_helper test/hamlit/line_number_test.rb -l 12

# Show compiling/rendering result of some template
$ bundle exec exe/hamlit compile in.haml
$ bundle exec exe/hamlit render in.haml

# Use rails app to debug Hamlit
$ cd sample/rails
$ bundle install
$ bundle exec rails s

Reporting an issue

Please report an issue with following information:

  • Full error backtrace
  • Haml template
  • Ruby version
  • Hamlit version
  • Rails/Sinatra version

License

Copyright (c) 2015 Takashi Kokubun