anitab-forms-backend

KO | EN

gitlite — search

#javascript #python #react #typescript #go #deep-learning #linux #nodejs #windows #awesome #kubernetes #security #ios #open-source

anitab-forms-backend

(★ 17)

AnitaB Forms (backend), an application to process smaller 4-week or full day programs to contribute to open source projects. Similar to GSoC, Outreachy, or RGSoC. This is the backend app.

anitab-forms-backend Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Anitab Forms Backend

![Build Status](https://github.com/anitab-org/anitab-forms-backend/workflows/Tests%20Build/badge.svg)
[![project chat](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://anitab-org.zulipchat.com/#narrow/stream/237907-open-source-progs)
[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](http://www.gnu.org/licenses/gpl-3.0)
[![Open Source Love](https://badges.frapsoft.com/os/v3/open-source.svg?v=103)](https://github.com/anitab-org/anitab-forms-backend/)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/anitab-org/anitab-forms-backend)
![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)
[![codecov](https://codecov.io/gh/anitab-org/anitab-forms-backend/branch/develop/graph/badge.svg)](https://codecov.io/gh/anitab-org/anitab-forms-backend)

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.

## Tech Stack
- Django 3.0.7
- Django REST Framework 3.11.0
- Python 3.7+

## API Documentation
- [Postman Docs](https://documenter.getpostman.com/view/11324046/Szzoaw1q?version=latest)

## Setup 
To setup the project locally go through [this wiki page](https://github.com/anitab-org/anitab-forms-web/wiki/Fork,-Clone,-Remote-and-Pull-Request).
Make sure you have installed the following:
* [pip](https://pip.pypa.io/en/stable/installing/)
* [virtualenv](https://pypi.org/project/virtualenv/)
* [PostgreSQL](https://www.postgresql.org/docs/9.5/install-procedure.html)

Next follow these instructions.

1. **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 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;
    ```
2. **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 `download` or rename it to `download`. Place that download file in the project's directory. For more information follow [Environment Variables](#Environment-Variables) section.

3. Move into the project's directory.

```
    cd anitab-forms-backend
    ```
4. Create virtual environment (this is not a hard requirement, but its advisable)
    ```
    virtualenv venv
    ```
     Activating virtual environment for Linux users:
     ```
     source venv/bin/activate
     ```
     Activating virtual environment for Git Bash users:
     ```
     source ./venv/Scripts/activate
     ``` 
     Activating virtual environment for Windows users:   
     ``` 
     venv\Scripts\activate
     ```
5. To install dependencies:
    ```
    pip install -r requirements.txt
    ```	
6. Make sure you create `.env` using `.env.template` and update the values of corresponding environment variables or make sure you exported the following [environment variables](#Environment-Variables).

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

Follow the given instructions for Login into the app.

1. 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](#environment-variables). The content of the request must be like this:
 ```json
 {
 "username":"< YOUR USERNAME >",
 "email":"< YOUR EMAIL >",
 "password":"< YOUR PASSWORD >",
 "confirm_password":"< YOUR PASSWORD >" 
 }
 ```

2. To create the superuser run:
   ```
   python manage.py createsuperuser
   ````
   Fill up the things it asked to and then Login into the app.

## Environment Variables
1. `Zulip API KEY file` - You can go [Zulip](https://anitab-org.zulipchat.com) and follow [these instructions to get your API KEY](https://zulip.com/api/api-keys#get-your-api-key). Download the file and save it in the root folder of the project with the name `download`.

2. `SENDGRID_API_KEY` - It is optional for development. To use this variable make `DEBUG=False` in `settings.py`. Follow the given steps to create a Sendgrid API key:

1. Go to [Sendgrid's website](https://app.sendgrid.com/guide)
	2. Navigate to Settings on the left navigation bar, and then - select API Keys.
	3. Click Create API Key.
	4. Give your API key a name.
	5. 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.
	6. Click Create & View.
	7. 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>
```

3. `SECRET_KEY` - This environment variable is required for running the backend. Add `SECRET_KEY` in `.env` file or export it by using `export SECRET_KEY=<YOUR SECRET KEY>`.

4. `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](https://docs.djangoproject.com/en/3.1/ref/databases/). Its default backend is postgresql.

5. `DB_NAME` - This environment variable is required to get the name of the database. By default, its value is `osp`.

6. `DB_USERNAME` - This environment variable is required to get the **USERNAME** of the user with all privileges to the above mentioned database.

7. `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.

8. `DB_HOST` - It is used to get the database host from the env variables. For `docker` it must be set to `db` otherwise its default value is `localhost`.

9. `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`.

## Testing

To run the tests run: `python manage.py test`.

## QA Checks

Before creating a pull-request, always run QA checks to make your code more readable and error-free. Steps to run QA checks are:
1. Install QA checks dependencies:
    ```
    pip install black==20.8b1
    pip install isort==5.7.0
    pip install flake8==3.8.4
    ```
2. Run QA checks: `./osp-qa-checks`.

### Run with Docker

1. Make sure the latest version of docker and docker-compose are installed.

- For **docker** run ``docker -v`` from your terminal. If docker is not installed, install it from [here](https://docs.docker.com/engine/install/).
- For **docker-compose** run ``docker-compose -v`` from terminal. If it is not installed then install it by running ``pip install docker-compose`` or from [here](https://docs.docker.com/compose/install/).

2. Change Database HOST in ``settings.py``

- Go to ``main/settings.py``
- Under databases change host to db.

3. **Build docker image**

Execute ``sudo docker-compose run web`` to build the image.

4. **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 --build` to rebuild the image.
- To **interact** with docker containers use ``docker exec -it {container id} bash`` from your terminal. Container id can be found using ``docker ps``.

## Documentation
Documentation for the project is hosted [here](https://osp-backend-docs.surge.sh/). `Docusaurus` has been used for maintaining the documentation of the project.
- Read the [Meeting minutes](https://docs.google.com/document/d/1YF13IbBrU1ln4ZF1fOpgb-xGRgIF6tZLSjIBQgDmN7k/edit) notes from our open sessions about the project.
- For setting up the project locally watch [this video](https://youtu.be/_b2RQGbYN9w).
- To learn about the project's initial features, watch the video of [project demonstration](https://youtu.be/3A746GppZ0Y).
- [Design and Mocks Google Drive folder](https://drive.google.com/drive/folders/1MybSH3f8peXGUSRxhDydDtoAi8WJL1th).
- [Timeline deliverables for the project during GSoC 2020](https://docs.google.com/document/d/1xl9F5kMZrKo4mNhnP0SKpk7WkQc8PLca1ym7EZMpjSc/edit).
- [GSoC 2020 Project Meeting Minutes](https://docs.google.com/document/d/1YF13IbBrU1ln4ZF1fOpgb-xGRgIF6tZLSjIBQgDmN7k/edit) [Old].

For more information, you can read [backend project wiki](https://github.com/anitab-org/anitab-forms-backend/wiki) and the [web project wiki](https://github.com/anitab-org/anitab-forms-web/wiki).

## Contributing
Please read the [Contributing guidelines](.github/CONTRIBUTING.md), [Code of Conduct](CODE_OF_CONDUCT.md) and [Reporting Guidelines](REPORTING_GUIDELINES.md)

## Contributors

Thanks goes to these people ([emoji key](https://github.com/all-contributors/all-contributors#emoji-key)):

<table>
 <tr>
 <td align="center"><a href="https://github.com/Aaishpra"><img src="https://avatars.githubusercontent.com/u/66299533?v=4?s=100" width="100px;" alt=""/> Shipra Verma </a> <a href="#maintenance-Aaishpra" title="Maintenance">🚧</a></td>
 <td align="center"><a href="https://codesankalp.me/"><img src="https://avatars.githubusercontent.com/u/56037184?v=4?s=100" width="100px;" alt=""/> Sankalp</a> <a href="#maintenance-codesankalp" title="Maintenance">🚧</a></td>
 <td align="center"><a href="https://keshakaneria.me"><img src="https://avatars.githubusercontent.com/u/46588494?v=4?s=100" width="100px;" alt=""/> Kesha K. Kaneria</a> <a href="#maintenance-keshakaneria" title="Maintenance">🚧</a></td>
 </tr>
</table>

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.
Contributions of any kind welcome!

## Contact
You can reach the admins, maintainers and our community on [AnitaB.org Open Source Zulip](https://anitab-org.zulipchat.com/). If you are interested in contributing to the OSP project, you may join the stream [#anitab-forms](https://anitab-org.zulipchat.com/#narrow/stream/237907-open-source-progs) and ask questions or intereact with the community. Join Us!

## License
AnitaB Forms Backend is licensed under the GNU General Public License v3.0. To know more about it you can read the [LICENSE](LICENSE).

anitab-forms-backend

anitab-forms-backend Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

anitab-forms-backend

anitab-forms-backend Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README