IIITDM Alumni Connect

This web application aims to facilitate the Alumni Affairs of IIITDM Jabalpur. Please read the contributing guidelines before starting.

Requirements

• Python: 3.9 and above
• Django: 2.2.28
• And additional requirements are in requirements.txt. These will automatically be installed with the below steps.

Setting Up Python Environment with pyenv

• For Windows

  • Open Command Prompt (cmd) as an administrator.

  $ git clone https://github.com/pyenv-win/pyenv-win.git %USERPROFILE%\.pyenv
  $ setx PYENV "%USERPROFILE%\.pyenv"
  $ setx PATH "%PYENV%\bin;%PYENV%\shims;%PATH%"
  

• For Linux

• Open Terminal

  $ sudo apt update
  $ sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \xz-utils tk-dev libffi-dev liblzma-dev python3-openssl git
  

• Run $ curl https://pyenv.run | bash
• Clone the repository $ git clone https://github.com/pyenv-win/pyenv-win.git %USERPROFILE%\.pyenv
• Add pyenv to your shell configuraion

  $ echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
  $ echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
  $ echo 'eval "$(pyenv init --path)"' >> ~/.bashrc
  $ echo 'eval "$(pyenv init -)"' >> ~/.bashrc
  

How to run it?

• Fork the repository.
• Clone the repository to your local machine $ git clone https://github.com/<your-github-username>/alumni.git
• Change directory to alumni $ cd alumni
• Add a reference to the original repository $ git remote add upstream https://github.com/BitByte-TPC/alumni.git
• Install the required version of Python for the project $ pyenv install 3.9
• Set the local Python version for the project $ pyenv local 3.9
• Install virtualenv $ pip3 install virtualenv
• Create a virtual environment $ virtualenv env -p python3
• Activate the env: $ source env/bin/activate (for linux) > ./env/Scripts/activate (for Windows PowerShell)
• Install the requirements: $ pip install -r requirements.txt
  Note: If some requirement causes some error, remove the version from that requirement (ex. convert anyjson==0.3.3 to anyjson) and run the above command again.
• Make migrations $ python manage.py makemigrations
• Migrate the changes to the database $ python manage.py migrate
• Run the server $ python manage.py runserver
• Create admin $ python manage.py createsuperuser
• Create tables $ python manage.py migrate --run-syncdb

Contributing

• Create a new branch with a related name of the motive. Branch name should follow these conventions.
  • feature/* if you're implementing a new feature or adding some new functionality.
  • refactor/* if you're refactoring code or upgrading anything.
  • bug/* if you've fixed a bug that's not deployed onto Production yet.
  • hotfix/* if you've fixed a bug that is deployed and/or causing problems in Production.
  • Note: DON'T push to master or release branch.
• Use an IDE linter, like SonarLint, to fix common bugs/code quality issues.
• Update your task's status in the provided spreadsheet.
• Send a pull request anytime :)