surveil/doc/source/tutorials/developing_the_api.rst

Developping the API

Launching the stack

If you have completed the tutorial_getting_started tutorial, you should know how to launch the stack: :

sudo docker-compose up

Editing the code

The Surveil container mounts your local project folder and pecan reloads every time the project files change thus providing a proper development environment.

For example, edit the surveil/api/controllers/v2/hello.py file and change Hello World! by Hello Devs!.

After you save the file, the following logs will appear in Surveil's output: :

surveil_1  | Some source files have been modified
surveil_1  | Restarting server...

You should be able to test your modification by accessing http://localhost:8080/v2/hello with your browser.

Disabling permissions

Depending on what you are working on, it might be practical to disable permissions. This can be done by editing the policy.json file found at etc/surveil/policy.json.

For example, you could modify the following line: :

"surveil:admin": "rule:admin_required",

by: :

"surveil:admin": "rule:pass",

This will modify permissions so that all API calls that require the admin rule now pass without any verification.