feat : add openapi 3 support

README.md

@@ -123,6 +123,7 @@ fastify.ready(err => {
 `dynamic` mode is the default one, if you use the plugin this way - swagger specification would be gathered from your routes definitions.
   ```js
   {
+    // swagger 2.0 options
     swagger: {
       info: {
         title: String,
@@ -136,14 +137,29 @@ fastify.ready(err => {
       produces: [ String ],
       tags: [ Object ],
       securityDefinitions: Object
-    }
+    },
+    // openapi 3.0.3 options
+    // openapi: {
+    //   info: {
+    //     title: String,
+    //     description: String,
+    //     version: String,
+    //   },
+    //   externalDocs: Object,
+    //   servers: [ Object ],
+    //   components: Object,
+    //   security: [ Object ],
+    //   tags: [ Object ]
+    // }
   }
   ```
 
   *All the above parameters are optional.*
-  You can use all the properties of the [swagger specification](https://swagger.io/specification/), if you find anything missing, please open an issue or a pr!
+  You can use all the properties of the [swagger specification](https://swagger.io/specification/v2/) and [openapi specification](https://swagger.io/specification/), if you find anything missing, please open an issue or a pr!
+
+  fastify-swagger will generate Swagger v2 by default. If you pass the `opeanapi` option it will generate OpenAPI instead.
 
-  Example of the `fastify-swagger` usage in the `dynamic` mode is available [here](examples/dynamic.js).
+  Example of the `fastify-swagger` usage in the `dynamic` mode, `swagger` option is available [here](examples/dynamic-swagger.js) and `openapi` option is avaiable [here](examples/dynamic-openapi.js).
 <a name="mode.static"></a>
 
 ##### options
@@ -154,6 +170,7 @@ fastify.ready(err => {
  | hiddenTag     | X-HIDDEN | Tag to control hiding of routes.      |
  | stripBasePath | true     | Strips base path from routes in docs. |
  | swagger       | {}       | Swagger configuration.                |
+ | openapi       | {}       | Openapi configuration.                |
  | transform     | null     | Transform method for schema.          |
 
 ##### static