gura-conf / gura Goto Github PK

In the documentation here: https://gura.netlify.app/docs/spec/#variables
is written: "booleans are not allowed as variable value"

but in section "imports" in the listing of "two.ura"
there is this line: $my_var: true
which is a boolean value on a variable.

Other than that it seems like a very thoughtful config file format.

serde_gura will serialize the following without question, but it will throw an error if you attempt to deserialize it:

resumable_shards:
    0:
        session_id: "xxxx"
        sequence: 2

It panics here.

The docs say there's only one way to define a key, so what is a "bare" key?

With other formats there is .json, .yaml/.yml and .toml. It was a bit odd to see .ura here, but I assume that's to provide a typical 3 char extension? Any reason to not support .gura?

.gura seems to fair better currently on google searches than .ura.

Although... I suppose .gura could be confused with a programming language called Gura too..:

The installer will set up all the necessary files as well as edit the registry to assign file extensions .gura, .guraw, .gurc and .gurcw as executable ones.

Still, .ura seems a bit odd 😅

Will the format also include .gura as a file extension, perhaps keeping preference to .ura if necessary? Or is more than one supported extension a concern you want to avoid?

Hello there and thanks for this good stuff !

The following snippet fails to parse, with "Expected end of string but got m at line 4 position 0".
If I add a trailing comma after last sub-array, all is fine.

Gura was installed via pip.

Could you please have a look ?

model:
    columns: [
        [ "var1", "str" ],
        [ "var2", "str" ]
    ]

With #3 closed, there's only really one thing in the JSON data model that you can't represent in Gura, and that's objects with keys that don't conform to the normal requirements.

If Gura intetionally doesn't support this, then it might be a good idea to specify, as part of the spec, what generic serializers/deserializers should do when provided such keys, so that behaviour can be standardised.

eg.

• Error.
• Convert to a valid name according to some predefined rules.
• Something else?

Hello! I have created a Gura parser for Dart and wanted to see if you'd like to add it to the list of implementations.

The source is available here:
https://github.com/zajrik/gura-dart-parser

and the package is available here:
https://pub.dev/packages/gura

This is largely a port of the official TypeScript parser but I've done a lot of cleaning up, refactoring, and internal documentation to help myself better understand the inner mechanics, as well as make some things work in Dart that can't translate directly from TS/JS.

I look forward to hearing from you.

Consider this modified version of the example for arrays from https://gura.netlify.app/:

tango_singers: [
    name: "Carlos"
    surname: "Gardel"
    year_of_birth: 1890,
    name: "Aníbal"
    surname: "Troilo"
    year_of_birth: 1914
]

it contains two objects, but the comma is very easy to miss. If a comma is the only only way to split elements of an array, it might be better to recommend formatting arrays of objects like:

tango_singers: [
    name: "Carlos"
    surname: "Gardel"
    year_of_birth: 1890
    ,
    name: "Aníbal"
    surname: "Troilo"
    year_of_birth: 1914
]

If I were to have a value such as 0b0011 (a valid hex colour) what stops it being read as binary and just parsed as 3?

Not sure if this is intended or not, but given that Gura otherwise uses the same data model as JSON, it will cause problems when translating between them.