dot notation in manual

[quangv]

I wanted to use mustache to iterate through arrays. I found the following, about dot notations.

{{.}}

It would seem that dot notations is part of mustache, but it's not found in the manual.

Two part question.

1. Is mustache-5 the main manual?
2. Should dot-notation be part of the manual?

Thanks, mustache is awesome btw :)

[pvande]

The man pages are definitely in need of some lovin'. We'll make sure that dot-notation gets into the next draft -- thanks!

[quangv]

Couple of cool other things that could add to manual (assuming these are supported and not just hacks)

Object Dot Notation works with Nested Objects

vars = {team : {mascot : 'cat'}}

{{team.mascot}}

Array Numeric Lookup

(though this is obvious, since most langs arrays are objects)

vars = {count:[[10, [1,2,3]]]}

{{0}}
{{#1}}
  {{.}}
{{/1}}

Dot Notation can be Iterated

vars = {
  test:[
    ['yes', 'no']
  ]
}

{{#test}}
  {{#.}}
    {{.}}
  {{/.}}
{{/test}}

Top-Level Arrays

vars = [{name:'cat'},{name:'dog'}]

{{#.}}
  {{name}}
{{/.}}

-reference

Any other cool features not yet documented in manual?

[kaldari]

Could someone on the mustache team at least comment about whether the features above are meant to be publicly used or if they are non-standard hacks that should not be relied upon?

[kaldari]

It looks like the dot notation, at least, is not in the mustache spec (https://github.com/mustache/spec).

[bobthecow]

Depending on what you mean by "dot notation"...

if you mean the {{.}} thing above, that's an "implicit iterator", and it's covered in the spec here.

if you mean actual dot notation, e.g. {{foo.bar.baz}}, it's covered in the spec here and here.

[jpo-tu]

We'll make sure that dot-notation gets into the next draft

Nothing about this in https://mustache.github.io/mustache.5.html