swagger-routes/test/fileHandlers.spec.js

Generate Express or Restify route handlers from a Swagger specification

'use strict'

const expect = require('expect')
const del = require('del')
const fs = require('fs')
const fileHandlers = require('../src/fileHandlers')
const swaggerSpec = require('../src/swaggerSpec')
const util = require('../src/util')
const applyDefaultOptions = require('../src/options').applyDefaultOptions

const api = swaggerSpec.getSpecSync('./test/_fixture/petstore.yml')
const operations = swaggerSpec.getAllOperations(api)
const operationId = 'listPets'
const listPetsOp = operations.find(op => op.id === operationId)
const options = applyDefaultOptions({
  api,
  handlers: './bin/handler'
})

describe('fileHandlers', () => {
  afterEach(() => del(options.handlers.path))

  describe('enableHandler', () => {
    it('should generate a route handler file based on operation id', () => {
      const fileInfo = fileHandlers.enableHandler(listPetsOp, options)

      expect(fileInfo.gen).toBe(true)
      expect(fileInfo.old).toBe(false)
      expect(util.existsSync(fileInfo.path)).toNotBe(false)
    })

    it('should NOT re-generate existing handler files', () => {
      const fileInfoA = fileHandlers.enableHandler(listPetsOp, options)
      const fileInfoB = fileHandlers.enableHandler(listPetsOp, options)

      expect(fileInfoA.gen).toBe(true)
      expect(fileInfoB.gen).toBe(false)
    })

    it('should renew old handler which is in use again', () => {
      fileHandlers.enableHandler(listPetsOp, options)
      fileHandlers.disableHandler(listPetsOp, options)
      const fileInfo = fileHandlers.enableHandler(listPetsOp, options)

      expect(fileInfo.gen).toBe(false)
      expect(fileInfo.old).toBe(false)
      expect(fileInfo.id).toBe(operationId)
    })

    it('should update header docs when swagger spec changes', () => {
      const options2 = Object.assign({ maintainHeaders: true }, options)
      const fileInfo = fileHandlers.enableHandler(listPetsOp, options2)
      const contents1 = fs.readFileSync(fileInfo.path, 'utf8') + '\nEDIT\n'

      fs.writeFileSync(fileInfo.path, contents1)
      const listPetsOp2 = Object.assign({}, listPetsOp, { summary: listPetsOp.summary + 'NEW' })
      fileHandlers.enableHandler(listPetsOp2, options2)

      const expected = contents1.split(listPetsOp.summary).join(`${listPetsOp.summary}NEW`)
      const contents2 = fs.readFileSync(fileInfo.path, 'utf8')

      expect(contents2).toBe(expected)
    })
  })

  describe('disableHandler', () => {
    it('should prefix underscore to handler files no longer in use', () => {
      const fileInfoA = fileHandlers.enableHandler(listPetsOp, options)
      const fileInfoB = fileHandlers.disableHandler(listPetsOp, options)

      expect(fileInfoA.gen).toBe(true)
      expect(fileInfoA.old).toBe(false)
      expect(fileInfoA.id).toBe(operationId)

      expect(fileInfoB.gen).toBe(false)
      expect(fileInfoB.old).toBe(true)
      expect(fileInfoB.id).toBe(`_${operationId}`)
    })
  })

  describe('disableOldHandlers', () => {
    it('should disable handlers for operations which no longer exist', () => {
      const listPetsOp2 = Object.assign({}, listPetsOp, { id: `${operationId}2` })
      fileHandlers.enableHandler(listPetsOp2, options)
      const fileInfos = fileHandlers.disableOldHandlers(operations, options)
      const fileInfo = fileInfos[0]

      expect(fileInfo.gen).toBe(false)
      expect(fileInfo.old).toBe(true)
      expect(fileInfo.id).toBe(`_${operationId}2`)
    })
  })
})