1,4 KiB
Componente centrale del sistema pizzicaroli. tiene i conti. espone HTTP e WebSocket.
Alcune API richiedono autenticazione.
Il docker incluso è solo per comodità di sviluppo, non è strettamente necessario.
Concetti
Contatori multipli
Il codice gestisce più di un contatore, per generalità, anche se non è chiaro se questa cosa ci servirà. I contatori partono da 0, quindi in genere useremo sempre 0.
Storage
Il sistema ha un suo storage, in modo che al riavvio i contatori ripartano da dove erano.
HTTP API
GET /counter/0 ti dà il valore
POST /counter/0/increment incrementa, ma richiede basic-auth
WebSocket API
/ws/counter/0 ti dà il valore e ti riaggiorna ogni volta che questo cambia. Ignora ogni messaggio in
ingresso.
Lanciare
Docker compose
docker-compose up
Debian Bullseye
Just install a few packages from the standard repositories, and you're set. No pip, virtualenv, …
apt install python3-fastapi python3-dotenv uvicorn
env QUEUES_NUMBER=2 uvicorn pizzicore:app --reload --port 8000 --host 0.0.0.0
In the snippet above, you can see how to set variables on the commandline. See pizzicore.env.sample for a list of settings.
You can also create a pizzicore.env file (named exactly like that) as a configuration method.
Environment variables take precedence over configuration files.
TODO
- configurazione
- esempi d'uso