Comments (6)
Bump.
from swagger-cli.
$ tree -C -L 1 ./
./
├── endpoints
├── schemas
└── apispec.yml
$ swagger-cli --version
4.0.4
$ swagger-cli bundle --type yaml apispec.yml
Token "components" does not exist.
The endpoints
and schemas
directory contains path and schema definitions. We successfully preview the documentation with both Swagger UI and Redoc, so I presume our specification is valid. Still, I can't figure out the reason for that error.
Any assistance would be appreciated.
EDIT: Just realized it my spec does not validate...
$ swagger-cli validate --type yaml ./xapi-spec.yml
Token "components" does not exist.
from swagger-cli.
I was able to solve the issue. The problem was that we had some:
$ref: '#/components/schemas/MyCookie'
But #/
will try to find components
in the current file. As soon as changed to things like this, it worked:
$ref: '../cookies.yml#/components/schemas/MyCookie'
or
$ref: '../params.yml#/components/schemas/MyParam'
This way, we are referencing components
in a specific file and not in "the current file".
from swagger-cli.
It would be nice if the behaviour in swagger-cli
would match the preview behaviour, as in.
That requires deciding on whether to interpret $ref: #/
as a reference inside the current file or whether to interpret it as a reference inside the current document (which is the merged result).
The latter is apparently the behaviour used by Swagger UI and IMHO makes a lot more sense as it makes the component files more file-path agnostic.
from swagger-cli.
any work-arounds for this, at least? :)
from swagger-cli.
Same issue here.
from swagger-cli.
Related Issues (20)
- swagger-cli validation returns errors one by one
- invalid examples should not fail validation
- Dependabot warning for validator
- $ref bug resolving an existing folder HOT 1
- swagger-cli validate does not ensure unique operationIds
- Validate security keys against securitySchemes HOT 1
- Combining multiple files can create circular references HOT 1
- Ref incorrect if path contains "{" or "}" HOT 1
- Bad error message on incorrect path provided
- Latest version of the CLI I'm getting the following error HOT 5
- bundle and validate commands are failing due to swagger-parser HOT 3
- Validation of composite keywords (anyOf, oneOf, allOf) HOT 1
- False positive: #/servers/0/variables/someParameter must NOT have unevaluated properties
- Undeclared parameters in server url should not validate
- Property examples are converted to the wrong date format
- The order of the directive changes between versions of the dependent package
- Combining multiple files into one keeps references to some api files HOT 1
- [BUG] String enum of '08' and '09 ' are wrong bundled HOT 1
- bundle removes quotes
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from swagger-cli.