Updated README.

This commit is contained in:
sfigato 2019-08-08 16:05:59 +02:00 committed by blallo
parent 548b4e9b81
commit e3155922af
Signed by: blallo
GPG Key ID: 0CBE577C9B72DC3F

View File

@ -13,6 +13,62 @@ Features
* Login/Logout * Login/Logout
* Check in/Check out * Check in/Check out
* web ui
Develop
-------
To allow local development you either need a configuration file named
`.botz.yaml` in the root of the project with something like this:
```
---
base_uri: "<your_target_uri>"
debug: true
headless: true
log:
level: DEBUG
syslog: false
http:
bind_addr:
- "127.0.0.1"
port: 3003
cookie_secure: false
cors_allow: "http://localhost:3000"
```
Read the docstring in `api/conf.py` to understand the menaning of the
various parameters.
*Do not `pip install -e .`*. It will miss the geckodriver download step.
Take a look at the provided `Dockerfile`.
You can either run it:
```
$ docker build -t botz:latest .
$ docker run -v $PWD:/app -p "3003:3003" botz
```
and find a working app at `http://localhost:3003`.
Or you can `python setup.py bdist_wheel && python setup.py develop`.
You will need:
- `python >= 3.7`
- `yarn` (`npm` support coming soon...)
If you want to develop the ui, you can also serve it via yarn (as it
supports hot reload):
```
$ cd bot.z_web
$ yarn start
```
You will find a working ui at `localhost:3000` (but you need the last two
lines of the previous example config file).
Install Install
@ -35,5 +91,5 @@ TODO
- [x] Check in/out - [x] Check in/out
- [ ] systemd {unit, timer} - [ ] systemd {unit, timer}
- [ ] APIs - [x] APIs
- [ ] Mailer - [ ] Mailer