microcks-vacuum-rules.yaml

functions:
  - oas-verify-mocks-vacuum

extends: [[spectral:oas, off]]

rules:
  microcks-info-extension-valid:
    description: x-microcks extension must be valid
    message: "x-microcks extension must be valid"
    formats:
      - oas3
    severity: warn
    given: "$.info"
    then:
      field: x-microcks
      function: schema
      functionOptions:
        schema:
          type: object
          properties:
            labels:
              type: object
              additionalProperties:
                type: string
          required:
            - labels
          additionalProperties: false

  microcks-operation-extension-valid:
    description: x-microcks-operation extension must be valid
    message: "x-microcks-operation extension must be valid"
    formats:
      - oas3
    severity: warn
    given: "$.paths.*.*"
    then:
      field: x-microcks-operation
      function: schema
      functionOptions:
        schema:
          type: object
          properties:
            delay:
              type: number
              format: int32
            frequency:
              type: number
              format: int32
            dispatcher:
              type: string
            dispatcherRules:
              type: string
            parameterConstraints:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                  in:
                    type: string
                    enum: [path, query, header]
                  required:
                    type: boolean
                  recopy:
                    type: boolean
                  mustMatchRegexp:
                    type: string
                required:
                  - name
                  - in
          additionalProperties: false

  oas3-valid-media-example: true
  oas3-valid-schema-example: true

  microcks-examples-in-parameter:
    description: Parameters should have examples
    message: "Parameters should have examples"
    formats:
      - oas3
    severity: info
    given: "$..parameters"
    then:
      field: examples
      function: truthy

  microcks-examples-in-request-content:
    description: Request with content must have examples
    message: "Request with content must have examples"
    formats:
      - oas3
    severity: warn
    given: "$.paths..requestBody..content.*"
    then:
      field: examples
      function: truthy

  microcks-examples-in-response-content:
    description: Response with content must have examples
    message: "Response with content must have examples"
    formats:
      - oas3
    severity: warn
    given: "$.paths..responses..content.*"
    then:
      field: examples
      function: truthy

  microcks-examples-fragments-to-complete-mocks:
    description: Response example must match required params examples to form full mocks
    message: "{{error}}"
    formats:
      - oas3
    severity: warn
    given: "$.paths.*.*"
    then:
      function: oas-verify-mocks-vacuum