# intentionally left blank
openapi: 3.1.0
title: Sample Pet Store App
summary: A pet store manager.
description: This is a sample server for a pet store.
termsOfService: https://example.com/terms/
contact:
  name: API Support
  url: https://www.example.com/support
  email: support@example.com
license:
  name: Apache 2.0
  url: https://www.apache.org/licenses/LICENSE-2.0.html
version: 1.0.1

# intentionally left blank
paths:
  /pets:
    get:
      summary: List all pets
      operationId: listPets
      tags:
        - pets
      

# intentionally left blank
# within the paths object, under the HTTP Verb for the path
parameters:
  - name: limit
  	in: query
  	description: How many items to return at one time (max 100)
  	required: false
  	schema:
  	  type: integer
  	  format: int32
  - name: type
  	in: query
  	description: What type of pet to return (dog, cat, snake, droid)
  	required: false
  	schema:
  	  type: string   

# intentionally left blank
# within the paths object, under the HTTP Verb for the path
responses:
  '200':
    description: A paged array of pets
    headers:
      x-next:
        description: A link to the next page of responses
        schema:
          type: string
   content:
     application/json:    
       schema:
         $ref: "#/components/schemas/Pets"
         discriminator:
           propertyName: pet_type
       examples:
         allOf: 
           $ref: "#/components/schemas/Pets"
       default:
         description: unexpected error
         content:
           application/json:
             schema:
               $ref: "#/components/schemas/Error"

# intentionally left blank
# within the paths object, under the HTTP Verb for the path
components:
  schemas:
    Pet:
      type: object
      discriminator:
        propertyName: petType
      properties:
        name:
          type: string
        petType:
          type: string
      required:
      - name
      - petType
    Cat:  ## "Cat" will be used as the discriminator value
      description: A representation of a cat
      allOf:
      - $ref: '#/components/schemas/Pet'
      - type: object
        properties:
          huntingSkill:
            type: string
            description: The measured skill for hunting
            enum:
            - clueless
            - lazy
            - adventurous
            - aggressive
        required:
        - huntingSkill
    Dog:  ## "Dog" will be used as the discriminator value
      description: A representation of a dog
      allOf:
      - $ref: '#/components/schemas/Pet'
      - type: object
        properties:
          packSize:
            type: integer
            format: int32
            description: the size of the pack the dog is from
            default: 0
            minimum: 0
        required:
        - packSize

paths:
  /users:
    $ref: '../resources/users.yaml'
  /users/{userId}:
    $ref: '../resources/users-by-id.yaml'

paths:
  /users:
    $ref: '../document.json#/resources/users.yaml'
  /users/{userId}:
    $ref: '../document.json#/resources/users-by-id.yaml'

paths:
  /users:
    $ref: 'http://path/to/your/resource.json#myElement'
  /users/{userId}:
    $ref: 'http://path/to/your/resource.json#myElement'

#intentionally left blank
paths:
  /pets:
    patch:
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
                - $ref: '#/components/schemas/PetByAge'
                - $ref: '#/components/schemas/PetByType'
      responses:
        '200':
          description: Updated
components:
  schemas:
    PetByAge:
      type: object
      properties: 
        age: 
          type: integer
        nickname: 
          type: string
      required:
        - age
          
    PetByType:
      type: object
      properties:
        pet_type:
          type: string
          enum: [Cat, Dog]
        hunts:
          type: boolean
      required: 
        - pet_type

#intentionally left blank
openapi: 3.0.3
info:
    title: ''
    version: 0.1.0
    description: 'Test API'
    contact: { name: 'Laravel News', email: user@example.com, url: null }
servers:
    - { url: 'http://openapi-demo.test', description: 'Local url for testing' }
tags: null
paths: null
components:
    schemas: null
    responses: null
    headers: null
    parameters: null
    links: null
    examples: null

// intentionally left blank
<?php
$yamlFile = "api.yaml";
$jsonFile = "api.json";

$validator = (new \League\OpenAPIValidation\PSR7\ValidatorBuilder)
				->fromYamlFile($yamlFile)
                ->getRequestValidator();
#or

$validator = (new \League\OpenAPIValidation\PSR7\ValidatorBuilder)
				->fromJson(file_get_contents($jsonFile))
                ->getRequestValidator();
#or

$schema = new \cebe\openapi\spec\OpenApi(); // generate schema object by hand
$validator = (new \League\OpenAPIValidation\PSR7\ValidatorBuilder)
				->fromSchema($schema)
                ->getRequestValidator();

$match = $validator->validate($request);

//intentionally left blank
<?php

use Spectator/Spectator;

class ExampleTest extends TestCase
{
    /**
     * A basic functional test example.
     *
     * @return void
     */
    public function testBasicExample()
    {
        Spectator::using('Api.v1.json');

        $response = $this->postJson('/user', ['name' => 'Sally']);

        $response
            ->assertValidRequest()
            ->assertValidResponse(201);
    }
}