- (not support anymore) implicit dereferencing, which is conflict with 'relative file reference'
json
"definitions":{
"User":{
},
"AuthorizedUser":{
"$ref": "User" --> deferenced to "/definitions/User"
}
}
- __NEW__ relative file reference
"definitions":{
"User": {
"$ref": "other_folder/User.json"
}
}
- __NEW__ the root object of external documents can be any object (need to be an Swagger/PathItem object before this version)
- fix issue: use 'netloc' only when no host provided.
NEWs
Upcoming changes for OpenAPI 3.0 would be:
- version changes to: `1.0.0`, if you need a stabler version, please use `pyswagg<1.0.0` in pip's requirement file.
- most logic would be divided to this [repo](https://github.com/mission-liao/pyopenapi) and **pyswagg** would only contains code related to 'making reuqests' (just like what gophers did in [go-openapi](https://github.com/go-openapi))
- **$ref** would not be normalized anymore. Every field from API spec would be left unchanged and create another field for patched version.