Skip to content

Latest commit

 

History

History
86 lines (49 loc) · 2.42 KB

CONTRIBUTING.md

File metadata and controls

86 lines (49 loc) · 2.42 KB

Contributing Guidelines

You are Awesome! Thank you for your Interest in Contributing to this Project 🤗 For Contributions we strictly follow Github Flow.

Contents

Setting Up the Project

  • The Project works seamlessly on Python version 3.8.6

  • Fork the Repository

  • Clone Your Forked copy - git clone https://github.com/[YOUR-USERNAME]/Kitabe.git

  • Navigate to the directory of project - cd Kitabe/

  • Create a new branch - git checkout -b [branch_name]

  • If you don't have virtualenv already installed - pip install virtualenv

  • Create a new environment - virtualenv bookenv

  • Activate the environment -

    • For Linux/Unix OS : source bookenv/bin/activate
    • For Windows OS: bookenv\Scripts\activate
  • Install requirements - pip install -r requirements.txt

  • Open BookRecSystem/settings.py

  • Set SECRET_KEY = "RANDOM_KEY"

  • Set ALLOWED_HOSTS = ['kitabe-app.herokuapp.com', '127.0.0.1', 'localhost']

  • Make Migrations - python manage.py migrate

  • python manage.py runserver - You're good to Go!!

Optional

Contributing

  • Please go through Github Flow, if not already. :)

  • Take up an Issue or Raise one.

  • Discuss your proposed changes & Get assigned.

  • If your changes are approved, do the changes in branch [branch_name].

  • Run tests

  • flake8, python manage.py test

  • Fix if any test fails.

  • Still in branch [branch_name].

  • Stage and Commit only the required files.

  • git push origin [branch_name] -u

  • Browse here and create a PR from your branch with the appropriate required details.

  • If your PR is accepted, it is automatically deployed once merged. :)

  • That's it!

Tip: To keep your Fork Repo all branches updated with Upstream use this.