Open Source Programs (Backend)

Open Source Programs (OSP) is an application that simplifies the processing and selection procedure of Open Source Programs of AnitaB.org Open Source or other third-party programs. This is the Backend repo for OSP.

Tech Stack

Django 3.0.7
Django REST Framework 3.11.0
Python 3.7+

API Documentation

Postman Docs

Setup

To setup the project locally go through this wiki page. Make sure you have installed the following:

Next follow these instructions.

Database Setup: Before starting with the project create a db in you local using PostgreSQL with the following details. Refer to main/settings.py if you have any confusion.
```
NAME: osp
USER: osp
PASSWORD: osp
HOST: localhost
```
You may run the following commands for local setup of DB:
```
sudo -i -u postgres
createuser osp --pwprompt
psql
CREATE DATABASE osp;
\c osp;
GRANT ON PRIVILEGES ON DATABASE systersdb to osp;
```

To start the server:

cd open-source-programs-backend
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
python manage.py runserver

Navigate to http://localhost:8000/ in your browser.
To change the port you may run python manage.py runserver 0.0.0.0:<port_number>
To run the migrations run: python manage.py migrate
You can terminate the process by Ctrl+C in your terminal.

Contributing

Please read the Contibuting guidelines, Code of Conduct and Reporting Guidelines

Contact

You can reach the admins, maintainers and our community on AnitaB.org Open Source Zulip. If you are interested in contributing to the OSP project, you may join the stream #open-source-progs and ask questions or intereact with the community. Join Us!