app-generator/sample-flask-auth-session

Flask User Authentication - Open-source Sample | AppSeed

Flask User Authentication

Open-source Flask project that implements a simple authentication system using Flask-Login library - Features:

• ✅ Up-to-date dependencies
• ✅ Authentication layer: Flask-Login
• ✅ UI: Bootstrap5 via CDN
• ✅ Free Support via Email and Discord.

Build from sources

Step #1 - Clone sources (this repo)

$ # Clone the sources
$ git clone https://github.com/app-generator/sample-flask-auth-session.git
$ cd sample-flask-auth-session

Step #2 - Create a virtual environment

$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .\env\Scripts\activate

Step #3 - Install dependencies

$ # Install requirements
$ pip3 install -r requirements.txt

Step #4 - Set Up Environment

$ # Set the FLASK_APP environment variable
$ (Unix/Mac) export FLASK_APP=run.py
$ (Windows) set FLASK_APP=run.py
$ (Powershell) $env:FLASK_APP = ".\run.py"

Step #5 - Create Tables (SQLite persistance)

$ # Create tables
$ flask shell
$ >>> from app import db
$ >>> db.create_all()

Step #6 - (optional) Enable DEBUG Environment (local development)

$ # Set up the DEBUG environment
$ # (Unix/Mac) export FLASK_ENV=development
$ # (Windows) set FLASK_ENV=development
$ # (Powershell) $env:FLASK_ENV = "development"

Step #7 - Start the project

$ # Run the application
$ # --host=0.0.0.0 - expose the app on all network interfaces (default 127.0.0.1)
$ # --port=5000    - specify the app port (default 5000)  
$ flask run --host=0.0.0.0 --port=5000
$
$ # Access the app in browser: http://127.0.0.1:5000/

Code-base structure

The project has a super simple structure, represented as bellow:

< PROJECT ROOT >
   |
   |-- app/
   |    |-- static/
   |    |    |-- <css, JS, images>    # CSS files, Javascripts files
   |    |
   |    |-- templates/
   |    |    |
   |    |    |-- index.html           # Index File
   |    |    |-- login.html           # Login Page
   |    |    |-- register.html        # Registration Page
   |    |    
   |    |
   |   config.py                      # Provides APP Configuration 
   |   forms.py                       # Defines Forms (login, register) 
   |   models.py                      # Defines app models 
   |   views.py                       # Application Routes 
   |
   |-- requirements.txt
   |-- run.py
   |
   |-- ************************************************************************

Resources

• Free Admin Dashboards - index provided by AppSeed
• Flask Social Login - blog article (includes a free sample)

---

Flask User Authentication - Free sample provided by AppSeed.

sample-flask-auth-session's Issues

Something's up with the requirements...

Error: While importing 'run', an ImportError was raised:

Traceback (most recent call last):
File "/Users/tomsmith/markingapp5000/env/lib/python3.9/site-packages/flask/cli.py", line 256, in locate_app
import(module_name)
File "/Users/tomsmith/markingapp5000/run.py", line 6, in
from app import app, db
File "/Users/tomsmith/markingapp5000/app/init.py", line 10, in
from flask_login import LoginManager
File "/Users/tomsmith/markingapp5000/env/lib/python3.9/site-packages/flask_login/init.py", line 16, in
from .login_manager import LoginManager
File "/Users/tomsmith/markingapp5000/env/lib/python3.9/site-packages/flask_login/login_manager.py", line 24, in
from .utils import (login_url as make_login_url, _create_identifier,
File "/Users/tomsmith/markingapp5000/env/lib/python3.9/site-packages/flask_login/utils.py", line 13, in
from werkzeug.security import safe_str_cmp
ImportError: cannot import name 'safe_str_cmp' from 'werkzeug.security' (/Users/tomsmith/markingapp5000/env/lib/python3.9/site-packages/werkzeug/security.py)

(env) Toms-MBP:markingapp5000 tomsmith$ python
Python 3.9.9 (main, Nov 21 2021, 03:23:42)
[Clang 13.0.0 (clang-1300.0.29.3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.

from werkzeug.security import safe_str_cmp
Traceback (most recent call last):
File "", line 1, in
ImportError: cannot import name 'safe_str_cmp' from 'werkzeug.security' (/Users/tomsmith/markingapp5000/env/lib/python3.9/site-packages/werkzeug/security.py)