I’d love to know which of these are optional. I’m also getting an error when trying to import: Missing required property: type_: Test. Has the format of that changed at all since that post?
AFAIK there must not be a line feed at EOF. Yep, don't ask me why. Everybody who thinks a file without a proper ending is still a valid file should be locked up and never design SW. I don't even want to start with the good ol' POSIX standard.
(Laurent, please don't take my statement personally. It probably happened as a result of how JS handles files.)
@laurent Maybe we can improve this. It should accept a proper file for import. I find it rather weird that one has to deliberately create a broken file to be able to import.
Almost all properties are optional I think, except for type_. Maybe just try starting from a valid file and removing the properties one by one and see if it still imports.
The raw format is specific to the app and not meant to be user editable, so there's definitely no plan to make the format more user friendly.
If anything I'd rather make it less user friendly to make it clear it shouldn't be edited with a text editor, especially editors that auto-format everything as seems to be common these days.
If the API is not enough and you really have to generate these files, the best is to write a script that does it properly for you.
In that case it should be a binary format and not a text file. But if it had to be a text file, something like json would be more appropriate. Maybe BSON?