Q: Can I use this in production?
Yes. It’s being used by multiple companies in production today.
Q: Are you actively supporting vacuum?
Yes! There is a lot more to come in the future. It’s an active project with a rich roadmap ahead of it.
Q: Can I sponsor you?
Yes. It’s most welcome and appreciated. please visit the sponsor page for more information.
Companies are encouraged to sponsor vacuum, as it’s a great way to show your support for the project, and get priority support for your issues.
Q: Why do I see a ’local lookups are not permitted’ warning?
It’s probably also telling you to set AllowFileLookup to true in the configuration. What does this mean?
This is vacuum telling you that its detected a local file reference in the OpenAPI specification, and that it’s not going to resolve it without you explicitly telling it to.
This is a safety guard to prevent a run-away malicious resolving incident happening. If you remember Log4Shell You will understand why this is important.
To tell vacuum to resolve the local file, you need to use the -p
or --base
flag that tells vacuum
where to resolve the local file from. You can use .
If the file is in your current working directory.
For example:
Q: Why do I see a ‘remote lookups are not permitted’ warning?
It’s probably also telling you to set AllowRemoteLookup to true in the configuration. What does this mean?
Like with local references, telling you that its detected a remote file reference in the OpenAPI specification, and that it’s not going to resolve it without you explicitly telling it to.
Same reason as local lookups. Log4Shell is a lesson from history.
To tell vacuum to resolve the remote file, you need to use the -p
or --base
flag that tells vacuum
where to resolve the remote reference from.
For example:
Q: Can I use vacuum to lint non-OpenAPI documents?
Yes!
In version v0.2.7
a new Developer API was introduced that allows you to lint any document.
And a new global flag --skip-check
/ -k
was introduced that allows you to skip the OpenAPI checks, which means
any of the core functions can be used to lint any YAML or JSON document.
This is a community requested feature.