README.md

# Hiboo

### Quickstart dev guide:

#### Dependencies:

Debian:
`
apt-get install python python-dev libmysqlclient-dev libpq-dev libxmlsec1-dev nodejs npm mariadb-server postgresql-libs python-pip python-virtualenv
`

Arch:
`
pacman -S git python python-pip python-virtualenv nodejs npm mariadb postgresql-libs
`

Fedora:
`
dnf install -y mysql-devel postgresql-devel xmlsec1-devel python3-devel libtool-ltdl-devel nodejs
`

#### Installation:

Clone Hiboo:
```
git clone https://forge.tedomum.net/acides/hiboo && cd hiboo
```

Create virtualenv and activate it:
```
mkdir venv
virtualenv venv
source venv/bin/activate
```

Install dependencies:
```
pip install -r requirements.txt
npm install
```

Import databases:
```
export FLASK_APP=hiboo
flask db upgrade
```

Generate the static folder:
```
./node_modules/.bin/webpack-cli
```

#### Run

```
export FLASK_APP=hiboo
flask run --reload
```

#### Misc

If you create or update messages in the `python`/`html` source files, don't forget to update the messages catalogs:
```sh
pybabel extract -F babel.cfg -o messages.pot Hiboo
pybabel update -i messages.pot -d hiboo/translations/
```

### Test instance

Our test instance is running at: https://auth.test.tedomum.net

You can find some test services at :

 - https://write.test.tedomum.net
 - https://seafile.test.tedomum.net
 - https://nextcloud.test.tedomum.net
 - https://riot.test.tedomum.net

Please contact us if you want specific permissions on the test instance.