https://github.com/andrewjbateman/python-postgres-heroku
:clipboard: Python-flask feedback form with data saved in postgreSQL database and app deployed to Heroku
https://github.com/andrewjbateman/python-postgres-heroku
css3 flask-sqlalchemy heroku-deployment html5 postgresql python3
Last synced: 2 months ago
JSON representation
:clipboard: Python-flask feedback form with data saved in postgreSQL database and app deployed to Heroku
- Host: GitHub
- URL: https://github.com/andrewjbateman/python-postgres-heroku
- Owner: AndrewJBateman
- Created: 2020-04-11T07:18:02.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-06-22T19:45:05.000Z (about 5 years ago)
- Last Synced: 2025-05-17T01:34:29.531Z (about 1 year ago)
- Topics: css3, flask-sqlalchemy, heroku-deployment, html5, postgresql, python3
- Language: HTML
- Homepage: https://lexusfeedbackformy.herokuapp.com/
- Size: 734 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# :zap: Python-Flask PostgreSQL Heroku
* App to display a feedback form using Python Flask, store the entered data in a PostgreSQL database then send an example email using mailtrap.io. Deployed to Heroku. Tutorial code from [Traversy Media, Youtube video: Build & Deploy A Python Web App | Flask, Postgres & Heroku](https://www.youtube.com/watch?v=w25ea_I89iM)
* **Note:** to open web links in a new window use: _ctrl+click on link_
## :page_facing_up: Table of contents
* [:zap: Python-Flask PostgreSQL Heroku](#zap-python-flask-postgresql-heroku)
* [:page_facing_up: Table of contents](#page_facing_up-table-of-contents)
* [:books: General info](#books-general-info)
* [:camera: Screenshots](#camera-screenshots)
* [:signal_strength: Technologies](#signal_strength-technologies)
* [:floppy_disk: Setup](#floppy_disk-setup)
* [:computer: Code Examples](#computer-code-examples)
* [:cool: Features](#cool-features)
* [:clipboard: Status & To-do list](#clipboard-status--to-do-list)
* [:clap: Inspiration](#clap-inspiration)
* [:envelope: Contact](#envelope-contact)
## :books: General info
* Choosing between Flask and Django Python frameworks - Flask is more lightweight and better for small apps such as this one
* PostgreSQL pgAdmin used to create database
## :camera: Screenshots
## :signal_strength: Technologies
* [Python v3](https://www.python.org/) programming language
* [Flask v1](https://palletsprojects.com/p/flask/) micro-framework
* [psycopg2 v2](https://pypi.org/project/psycopg2/) PostgreSQL database adapter for the Python programming language
* [flask-sqlalchemy v2](https://flask-sqlalchemy.palletsprojects.com/en/2.x/) extension for Flask that adds support for SQLAlchemy
* [gunicorn v20](https://gunicorn.org/) Python WSGI HTTP Server for UNIX
* [PostgreSQL](https://www.postgresql.org/) relational database
* [mailtrap](https://mailtrap.io/) safe Email Testing for Staging & Development
* [Heroku](https://www.heroku.com/what) cloud platform used to deploy app
## :floppy_disk: Setup
* Create PostgreSQL database and add access credential `SQLALCHEMY_DATABASE_URI` to your own config.py file (not in repo)
* Create mailtrap.io account and add access credentials `MAIL_LOGIN` and `MAIL_PASSWORD` to your own config.py file (not in repo)
* Run `pipenv shell` to activate project's virtual env. then `pipenv install` to install dependencies
* Run `python app.py` to open app in server `localhost: 5000`
## :computer: Code Examples
* code to submit completed form tto Postgres database
```python
@app.route('/submit', methods=['POST'])
def submit():
if request.method == 'POST':
customer = request.form['customer']
dealer = request.form['dealer']
rating = request.form['rating']
comments = request.form['comments']
if customer == '' or dealer == '':
return render_template('index.html', message='Please enter required fields')
if db.session.query(Feedback).filter(Feedback.customer == customer).count() == 0:
data = Feedback(customer, dealer, rating, comments)
db.session.add(data)
db.session.commit()
send_mail(customer, dealer, rating, comments)
return render_template('success.html')
return render_template('index.html', message='You have already submitted feedback')
```
## :cool: Features
* SQLAlchemy Object Relational Mapper presents a method of associating user-defined Python classes with the PostgreSQL database table used, and instances of those classes (objects) with rows in this table.
* Access credentials hidden from GitHub in `config.py` file
* [Heroku Python runtime](https://devcenter.heroku.com/articles/python-runtimes)
## :clipboard: Status & To-do list
* Status: Fully working in dev. Deployed to Heroku
* To-do: Use to create more advanced Python-PostgreSQL app
## :clap: Inspiration
* [Traversy Media, Youtube video: Build & Deploy A Python Web App | Flask, Postgres & Heroku](https://www.youtube.com/watch?v=w25ea_I89iM)
* [How to Install python 3.8 on Windows 10](https://www.youtube.com/watch?v=bnhQBUEpWlg)
## :file_folder: License
* N/A
## :envelope: Contact
* Repo created by [ABateman](https://github.com/AndrewJBateman), email: gomezbateman@yahoo.com