ojuso-map/README.md

[![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
```