@quobix/vacuum 0.27.3 → 0.28.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -85
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-

|
|
1
|
+

|
|
2
2
|
|
|
3
3
|
# vacuum - The world's fastest OpenAPI and JSON Schema linter.
|
|
4
4
|
|
|
@@ -135,7 +135,20 @@ come say hi!
|
|
|
135
135
|
|
|
136
136
|
## Documentation
|
|
137
137
|
|
|
138
|
-
🔥 **New in** `v0.
|
|
138
|
+
🔥 **New in** `v0.28` 🔥: **Lint JSON Schema documents in vacuum**
|
|
139
|
+
|
|
140
|
+
A new `schema` command has been added that opens up vacuum to JSON Schema specific linting rules and checks!
|
|
141
|
+
With a whole new set of functions and rules, specifically for JSON Schema documents.
|
|
142
|
+
|
|
143
|
+
Try it out on your own JSON Schema docs! with `vacuum schema`
|
|
144
|
+
|
|
145
|
+
- [Read more about JSON Schema linting in vacuum](https://quobix.com/vacuum/json-schema/)
|
|
146
|
+
- [Read the available `schema` command options](https://quobix.com/vacuum/commands/schema/)
|
|
147
|
+
- [See the new recommended JSON Schema ruleset](https://quobix.com/vacuum/rulesets/json-schema-recommended/)
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
`v0.27`: **Generate OpenAPI Documentation in vacuum**
|
|
139
152
|
|
|
140
153
|
A new `docs` command will generate the **best OpenAPI Documentation you ever saw**! Now vacuum has
|
|
141
154
|
integrated with [the printing press](https://github.com/pb33f/printing-press), it means
|
|
@@ -215,88 +228,6 @@ vs individually.
|
|
|
215
228
|
|
|
216
229
|
---
|
|
217
230
|
|
|
218
|
-
`v0.21`: **Change detection filtering**
|
|
219
|
-
|
|
220
|
-
Want to see linting results on **just** the changes you have made to an OpenAPI document? Or want to see just the results on the differences between two documents?
|
|
221
|
-
comes with a **what changed** mode. Using the new `--original` and `--changes-summary` global flags, you can filter out all the noise.
|
|
222
|
-
|
|
223
|
-
[documentation for change detection](https://quobix.com/vacuum/commands/change-detection/) is available to learn more.
|
|
224
|
-
|
|
225
|
-
vacuum now supports [JSON Path Plus](https://github.com/JSONPath-Plus/JSONPath) annotations. This means that vacuum is
|
|
226
|
-
compliant with **All Spectral Paths**. One of the last remaining gaps between vacuum and spectral has been closed.
|
|
227
|
-
|
|
228
|
-
[See all the newly supported annotations](https://quobix.com/vacuum/rulesets/custom-rulesets/#anatomy-of-a-rule)
|
|
229
|
-
|
|
230
|
-
---
|
|
231
|
-
|
|
232
|
-
`v0.20`: **Support for auto fixing custom rules**
|
|
233
|
-
|
|
234
|
-
Got some rules that don't really need a human to look at?
|
|
235
|
-
|
|
236
|
-
Well now you can define an `AutoFixFunction` for your rules, and when you run with the `--fix` flag, the fixes will be applied to the file, or use `--fix-file` to write them to a different file.
|
|
237
|
-
|
|
238
|
-
See [Auto-Fixing Rule Violations](#auto-fixing-rule-violations) for more specifics.
|
|
239
|
-
|
|
240
|
-
---
|
|
241
|
-
|
|
242
|
-
`v0.19`: **Ignore rules with `x-lint-ignore`**
|
|
243
|
-
|
|
244
|
-
Got an error in your spec you know about but can't get round to fixing yet?
|
|
245
|
-
Migrating from zally and wanting to keep your existing `x-zally-ignore` issues silenced?
|
|
246
|
-
|
|
247
|
-
Now you can! Just add `x-lint-ignore: rule-id` to the yaml node reporting the failure (or `x-lint-ignore: [rule-one, rule-two]` if there are multiple issues to ignore).
|
|
248
|
-
|
|
249
|
-
---
|
|
250
|
-
|
|
251
|
-
`v0.18`: **New dashboard, new lint command, new rules!**.
|
|
252
|
-
|
|
253
|
-
Upgrades all around. There is a completely new `dashboard` command with a completely new dashboard terminal UI. It's
|
|
254
|
-
completely interactive and allows you to explore, and filter violations, view full docs and see code. The `dashboard` command
|
|
255
|
-
also adds a new `-w` / `--watch` flag that will watch your OpenAPI file for changes and re-lint and re-render results automatically.
|
|
256
|
-
|
|
257
|
-
A re-written `lint` command that has a whole new rendering engine and output. Everything is much more readable,
|
|
258
|
-
easier to see on a screen, matches the new `dashboard` style. It's 100% backwards compatible with previous versions, all flags as they were.
|
|
259
|
-
|
|
260
|
-
New rules:
|
|
261
|
-
|
|
262
|
-
- [no-request-body](https://quobix.com/vacuum/rules/operations/no-request-body/) - Ensures `GET` and `DELETE` operations do not have request bodies.
|
|
263
|
-
- [duplicate-paths](https://quobix.com/vacuum/rules/operations/duplicate-paths/) - Ensures there are no duplicate paths exist
|
|
264
|
-
- [no-unnecessary-combinator](https://quobix.com/vacuum/rules/schemas/no-unnecessary-combinator/) - Ensures no `allOf`, `oneOf` or `anyOf` combinators exist with a single schema inside them.
|
|
265
|
-
- [camel-case-properties](https://quobix.com/vacuum/rules/schemas/camel-case-properties/) - Ensures all schema properties are `camelCase`.
|
|
266
|
-
|
|
267
|
-
---
|
|
268
|
-
|
|
269
|
-
`v0.17`: **GitHub Action**.
|
|
270
|
-
|
|
271
|
-
vacuum now has an official GitHub Action. [Read the docs](https://quobix.com/vacuum/github-action/), or check it out
|
|
272
|
-
in the [GitHub Marketplace](https://github.com/marketplace/actions/vacuum-openapi-linter-and-quality-analysis-tool).
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
`v0.16.11`: **Composed bundling mode**.
|
|
278
|
-
|
|
279
|
-
A different way to bundle exploded OpenAPI specifications into a single file. [Read the docs](https://quobix.com/vacuum/commands/bundle/).
|
|
280
|
-
|
|
281
|
-
---
|
|
282
|
-
|
|
283
|
-
`v0.16+` : **RFC 9535 Compliant**.
|
|
284
|
-
|
|
285
|
-
`v0.21+` : **JSON Path Plus Support**.
|
|
286
|
-
|
|
287
|
-
vacuum now supports both [RFC 9535](https://www.rfc-editor.org/rfc/rfc9535) JSONPath and **JSON Path Plus** extensions - full Spectral compatibility!
|
|
288
|
-
|
|
289
|
-
---
|
|
290
|
-
|
|
291
|
-
`v0.15+`: **Fixes, New Rules, Functions and Command**.
|
|
292
|
-
|
|
293
|
-
There is a new command `generate-ignorefile` that will generate an ignore file from a linting report.
|
|
294
|
-
|
|
295
|
-
New rule `no-request-body` checks for incorrect request bodies in operations, and `path-item-refs` checks for
|
|
296
|
-
$refs being incorrectly used on operations within path items (only the path item itself may use $ref).
|
|
297
|
-
|
|
298
|
-
---
|
|
299
|
-
|
|
300
231
|
### [Quick Start Guide 🚀](https://quobix.com/vacuum/start)
|
|
301
232
|
|
|
302
233
|
See all the documentation at https://quobix.com/vacuum
|
|
@@ -385,7 +316,7 @@ you can explore broken rules and violations, but in your browser.
|
|
|
385
316
|
|
|
386
317
|
No external dependencies, the HTML report will run completely offline.
|
|
387
318
|
|
|
388
|
-

|
|
319
|
+

|
|
389
320
|
|
|
390
321
|
---
|
|
391
322
|
|