@4geit/swg-hello-path

@4geit/swg-hello-path

---

add a dummy path that enables an hello world endpoint in your api

Installation

1. A recommended way to install @4geit/swg-hello-path is through npm package manager using the following command:

npm i @4geit/swg-hello-path --save

Or use yarn using the following command:

yarn add @4geit/swg-hello-path

1. In your swagger file, you need to add a reference to the SwgHelloPath definition under the paths property (e.g. /api/swagger/swagger.yaml) as below:

swagger: "2.0"
# ...
paths:
  /hello:
    $ref: ../../node_modules/@4geit/swg-hello-path/swagger.yaml#/definitions/SwgHelloPath
# ...

And you will also need to add the path to the controllers folder of the swg-hello-path package so that swagger-node will find the relevant controller to use. Edit the file /config/default.yaml and add two new paths to the properties mockControllersDirs and controllersDirs as illustrated below:

swagger:
  # ...
  bagpipes:
    _router:
      # ...
      mockControllersDirs:
        # ...
        - node_modules/@4geit/swg-hello-path/mocks
        # ...
      controllersDirs:
        # ...
        - node_modules/@4geit/swg-hello-path/controllers
        # ...