Skip to content

Latest commit

 

History

History
77 lines (48 loc) · 2.12 KB

CONTRIBUTING.md

File metadata and controls

77 lines (48 loc) · 2.12 KB

Contributing

Local prerequisites

os dependencies

# required for psycopg2 (postgres)
sudo apt-get update -y && sudo apt-get install -y libpq-dev python3-dev

vscode (Recommended)

Support for vscode is provided, with a sensible configuration.

docker

A docker-compose.yml file is provided for development.

# Copy the template .env
cp .template.env .env

# Edit the content of .env file to your needs
# It should work as is, except for the `AIRFLOW_UID=` variable that must be set
# to the value returned by `echo $(id -u)`

# Start the stack
docker compose up -d

After a few seconds, the services should be avaible as follow:

default location default credentials
airflow UI http://localhost:8080 user: airflow pass: airflow
data.inclusion http://localhost:8000 token must be generated

minio Client

This is optional but allows you to interact with the datalake locally from the command line.

Cf DEPLOYMENT.md if you also wich to interact with staging and prod bucket.

See installation instructions here.

python

Project uses python3.11

pyenv is a clean and easy way to manage multiple python versions on your computer. Installation instructions are available here.

pre-commit

pipx install pre-commit

Global setup

# Clone this repository
git clone [email protected]:gip-inclusion/data-inclusion.git

# Setup code quality tools
pre-commit install

# Open workspace in vscode
code -n data-inclusion

Each subdirectory (./pipeline, ./api, etc.) has its own contributing guidelines on how to setup an environment for development.

Contribution

Issues and PRs are welcome.