Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update meta schema #30

Closed
wants to merge 22 commits into from
Closed

Update meta schema #30

wants to merge 22 commits into from

Conversation

nvnieuwk
Copy link
Collaborator

@nvnieuwk nvnieuwk commented May 3, 2024

This PR updates the meta schema to work with the new features introduced in JSON schema draft 2020-12.

Stuff that still needs to be done:

Comment on lines 77 to 118
"enum": ["file-path", "directory-path", "path", "file-path-pattern"]
"enum": [
"file-path",
"directory-path",
"path",
"file-path-pattern",
"date-time",
"date",
"time",
"duration",
"email",
"idn-email",
"hostname",
"id-hostname",
"ipv4",
"ipv6",
"uuid",
"uri",
"uri-reference",
"iri",
"iri-reference",
"uri-template",
"json-pointer",
"regex"
]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think that we do want all of these though.

Although JSON schema libraries can validate them, the launch form / schema builder / other tooling wouldn't know what to do with them.

Not sure that there's any point allowing them for validation if they will break other tooling. Any of these things can still be set as a string without format being set.

Copy link
Collaborator Author

@nvnieuwk nvnieuwk May 6, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure having the other tooling break on an unknown format is that great of an idea. Maybe they should just ignore the formats that are unknown. Some of these formats could be really useful for nextflow pipelines I think (regex, email and uri to name a few). Although I do agree that some don't make any sense to be in here.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure having the other tooling break on an unknown format is that great of an idea.

If they're listed here then other tooling would accept the schema but then not know what to do with the format and either ignore it or break. So I'm suggesting slimming it down for the same reason 😅

My expectation of how this will work is that tools will check the schema against the meta schema and show a warning if it fails. So for example:

Warning: Schema seems invalid - value 'ipv6' not allowed for 'format'

It would then hopefully still continue to try to use the schema as best it can. Which I think is better than including them all, not knowing in advance, and then breaking.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay so I think these make the most sense to keep:

[
                          "file-path",
                          "directory-path",
                          "path",
                          "file-path-pattern",
                          "date-time",
                          "date",
                          "time",
                          "email",
                          "uri",
                          "regex"
                        ]

Do you agree or should I also remove the ones that aren't built-in to the plugin?

@nvnieuwk
Copy link
Collaborator Author

Note to self: Use this site to test the meta schema with as much examples as possible: https://www.jsonschemavalidator.net/

@nvnieuwk
Copy link
Collaborator Author

@ewels I think the schema is ready now. Just one thing left: do we want to support nested parameters right now too or should we keep this for later?

@nvnieuwk nvnieuwk marked this pull request as draft February 12, 2025 09:32
mashehu added a commit to mashehu/schema-spec that referenced this pull request Feb 18, 2025
mashehu added a commit to mashehu/schema-spec that referenced this pull request Feb 18, 2025
Co-authored by: Nicolas Vannieuwkerke <[email protected]>
@nvnieuwk
Copy link
Collaborator Author

This has been moved to https://github.com/nextflow-io/schema-spec

@nvnieuwk nvnieuwk closed this Feb 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants