@quobix/vacuum 0.28.3 → 0.29.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 +27 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|

|
|
2
2
|
|
|
3
|
-
# vacuum - The world's fastest OpenAPI and JSON Schema linter.
|
|
3
|
+
# vacuum - The world's fastest OpenAPI, AsyncAPI and JSON Schema linter.
|
|
4
4
|
|
|
5
5
|

|
|
6
6
|
[](https://goreportcard.com/report/github.com/daveshanley/vacuum)
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
[](https://hub.docker.com/r/dshanley/vacuum)
|
|
11
11
|
[](https://github.com/avelino/awesome-go)
|
|
12
12
|
|
|
13
|
-
An **ultra-super-fast**, lightweight OpenAPI linter and quality checking tool, written in golang and inspired by [Spectral](https://github.com/stoplightio/spectral).
|
|
13
|
+
An **ultra-super-fast**, lightweight OpenAPI, AsyncAPI and JSON Schema linter and quality checking tool, written in golang and inspired by [Spectral](https://github.com/stoplightio/spectral).
|
|
14
14
|
|
|
15
15
|
It's **fully compatible** with existing [Spectral](https://github.com/stoplightio/spectral) rulesets.
|
|
16
16
|
|
|
@@ -99,7 +99,8 @@ vacuum upgrade
|
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
vacuum will detect the install path and use the matching upgrade mechanism when it can. Normal commands may also show an
|
|
102
|
-
update notice when a newer stable release is available.
|
|
102
|
+
update notice when a newer stable release is available. The passive check keeps only a small temporary cache in the OS temp
|
|
103
|
+
directory, refreshed at most every 12 hours. Use `--no-update-check` or `VACUUM_NO_UPDATE_CHECK=true` to skip that check.
|
|
103
104
|
|
|
104
105
|
---
|
|
105
106
|
|
|
@@ -135,6 +136,19 @@ come say hi!
|
|
|
135
136
|
|
|
136
137
|
## Documentation
|
|
137
138
|
|
|
139
|
+
🔥 **New in** `v0.29` 🔥: **Lint AsyncAPI 3 documents in vacuum**
|
|
140
|
+
|
|
141
|
+
[AsyncAPI](https://www.asyncapi.com) is now a first-class document type in vacuum, alongside OpenAPI and JSON Schema.
|
|
142
|
+
Use the normal `lint` command and vacuum will detect AsyncAPI 3 documents automatically.
|
|
143
|
+
|
|
144
|
+
- [Read more about AsyncAPI linting in vacuum](https://quobix.com/vacuum/asyncapi/)
|
|
145
|
+
- [See the default AsyncAPI ruleset](https://quobix.com/vacuum/rulesets/asyncapi-recommended/)
|
|
146
|
+
- [See every built-in AsyncAPI rule](https://quobix.com/vacuum/rulesets/asyncapi/)
|
|
147
|
+
- [Generate an AsyncAPI ruleset](https://quobix.com/vacuum/commands/generate-ruleset/)
|
|
148
|
+
- [See the AsyncAPI functions](https://quobix.com/vacuum/functions/asyncapi/)
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
138
152
|
🔥 **New in** `v0.28` 🔥: **Lint JSON Schema documents in vacuum**
|
|
139
153
|
|
|
140
154
|
A new `schema` command has been added that opens up vacuum to JSON Schema specific linting rules and checks!
|
|
@@ -237,6 +251,7 @@ See all the documentation at https://quobix.com/vacuum
|
|
|
237
251
|
- [Why should you care?](https://quobix.com/vacuum/why/)
|
|
238
252
|
- [Concepts](https://quobix.com/vacuum/concepts/)
|
|
239
253
|
- [FAQ](https://quobix.com/vacuum/faq/)
|
|
254
|
+
- [Linting AsyncAPI](https://quobix.com/vacuum/asyncapi/)
|
|
240
255
|
- [Ignoring lint results](https://quobix.com/vacuum/ignoring/)
|
|
241
256
|
- [Generate API Docs](https://quobix.com/vacuum/api-docs/)
|
|
242
257
|
- [Linting JSON Schema](https://quobix.com/vacuum/json-schema/)
|
|
@@ -272,6 +287,9 @@ See all the documentation at https://quobix.com/vacuum
|
|
|
272
287
|
- [Schemas](https://quobix.com/vacuum/rules/schemas/)
|
|
273
288
|
- [Spec Information](https://quobix.com/vacuum/rules/information/)
|
|
274
289
|
- [Operations & Paths](https://quobix.com/vacuum/rules/operations/)
|
|
290
|
+
- [Channels](https://quobix.com/vacuum/rules/channels/)
|
|
291
|
+
- [Messages](https://quobix.com/vacuum/rules/messages/)
|
|
292
|
+
- [Servers](https://quobix.com/vacuum/rules/servers/)
|
|
275
293
|
- [Validation](https://quobix.com/vacuum/rules/validation/)
|
|
276
294
|
- [Security](https://quobix.com/vacuum/rules/security/)
|
|
277
295
|
- [OWASP](https://quobix.com/vacuum/rules/owasp/)
|
|
@@ -279,18 +297,21 @@ See all the documentation at https://quobix.com/vacuum
|
|
|
279
297
|
- [Core Functions](https://quobix.com/vacuum/functions/core/)
|
|
280
298
|
- [OpenAPI Functions](https://quobix.com/vacuum/functions/openapi/)
|
|
281
299
|
- [OWASP Functions](https://quobix.com/vacuum/functions/owasp/)
|
|
300
|
+
- [AsyncAPI Functions](https://quobix.com/vacuum/functions/asyncapi/)
|
|
282
301
|
- [Understanding RuleSets](https://quobix.com/vacuum/rulesets/understanding/)
|
|
283
302
|
- [Sharing RuleSets](https://quobix.com/vacuum/rulesets/sharing/)
|
|
284
303
|
- [All Rules](https://quobix.com/vacuum/rulesets/all/)
|
|
285
304
|
- [No Rules](https://quobix.com/vacuum/rulesets/no-rules/)
|
|
286
305
|
- [Recommended Rules](https://quobix.com/vacuum/rulesets/recommended/)
|
|
306
|
+
- [AsyncAPI Default Rules](https://quobix.com/vacuum/rulesets/asyncapi-recommended/)
|
|
307
|
+
- [AsyncAPI All Rules](https://quobix.com/vacuum/rulesets/asyncapi/)
|
|
287
308
|
- [Custom Rules](https://quobix.com/vacuum/rulesets/custom-rulesets/)
|
|
288
309
|
|
|
289
310
|
---
|
|
290
311
|
|
|
291
|
-
> **vacuum can suck all the lint of a 5mb
|
|
312
|
+
> **vacuum can suck all the lint of a 5mb API description in milliseconds.**
|
|
292
313
|
|
|
293
|
-
Designed to reliably lint
|
|
314
|
+
Designed to reliably lint API descriptions, **very, very quickly**. Including _very large_ ones. Spectral can be quite slow
|
|
294
315
|
when used as an API and does not scale for enterprise applications.
|
|
295
316
|
|
|
296
317
|
vacuum will tell you what is wrong with your spec, why, where, and how to fix it.
|
|
@@ -322,7 +343,7 @@ No external dependencies, the HTML report will run completely offline.
|
|
|
322
343
|
|
|
323
344
|
---
|
|
324
345
|
|
|
325
|
-
> **_Supports OpenAPI Version 2, OpenAPI Version 3+, and JSON Schema documents_**
|
|
346
|
+
> **_Supports OpenAPI Version 2, OpenAPI Version 3+, AsyncAPI 3, and JSON Schema documents_**
|
|
326
347
|
|
|
327
348
|
You can use either **YAML** or **JSON**, vacuum supports both formats.
|
|
328
349
|
|