118 lines
2.5 KiB
Markdown
118 lines
2.5 KiB
Markdown
[![Translation](http://translate.ojuso.org/widgets/platform/-/svg-badge.svg)](http://translate.ojuso.org/engage/platform/?utm_source=widget)
|
|
[![pipeline status](https://gitlab.com/autonomic-cooperative/ojuso-map/badges/master/pipeline.svg)](https://gitlab.com/autonomic-cooperative/ojuso-map/commits/master)
|
|
[![coverage report](https://gitlab.com/autonomic-cooperative/ojuso-map/badges/master/coverage.svg)](https://gitlab.com/autonomic-cooperative/ojuso-map/commits/master)
|
|
|
|
# ojuso-map
|
|
|
|
Kickass map for the Ojuso Project
|
|
|
|
# Getting Started
|
|
|
|
## Check out the code
|
|
|
|
```bash
|
|
$ git clone git@gitlab.com:autonomic-cooperative/ojuso-map.git
|
|
$ cd ojuso-map
|
|
```
|
|
|
|
All commands from here on should be run in the `ojuso-map` directory.
|
|
|
|
## Install System Dependencies
|
|
|
|
### Debian / Ubuntu
|
|
|
|
```bash
|
|
$ xargs < system-requirements-debian.txt sudo apt-get install -y
|
|
```
|
|
|
|
### Fedora
|
|
|
|
```bash
|
|
$ xargs < system-requirements-fedora.txt sudo dnf install
|
|
```
|
|
|
|
If you hadn't previously installed Postgres, you will need to initialise the
|
|
database and start the server:
|
|
|
|
```bash
|
|
$
|
|
```
|
|
|
|
## Bootstrap the Virtual Environment
|
|
|
|
Set up your Python virtual environment in the `.venv` folder:
|
|
|
|
```bash
|
|
$ python3 -m venv .venv
|
|
$ source .venv/bin/activate
|
|
```
|
|
|
|
## Configure the Environment
|
|
|
|
```bash
|
|
$ export DEBUG=1
|
|
$ export DJANGO_SETTINGS_MODULE=ojusomap.settings
|
|
```
|
|
|
|
## Install the Python Dependencies
|
|
|
|
```bash
|
|
$ pip3 install --upgrade pip setuptools
|
|
$ pip3 install -r requirements-devel.txt
|
|
```
|
|
|
|
If you run into issues with `psycopg2` you may need to run the following:
|
|
|
|
```bash
|
|
$ pip3 uninstall psycopg2 && pip3 install --no-binary :all: psycopg2
|
|
```
|
|
|
|
## Ensure Postgres is running and accessible
|
|
|
|
You should be able to connect to Postgres:
|
|
|
|
```bash
|
|
$ psql -U postgres -h localhost
|
|
```
|
|
|
|
(enter "postgres" as the password)
|
|
|
|
If not, follow [these instructions](https://stackoverflow.com/a/51872624/399367)
|
|
to change the Postgres authentication options (NB on Fedora / Centos,
|
|
`pg_hba.conf` is located in `/var/lib/pgsql/data`), then run:
|
|
|
|
```bash
|
|
$ echo "ALTER USER postgres WITH PASSWORD 'postgres';" | psql -U postgres
|
|
```
|
|
|
|
## Run The Migrations
|
|
|
|
```bash
|
|
$ python manage.py migrate
|
|
```
|
|
|
|
## Start the server
|
|
|
|
```bash
|
|
$ python manage.py runserver
|
|
```
|
|
|
|
# Resuming work
|
|
|
|
For each new terminal session, you will need to run:
|
|
|
|
```bash
|
|
$ cd ojuso-map
|
|
$ source .venv/bin/activate
|
|
$ export DEBUG=1
|
|
$ export DJANGO_SETTINGS_MODULE=ojusomap.settings
|
|
$ python manage.py runserver
|
|
```
|
|
|
|
# Running The Tests
|
|
|
|
```bash
|
|
$ pip install -r requirements-test.txt
|
|
$ pytest -v
|
|
```
|