AnitaB Forms 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.
- Django 3.0.7
- Django REST Framework 3.11.0
- Python 3.7+
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.pyif you have any confusion.NAME: osp USER: osp PASSWORD: osp HOST: localhostYou may run the following commands for local setup of DB in Linux:
cd anitab-forms-backend sudo -i -u postgres createuser osp --pwprompt psql CREATE DATABASE osp; \c osp; GRANT ALL PRIVILEGES ON DATABASE osp to osp;You may run the following commands for local setup of DB in Windows:
cd anitab-forms-backend psql -U postgres CREATE ROLE osp LOGIN PASSWORD 'osp' NOINHERIT CREATEDB; CREATE DATABASE osp; \c osp; GRANT ALL PRIVILEGES ON DATABASE osp to osp; -
Set the environment variables: You need to download Zulip API key file from your user-settings on Zulip. The file you download is named as
downloador rename it todownload. Place that download file in the project's directory. For more information follow Environment Variables section. -
Move into the project's directory.
cd anitab-forms-backend -
Create virtual environment (this is not a hard requirement, but its advisable)
virtualenv venvActivating virtual environment for Linux users:
source venv/bin/activateActivating virtual environment for Git Bash users:
source ./venv/Scripts/activateActivating virtual environment for Windows users:
venv\Scripts\activate -
To install dependencies:
pip install -r requirements.txt -
Make sure you create
.envusing.env.templateand update the values of corresponding environment variables or make sure you exported the following environment variables. -
To run the migrations run:
python manage.py migrate -
To run the server:
python manage.py runserver -
Navigate to
http://localhost:8000/in your browser. -
To change the port you may run
python manage.py runserver <port_number> -
To run the migrations run:
python manage.py migrate -
You can terminate the process by
Ctrl+Cin your terminal.
Follow the given instructions for Login into the app.
-
You can register a new user by making a POST request on
/api/token_auth/register/. After this confirmation e-mail will be sent to standard output (terminal). To receive confirmation e-mail using Sendgrid see this. The content of the request must be like this:{ "username":"< YOUR USERNAME >", "email":"< YOUR EMAIL >", "password":"< YOUR PASSWORD >", "confirm_password":"< YOUR PASSWORD >" } -
To create the superuser run:
python manage.py createsuperuserFill up the things it asked to and then Login into the app.
-
Zulip API KEY file- You can go Zulip and follow these instructions to get your API KEY. Download the file and save it in the root folder of the project with the namedownload. -
SENDGRID_API_KEY- It is optional for development. To use this variable makeDEBUG=Falseinsettings.py. Follow the given steps to create a Sendgrid API key:- Go to Sendgrid's website
- Navigate to Settings on the left navigation bar, and then - select API Keys.
- Click Create API Key.
- Give your API key a name.
- Select Full Access, Restricted Access, or Billing Access. If you're selecting Restricted Access, or Billing Access, select the specific permissions to give each category. For more information, see API key permissions.
- Click Create & View.
- The API KEY is generated and displayed to you just once. So be sure to copy and save it somewhere.
Add it to your .env file as follows:
export SENDGRID_API_KEY=<your-sendgrid-api-key>
-
SECRET_KEY- This environment variable is required for running the backend. AddSECRET_KEYin.envfile or export it by usingexport SECRET_KEY=<YOUR SECRET KEY>. -
DB_BACKEND- This environment variable is used here to get the the backend class of the database. Different databases have different backends in django. You can read more about it here. Its default backend is postgresql. -
DB_NAME- This environment variable is required to get the name of the database. By default, its value isosp. -
DB_USERNAME- This environment variable is required to get the USERNAME of the user with all privileges to the above mentioned database. -
DB_PASSWORD- This environment variable is required to get the password of the above mentioned user i.e. the user with all the privileges to the database. -
DB_HOST- It is used to get the database host from the env variables. Fordockerit must be set todbotherwise its default value islocalhost. -
DB_PORT- It is used to get the database port from the env variables. Different database backends have different ports. Its default value is of postgresql port i.e.5432.
To run the tests run: python manage.py test.
Before creating a pull-request, always run QA checks to make your code more readable and error-free. Steps to run QA checks are:
- Install QA checks dependencies:
pip install black==20.8b1 pip install isort==5.7.0 pip install flake8==3.8.4 - Run QA checks:
./osp-qa-checks.
- Make sure the latest version of docker and docker-compose are installed.
- For docker run
docker -vfrom your terminal. If docker is not installed, install it from here. - For docker-compose run
docker-compose -vfrom terminal. If it is not installed then install it by runningpip install docker-composeor from here.
- Change Database HOST in
settings.py
- Go to
main/settings.py - Under databases change host to db.
- Build docker image
Execute sudo docker-compose run web to build the image.
- Run docker image
Run sudo docker-compose up from the root directory of project. Navigate to http://localhost:8000 in your browser.
Note
- Run
docker-compose up --buildto rebuild the image. - To interact with docker containers use
docker exec -it {container id} bashfrom your terminal. Container id can be found usingdocker ps.
Documentation for the project is hosted here. Docusaurus has been used for maintaining the documentation of the project.
- Read the Meeting minutes notes from our open sessions about the project.
- For setting up the project locally watch this video.
- To learn about the project's initial features, watch the video of project demonstration.
- Design and Mocks Google Drive folder.
- Timeline deliverables for the project during GSoC 2020.
- GSoC 2020 Project Meeting Minutes [Old].
For more information, you can read backend project wiki and the web project wiki.
Please read the Contributing guidelines, Code of Conduct and Reporting Guidelines
Thanks goes to these people (emoji key):
 Shipra Verma 🚧 |
 Sankalp 🚧 |
 Kesha K. Kaneria 🚧 |
This project follows the all-contributors specification. Contributions of any kind welcome!
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 #anitab-forms and ask questions or intereact with the community. Join Us!
AnitaB Forms Backend is licensed under the GNU General Public License v3.0. To know more about it you can read the LICENSE.
![allcontributors[bot] avatar](https://avatars.githubusercontent.com/in/23186?v=4 "allcontributors[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent