What about schemas?

[lppedd]

Just came across this project through Reddit, and from a first look it doesn't appear to support schemas.
Then a question arises: how do we ensure a configuration follows a specific format? Plus, without schemas we are not able to develop better editing tools/experiences.

[antonmedv]

There is multiple things to ensure the configuration following a specific format JSON Schema, for example. I might introduce a new spec for MAML Schema in the future. But for now I think different approach is needed.

In most programming languages, you don't want just a schema validator. You want an ability to unmarshall bytes into your data structures. For example zod, pydantic. The idea is you not only validating your incoming data but also getting ready to use objects. This is why for MAML php I created a schema validator built in into the package. This MAML schema validator even can generate JSON schema.

In the future I may introduce MAML Schema, but not right now. I think JSON Schemas can cover bunch of use cases.

[DavidSeptimus]

The MAML IntelliJ plugin supports JSON Schema for MAML by reusing an existing JetBrains ecosystem pattern to convert MAML PSI trees to a "json-like" representation that the IDE's JSON schema infrastructure can evaluate. I don't know if that sort of infrastructure exists in other editor/IDE environments, but that's one potential pattern to extend JSON Schema support to other environments without too much overhead.

[antonmedv]

This is amazing and works extremely well for deployer users. Are they now using both MAML recipes and the JSON Schema defs.

[DavidSeptimus]

It seems RedHat's YAML language server implementation implements this general concept internally, so it might be a good reference to look at if you want similar functionality in other environments.

https://github.com/redhat-developer/yaml-language-server/tree/main/src/languageservice

[antonmedv]

Nice, for sure we need to develop a MAML language server.