GitHub - spec-nith/spec-backend: Django backend for SPEC Website

Logo

Official Codebase
Report Bug ยท Request a Feature

Contributors Forks Stargazers Issues

๐Ÿ“ General Overview

This repository contains the source code of Django Backend for the official website of Society for Promotion of Electronics Culture (SPEC), NIT Hamirpur from 2021 onwards.

Visit the current official website of SPEC from here.

โš™๏ธ Set-Up and Usage

For Linux (Debian) users:

  • To install the base-dependencies of the project:

  • To install the environment with all its optional dependencies:

  • You can use make commands to perform various operations:

    • Start django server on port 8000:

      Note: You can customize it default port by editing PORT variable in Makefile.

    • To run the project in SECURE SSL mode, use:

    • Apply database migrations using:

    • Flush/Clear database records:

      Note: Media files will not be deleted using this command

    • Check for proper formatting and sort imports using:

    • To run Django Test-Suite:

    • To run all formatting and coverage tests:

For Windows users:

  • To set up the environment:

  • To activate the virtual environment

Note: All the make commands are same as in GNU, the difference ensues from how they are called. For example:

  • For Linux:

  • For Windows:

๐ŸŽฏ Contributing Guidelines

Contributions are what make the open source community such an amazing place to learn, inspire and build experiences that are cherished for a lifetime. Go ahead and follow these steps to contribute to the community.

  • Fork this repository by clicking on Fork button on the top right side.

  • Clone your Fork to your local machine

    git clone [git@github.com:spec-nith/spec-backend.git]
    
  • Create your Feature Branch

    git checkout -b [branch-name]
    
  • Make your changes and commit them

    git add . 
    git commit -m "Add some amazing feature" 
    
  • To check the status

  • And then push the changes to your forked repository

    git push origin [branch name]
    
  • Click on the New Pull Request button at the top of your repository to create a new pull request from your forked repository.

  • Wait for your PR review and merge approval.

  • Don't forget to โญ this repository.