@quobix/vacuum 0.28.4 → 0.29.1

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.
Files changed (2) hide show
  1. package/README.md +27 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ![logo](.github/assets/logo.png)
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
  ![build](https://github.com/daveshanley/vacuum/workflows/Build/badge.svg)
6
6
  [![Go Report Card](https://goreportcard.com/badge/github.com/daveshanley/vacuum)](https://goreportcard.com/report/github.com/daveshanley/vacuum)
@@ -10,7 +10,7 @@
10
10
  [![Docker Pulls](https://img.shields.io/docker/pulls/dshanley/vacuum?style=flat-square)](https://hub.docker.com/r/dshanley/vacuum)
11
11
  [![Mentioned in Awesome Go](https://awesome.re/mentioned-badge-flat.svg)](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. Use `--no-update-check` to skip that check for a single run.
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 OpenAPI spec in milliseconds.**
312
+ > **vacuum can suck all the lint of a 5mb API description in milliseconds.**
292
313
 
293
- Designed to reliably lint OpenAPI specifications, **very, very quickly**. Including _very large_ ones. Spectral can be quite slow
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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quobix/vacuum",
3
- "version": "0.28.4",
3
+ "version": "0.29.1",
4
4
  "description": "The world's fastest, most scalable and complete OpenAPI parser",
5
5
  "type": "module",
6
6
  "author": "Dave Shanley",