Documentation of HCL and REGEX

Question

I saw in the plantuml repository that a description for EBNF existed and that there was now a reference from README.md to it (pull request #1275  thanks  @The-Lu).

In the plantuml code I saw also that there are possibilities for:

- regex, probably related to the question https://forum.plantuml.net/17112/regex-railroad-diagrams?show=17112#q17112,

- hcl, no idea what it is / where hcl stands for.

Are there for this:

- example(s)

- documentation

Comments

Great start!

Cant wait to see more as it gets flushed out...

I would suggest the same start/end indicators as in ebnf.

Great job so far!

---

I think named groups and backreferences might be a major stumbling block when you get to it, so rather then wait:

https://www.regular-expressions.info/refext.html

---

hcl is just a specific kind of json document for configuring go applications...

I would suggest since json is already supported, this is not needed.

---

The big areas missing so far...

1. Unicode... /u /x and /p escapes
2. Range qualifiers a{1,5} ... 1 to 5 "a" characters
3. Rendering of groups... I would expect comment to draw a box around the left item, and add a yellow note

See 

• http://alphadoc.plantuml.com/doc/markdown/en/regex

---

Great job so far... I see two things that would need fixed.
1: unicode symbols are not working/displayed.
2: group like things need work
I suggest we wrap these group things in something that looks like a package in a class diagram (a box around the group that indicates details about the group).... this also applies for repetitions (ie: this thing 5 or more times), but would just need to look a bit different so one could tell the 2 apart.

I THINK those 2 things MAY wrap things up... if not, it would probably be very close... to the point that the remaining issues might actually be good enough for most people.

See alphadoc for more details, and as always let us know if you have questions!

Answer 1

Hello A., and all,

That's a call for papers..

If you want to contribute, here are some beginning for those topics:

• http://alphadoc.plantuml.com/doc/markdown/en/regex

@startregex
repetitionZeroOrMore: a*
@endregex

• http://alphadoc.plantuml.com/doc/markdown/en/hcl

@starthcl
{
key = "value"
}
@endhcl

Enjoy,
Regards,
Th.

Comments

Hello A., T., and all,

HCL is the HashiCorp Configuration Language or Human Configuration Language.

Ref.:

• https://github.com/hashicorp/hcl
• https://www.linode.com/docs/guides/introduction-to-hcl/
• https://www.octopus.com/blog/state-of-config-file-formats
• https://www.hcl2json.com

Good dev... good doc...
Regards.

---

Regex is really undocumented, but should work.

Here is a simple not working example: 

@startregex
(?:[%s]*\\{([^{}]*)\\})?
@endregex

Regards.

---

Thanks, we're going to have a look at it!

---

I was expecting only one regex per diagram...

Although you might want to allow them to be embedded in others (ebnf for example).

So the only first... need to think about that.

---

Was not what I was expecting, but... why not seems fine to me.