@quobix/vacuum 0.27.3 → 0.28.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 +21 -88
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- ![logo](logo.png)
1
+ ![logo](.github/assets/logo.png)
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.27` 🔥: **Generate OpenAPI Documentation in vacuum**
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
@@ -308,6 +239,7 @@ See all the documentation at https://quobix.com/vacuum
308
239
  - [FAQ](https://quobix.com/vacuum/faq/)
309
240
  - [Ignoring lint results](https://quobix.com/vacuum/ignoring/)
310
241
  - [Generate API Docs](https://quobix.com/vacuum/api-docs/)
242
+ - [Linting JSON Schema](https://quobix.com/vacuum/json-schema/)
311
243
  - [CLI Commands](https://quobix.com/vacuum/commands/)
312
244
  - [lint](https://quobix.com/vacuum/commands/lint/)
313
245
  - [vacuum report](https://quobix.com/vacuum/commands/report/)
@@ -319,10 +251,11 @@ See all the documentation at https://quobix.com/vacuum
319
251
  - [language-server](https://quobix.com/vacuum/commands/language-server/)
320
252
  - [upgrade](https://quobix.com/vacuum/commands/upgrade/)
321
253
  - [apply-overlay](https://quobix.com/vacuum/commands/apply-overlay/)
254
+ - [schema](https://quobix.com/vacuum/commands/schema/)
322
255
  - [Change Detection](https://quobix.com/vacuum/commands/change-detection/)
323
- - [Open Collection](https://quobix.com/vacuum/commands/open-collection/)
324
- - [Generate RuleSet](https://quobix.com/vacuum/commands/generate-ruleset/)
325
- - [Version](https://quobix.com/vacuum/commands/version/)
256
+ - [open-collection](https://quobix.com/vacuum/commands/open-collection/)
257
+ - [generate-ruleset](https://quobix.com/vacuum/commands/generate-ruleset/)
258
+ - [version](https://quobix.com/vacuum/commands/version/)
326
259
  - [External References](https://quobix.com/vacuum/commands/external-references/)
327
260
  - [Exit Codes](https://quobix.com/vacuum/commands/exit-codes/)
328
261
  - [Developer API](https://quobix.com/vacuum/api/getting-started/)
@@ -385,7 +318,7 @@ you can explore broken rules and violations, but in your browser.
385
318
 
386
319
  No external dependencies, the HTML report will run completely offline.
387
320
 
388
- ![vacuum html-report](html-report-screenshot.png)
321
+ ![vacuum html-report](.github/assets/html-report-screenshot.png)
389
322
 
390
323
  ---
391
324
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quobix/vacuum",
3
- "version": "0.27.3",
3
+ "version": "0.28.1",
4
4
  "description": "The world's fastest, most scalable and complete OpenAPI parser",
5
5
  "type": "module",
6
6
  "author": "Dave Shanley",