Vanilla Haml allows line breaking after commas:

%script{:type => "text/javascript",
        :src  => "javascripts/script_#{2 + 7}"}

This allows breaking long lines (sometimes with nested objects) into multiple lines.

It drastically improves readability and prevents horizontal scrolling.

A switch block like below

- switch ($this->params['action']):
    - case 'edit'
        = $this->Html->tag('label', 'Username')
        = $this->Html->tag('p', $this->data['User']['username'])
        - break
    - case 'add'
        = $this->Form->input('username')
        = $this->Form->input('password')
        - break
- endswitch

is being rendered to

<?php switch ($this->params['action']): { ?>
<?php case 'edit' { ?>
  <?php echo $this->Html->tag('label', 'Username'); ?>
  <?php echo $this->Html->tag('p', $this->data['User']['username']); ?>
  <?php break; ?>
<?php } ?>
<?php case 'add' { ?>
  <?php echo $this->Form->input('username'); ?>
  <?php echo $this->Form->input('password'); ?>
  <?php break; ?>
<?php } ?>
<?php } ?>
<?php endswitch; ?>

which is produce a fatal error.

If switch syntax is not supported yet, I would like to patch a fix for that. Please give me some clue on where should I start.

Hello folks,

for easy integration with the Laravel framework's view system, we'd need two classes: a compiler adapter for Laravel's compiler interface, and a "service provider" to set up the necessary instances (compiler and an instance of MtHaml\Environment).

That would allow for people adding this to their Laravel 4 projects just by adding one line to their composer.json and one line to their config file.

I've got this working locally - if you're interested, I can submit a pull request.

Great package! =)

A proposition to add user filters, see #19

As a proposition, i haven't wrote test right now...

Anatomy of a filter class

Filters should at least implements the MtHaml\Filter\FilterInterface. The best way is to extends your filter from MtHaml\Filter\FilterAbstract.

class PhpFilter extends  MtHaml\Filter\FilterAbstract {

    protected $name = 'php';

    // The renderer is the current renderer instance
    // $options are the environment options
    public function enter($renderer, $options)
    {
        $renderer->write('<?php')->indent();
    }

    /**
     * The parser call this method on each new line.
     * Depending on what you returns:
     * - NodeAbstract Object: the parser will treat "as it is"
     * - String: the Parser will compare the current buffer line and
     *  the string value, then replace the buffer line if String is different
     * - Void: The default parser behavior.
    */
    public function line($buffer, $options)
    {
        // The line will be treated as "raw" text.
        return new Text($buffer->getPosition(), $buffer->getLine());
    }

    // Close the filter
    public function leave($renderer, $options)
    {
        $renderer->write(' ?>'.PHP_EOL)->undent();
    }
}

// Add the filter, The filter will be available under :css
$env = new Environment('php');
$env->addFilter(new PhpFilter);

Adding Filters

1. Through environment configuration:

$filters = array('textile' => 'Path\To\Class', 'saas' => new Saas);
$env = new Environment('php', array(), filters);

1. Through addFilter() method:

// Add filter by class name: the class will be instanciated if filter is used
$env->addFilter('saas', 'Project\\Saas');

// Add filter by instance:
$env->addFilter(new Saas);
// you can override the instance filter name like this:
$env->addFilter('custom', new Saas);

I think I got it - I understand how it works now ! It's a nice job, but I'm still not completely sure I understand ...

I get this exception : External exception (app/themes/yuuki/views/News/index.html.taml) : The function "mthaml_attributes" does not exist in "layouts/layout.html" at line 21

This is my layouts/layout.html file : https://gist.github.com/c9db16e337a254b5e046

Thanks for your fast answer ;)

Example of correct behavior

MtHaml:

- $class = 'bar'
.foo{'class' => $class} Baz

Output:

<div class="foo bar">Baz</div>

Example of buggy behavior

MtHaml:

- $attrs = array('class' = 'bar')
.foo{$attrs} Baz

Expected output:

<div class="foo bar">Baz</div>

This is how vanilla Haml works: http://sassmeister.com/gist/466bdb71c5af3414bbd9

Actual output:

<div class="bar">Baz</div>

Even when disabling escaper and setting escape_attrs to false, dynamic attributes are always escaped in resultant php/html file. Here is my environment options:

array('enable_escaper' => false, 'escape_attrs' => false)

Haml: %div(class="#{body_class()}") %p test

Output: <div <?php echo MtHaml\Runtime::renderAttributes(array(array('class', (body_class()))), 'html5', 'UTF-8'); ?>> <p>test</p> </div>

I would expect it to work just as disabling escaper worked, where the echo is left in directly. So the output would be closer to <div class="<?php echo body_class(); ?>">

Some changes in Object Reference implementation:

1. Scalars are supported, in order to follow original Ruby implementation:

$str = 'hello';
$int = 12;
%div[$str] // generates <div class="string" id="string_hello">
%div[$int] // generates <div class="integer" id="integer_12">

1. Object ids are auto-incremented if there is no id methods. The aim is to prevent html ids collisions. Incrementation is based on class name:

$std = new stdClass;
%div[$std] // generates <div class="std_class" id="std_class_1">
%div[$std] // generates <div class="sdt_class" id="std_class_2">
$foo = new Foo();
%div[$std] // generates <div class="foo" id="foo_1">

1. Object Reference id can be overwritten with hamlObjectRef() method (see #23):

class foo {
  public function hamlObjectRef() {
    return 'customId';
  }
}

4; Uses of is_callable() instead of method_exists(), in order to be sure that method is really callable in given context.

Hi! Yesterday I'm trying to complie very simple template:

!!!
%html
  %head
    %title test
  %body

On Windows it's compiles, but on Ubuntu (XAMPP for Linux 1.8.1) I've got:

preg_match(): Compilation failed: internal error: previously-checked referenced subpattern not found at offset 358 /opt/lampp/htdocs/modules/haml/vendor/MtHaml/Parser/Buffer.php ... 74 if ($count = preg_match($pattern, $this->line, $match, PREG_OFFSET_CAPTURE)) { ...

Currently with PHP environments, it's really difficult to use helpers that already return escaped HTML, for example:

%ul
  %li
    :php
      echo link_to("a", "b");

This PR adds an environment option safe_functions which, for PHP environments, defines a list of functions which will not automatically be htmlspecialcharsd. By default this list is empty. This makes HAML templates much shorter and much more familiar to Ruby developers:

new MtHaml\Environment('php', array('safe_functions' => array('link_to')));

%ul
  %li =link_to("a", "b")

- block content

renders to

{% block content %}

instead of

{% block content %}
{% endblock %}

This works however:

- block content
  Hi

renders to

{% block content %}
  Hi
{% endblock %}

Workaround:

- block content
- endblock

• update haml url, and there was no redirect from old site (haml-lang.com -> haml.info)
• twig url has moved, but there is a redirect still (twig-project.org -> twig.symfony.com)
• update all links to use https

If I have a HAML file that looks like this:

- block body
  !!!
  %html
    %head
      %title = fn('wp_title')
    %body
      - if not fn('is_page','cv')
        something

MtHaml will compile it to this:

{% block body %}
  <!DOCTYPE html>
  <html>
    <head>
      <title>{{ fn('wp_title') }}</title>
    </head>
    <body>
{% line 7 %}      {% if not fn('is_page','cv') %}
        something
      {% endif %}
    </body>
  </html>
{% endblock %}

MtHaml is adding these line numbers in places, like {% line 7 %}.

When using HAML and Twig together , HAML like the following fails :

- set styles = loadStyles(["bootstrap" , "main" , "other_css" , "fontawesome"])
!!! 5
%html(lang="fa")
  %head
    %meta(charset="UTF-8")
    %meta(name="description" content="Free Web tutorials")
    %meta(name="keywords" content="HTML,CSS,XML,JavaScript")
    %meta(name="author" content="My name")
    %meta(name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no")
    %title
      Page Title
    - for style in styles
      = style
  %body
    -# Navbar section start
    %header.sticky-top
      %nav.navbar.navbar-expand-lg.navbar-light.bg-white.shadow-sm.border-bottom
        .container
          %a.navbar-brand(href="#{getHomeURL()}")
            %img(src="#{getImageUrl('logo.png')}" alt="#{getBlogInfo('name')}")
          %button.navbar-toggler(type="button" ){:data => {:toggle => "collapse" , :target => "#navbarSupportedContent"} ,
                                                 :aria => {:controls => "navbarSupportedContent" , :expanded => "false" , :lable => "Toggle navigation"}}
            %span.navbar-toggler-icon

The resulting exception is : Fatal error: Uncaught Twig\Error\SyntaxError: A hash key must be a quoted string, a number, a name, or an expression enclosed in parentheses (unexpected token "punctuation" of value ":" in "main.haml" at line 21. in path\vendor\twig\twig\src\ExpressionParser.php on line 386

When using HAML and Twig to render our templates, we have run into an issue that allows XSS.

- set name = '"><script>alert(1);</script>'

%input(value=name)

The compiled template is:

{% set name = '"><script>alert(1);</script>' %}
<input {{ mthaml_attributes([['value', name]], 'html5', 'UTF-8', false)|raw }}>

We are using the Symfony bundle, which disables escaping by default.

Is there anything we need to do to prevent this?

I'm using Laravel 5.7 clean installation, and while trying to add this package with composer, add it to the app.php as Service Provider. The template is giving: "a nesting within interpolated string is illegal in site". Any ideas how to solve this? It seems php 7.1 related.

HAML like the following fails:

%a(href="#{Namespace\ClassName\::CLASS_CONSTANT}") Label

The resulting exception is MtHaml\Exception\SyntaxErrorException in vendor/mthaml/mthaml/lib/MtHaml/Parser.php on line 844 with message: Unexpected '"', expected target language expression in /var/www/content-vendor/app/templates/generic/components/topbar.haml on line x, column xx