FAL.S.Y

it's an api framework.
using falcon, swagger, yaml together!

MIT and Apache v2

pip install falsy

0. create the dir for static

   mkdir static

1. writting the server code(main.py)

   from falsy.falsy import FALSY
   
   f = FALSY()   #you need create the dir called static before you run
   f.swagger('test.yml', ui=True, theme='impress') #impress theme is the responsive swagger ui, or you can use 'normal' here
   api = f.api

2. writting the yml file

   swagger: '2.0'
   info:
   title: FALSY SIMPLE DEMO API
   version: "0.1"
   consumes:
   - application/json
   produces:
   - application/json
   basePath: "/v1"
   paths:
     '/hello':
       get:
         tags: [Method]
         operationId: demo.get_it
         summary: testing
         parameters:
           - name: name
             in: query
             type: string
             default: 'john'
         responses:
           200:
             description: Return response
   

3. writting the operation handler(demo.py)

   def get_it(name):
       return {
           'get': name
       }

4. run it

   gunicorn -b 0.0.0.0:8001 main:api --reload -w 1 --threads 1

5. visit the ui page

   http://0.0.0.0:8001/v1/ui/ make sure it ends with '/'

there some improvements compare to standard swagger, 
you can define `operationId` for handler, 'beforeId' and 'afterId' for aop hooks,
and 'validationId' for validator, see the files in demo dir for details.