Developping the API¶
Launching the stack¶
If you have completed the Getting started with Surveil 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.