apollo-rs
apollo-rs copied to clipboard
Consider re-introducing lints to apollo-rs
In apollo-compiler 0.11 validation returns a Vec that can contain:
- Any number of error-level diagnostics
- A warning for enum value definitions with non-uppercase names
- An "advice" for custom scalar definitions without an
@specifiedBydirective
To find out if a document is valid, callers need to iterate the vec and find if any of the diagnostic return true for .is_error().
In apollo-compiler 1.0 (in beta as of this writing) the API changes so that the library does that filtering and returns Result::Err for invalid documents. However as discussed starting at https://github.com/apollographql/apollo-rs/issues/709#issuecomment-1814923975 returning potential warnings and advice for a valid document makes the API awkward. Since they arguably don’t belong in validate() in the first place, they could be moved to a separate lint() method.
But with only two rules, this linter would not be very valuable and we don’t expect many users to go out of their way to call it explicitly.
An upcoming will therefore remove these two non-error rules from apollo-compiler entirely. This issue keeps a record of this regression of functionality. These two rule could be restored one day if we want to seriously work on having a GraphQL linter as part of apollo-rs.
Here is something that would be a useful "warning" lint while it's not a spec validation error: https://github.com/graphql/graphql-spec/pull/1053
Defining an interface without defining any implementers could also be a warning.
Isn't the linked PR changing the spec to make it a validation error? It would only be a warning until the spec change is adopted (assuming it is)
yes! i meant "while" as in, "during the time that" it's not an error