Go to file

Benjamin Bach 037c204411 Re-instate updated pip-compile command, regenerate requirements*.txt		2024-08-01 13:04:31 +02:00
requirements	Re-instate updated pip-compile command, regenerate requirements*.txt	2024-08-01 13:04:31 +02:00
src	Reduce amount of migrations	2024-08-01 12:51:21 +02:00
.dockerignore	Cleanup.	2024-07-14 23:14:07 +02:00
.drone.yml	Cleanup.	2024-07-14 23:14:07 +02:00
.env.example	Example API key doesn't need to look like a secret	2024-08-01 12:52:14 +02:00
.gitignore	New WaitingListEntry (#33 )	2024-07-31 22:49:46 +00:00
.pre-commit-config.yaml	Requirements pinning + some cleanup (#36 )	2024-07-31 21:17:00 +00:00
docker-compose.yml	Cleanup.	2024-07-14 23:14:07 +02:00
Dockerfile	Update dockerfile to using bookworm, and to avoid invalidating cache unless updating requirements.	2024-07-31 23:48:39 +02:00
entrypoint.sh	Fix entrypoint paths. Add uvicorn. Set correct port.	2021-03-01 14:13:19 +01:00
Makefile	Merge branch 'main' of git.data.coop:data.coop/membersystem into payment-updates	2024-08-01 00:59:18 +02:00
pyproject.toml	Re-instate updated pip-compile command, regenerate requirements*.txt	2024-08-01 13:04:31 +02:00
README.md	Clean up README	2024-08-01 12:57:28 +02:00
requirements.txt	Re-instate updated pip-compile command, regenerate requirements*.txt	2024-08-01 13:04:31 +02:00

README.md

data.coop member system

Development setup

There are two ways to setup the development environment.

Using the Docker Compose setup provided in this repository.
Using hatch in your host OS.

Using Docker Compose

Working with the Docker Compose setup is made easy with the Makefile provided in the repository.

Requirements

Docker
docker compose plugin

Setup

Setup .env file

An example .env file is provided in the repository. You can copy it to .env file using the following command:
```
cp .env.example .env
```
The default values in the .env file are suitable for the docker-compose setup.
Migrate
```
make migrate
```
Run the development server
```
make run
```

Building and running other things

# Build the containers
make build

# Create a superuser
make createsuperuser

# Create Django migrations (after this, maybe you need to change file permissions in volume)
make makemigrations

Using hatch

Requirements

Python 3.12 or higher
hatch (Recommended way to install is using pipx install hatch)
A running PostgreSQL server

Setup

Setup .env file

An example .env file is provided in the repository. You can copy it to .env file using the following command:
```
cp .env.example .env
```
Edit the .env file and set the values for the environment variables, especially the database variables.
Run migrate
```
hatch run dev:migrate
```
Run the development server
```
hatch run dev:server
```

Updating requirements

We use hatch-pip-compile. That means we have a set of loosely defined dependencies in pyproject.toml and then we can keep the exactly pinned version in our requirements.txt (auto-generated).

To generate requirements.txt and requirements/requirements-dev.txt, run the following command:

# Build requirements.txt etc
make requirements

# Build Docker image with new Python requirements
make build