pascal273 / python-oc-lettings Goto Github PK

Orange County Lettings Website

• GitHub account with read access to this repository
• Git CLI
• SQLite3 CLI
• Python interpreter, version 3.6 or higher

In the rest of the local development documentation, it is assumed the command python in your OS shell runs the above Python interpreter (unless a virtual environment is activated).

• cd /path/to/put/project/in
• git clone https://github.com/OpenClassrooms-Student-Center/Python-OC-Lettings.git

• cd /path/to/Python-OC-Lettings
• python -m venv venv
• apt-get install python3-venv (If previous step errors with package not found on Ubuntu)
• Activate the environment source venv/bin/activate
• Confirm the command python now runs the Python interpreter in the virtual environment, which python
• Confirm the version of the Python interpreter is 3.6 or higher python --version
• Confirm the command pip runs the pip executable in the virtual environment, which pip
• To deactivate the environment, deactivate

• cd /path/to/Python-OC-Lettings
• source venv/bin/activate
• pip install --requirement requirements.txt
• python manage.py runserver
• Go to http://localhost:8000 in a browser.
• Confirm the site is running and can be navigated (you should see several profiles and lettings).

• cd /path/to/Python-OC-Lettings
• source venv/bin/activate
• flake8

• cd /path/to/Python-OC-Lettings
• source venv/bin/activate
• pytest

• cd /path/to/Python-OC-Lettings
• Open a shell session sqlite3
• Connect to the database .open oc-lettings-site.sqlite3
• Display tables in the database .tables
• Display columns in the profiles table, pragma table_info(Python-OC-Lettings_profile);
• Run a query on the profiles table, select user_id, favorite_city from Python-OC-Lettings_profile where favorite_city like 'B%';
• .quit to exit

• Go to http://localhost:8000/admin
• Login with user admin, password Abc1234!

Using PowerShell, as above except:

• To activate the virtual environment, .\venv\Scripts\Activate.ps1
• Replace which <my-command> with (Get-Command <my-command>).Path

This application is configured to be connected to a circleci pipeline.

Everytime a code change is pushed to the git repository on any branch, it triggers a build and test job that is configured to:

• build an image of that application inside a container
• run a flake8 check
• run a set of unittests

Only changes to the master branch will additionally trigger:

• A containerization job that will:

  • Only execute after the test job was successful!
  • Build a docker image of that application inside a container
  • Push that image to the dockerhub repository

• A Deployment job that will:

  • Only execute after the containerization was a success!
  • Push and deploy that docker image to heroku.

The Django secret key is used to provide cryptographic signing. This key is mostly used to sign session cookies. If one were to have this key, they would be able to modify the cookies sent by the application.

Generate secret key for the application:

• You can visit https://djecrety.ir/ to generate a secret key.
• Or use the get_random_secret_key() function present in django.core.management.utils:
  • to do that run: python manage.py shell and enter the following lines:

    from django.core.management.utils import get_random_secret_key
    print(get_random_secret_key())
    

• Copy and save the generated secret key!

1. A Github account with a repo in which this application was cloned to.

2. A Docker account, to push the container image to.

3. A Sentry account to log uncaught errors and crashes of the application:

• After log in, go to Projects and click Create Project
• Select the platform: DJANGO
• Setup your default alert settings
• Enter a Project name
• Click on Create Project
• copy and save the value of the dsn variable > without quotation marks!

4. A Heroku account for deployment:

• Environment:

  • After log in, click on new > create a new app
  • Inside that app click on Settings > Reveal Config Vars
  • Add the following KEY | VALUE pairs:
    • SECRET_KEY | -your generated secret key-
    • SENTRY_DSN | -your sentry dsn-

• If you don't have an API Key for heroku already, generate your HEROKU_API_KEY:

  • click on Account > Account Settings
  • inside the account tab scroll down to API Key
  • click on Generate API Key

5. A Circleci account, that connects to the git repo of this project:

• Inside your project go to: Project Settings > Environment Variables
• click on Add Environment Variable
• add the following KEY | VALUE pairs to your environment:
  • DOCKER_LOGIN | -your docker profile name-
  • DOCKER_PASSWORD | -your docker password-
  • DOCKER_REPO | -your docker repository-
  • HEROKU_API_KEY | -your heroku api key-
  • HEROKU_APP_NAME | -your heroku app name-