README.md

SQLAlchemy 2.0 Tutorial

Index

• SQLAlchemy 2.0 Tutorial
  • Index
  • Workflow
    • Step 1: Set up a project
    • Step 2: Initialize Alembic
    • Step 3: Create and apply migrations
    • Step 4: Make changes to models.py and managing migrations
    • Additional: Highlight Logs with Rich
    • Additional: Install Faker to seed database with fake data
  • Tech Stack

Workflow

Step 1: Set up a project

1. Create a project directory

2. Create a virtual environment

3. Install SQLAlchemy and Alembic

   • Install SQLAlchemy
     pip install SQLAlchemy

   • Install Alembic
     pip install alembic

     Alembic is a lightweight database migration tool for use with SQLAlchemy. It allows you to manage database schema changes in a version-controlled manner.

4. Create a models.py for your ORM Models

5. Create a database.py for database connection

Step 2: Initialize Alembic

1. Initialize Alembic $ alembic init alembic

2. Configure Alembic
   Edit alembic.ini to set the SQLAlchemy URL: (If you are using SQLite) sqlalchemy.url = sqlite:///<database_filename>.db

   • Configure Timezone

     [alembic]
     # ... other configurations
     timezone = Asia/Taipei

3. Configure the Alembic Environment
   Edit alembic/env.py to include your models. Modify the file to reflect your models' metadata.

   from models import Base
   target_metadata = Base.metadata

Step 3: Create and apply migrations

1. Create an initial migration
   alembic revision --autogenerate -m "Initial migration"

2. Apply the initial migration
   alembic upgrade head

Step 4: Make changes to models.py and managing migrations

1. Modify Your Models
   Make some changes in your SQLAlchemy models which is usually located in models.pys

2. Generate a New Migration
   alembic revision --autogenerate -m "Describe the changes"

3. Apply the New Migration
   alembic upgrade head

4. Other Alembic commands

   • Check current Alembic Migration
     alembic current

Additional: Highlight Logs with Rich

Rich is a Python library for rich text and beautiful formatting in the terminal. Use packages like Rich to highlight and format the logs of your database interactions in a more readable and visually appealing way.

1. Install Rich
   pip install rich

2. Configure SQLAlchemy Logging and Create a Custom Logging Handler with Rich

   # database.py
   import logging
   from rich.logging import RichHandler
   from sqlalchemy import create_engine
   from sqlalchemy.orm import sessionmaker
   from models import Base
   
   # Configure Rich logging
   logging.basicConfig(level=logging.INFO, format="%(message)s", datefmt="[%X]", handlers=[RichHandler()])
   
   # Get the logger for SQLAlchemy
   logger = logging.getLogger('sqlalchemy.engine')
   logger.setLevel(logging.INFO)
   
   # Database URL for SQLite
   DATABASE_URL = "sqlite:///medical_database.db"
   
   # Create an engine that will interact with the SQLite database
   engine = create_engine(DATABASE_URL, echo=False)  # Set echo=False and use logging instead
   
   # Create a configured "Session" class
   SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
   
   # Function to initialize the database
   def init_db():
       Base.metadata.create_all(bind=engine)
   
   if __name__ == "__main__":
       init_db()
       logging.info("Database and tables created successfully.")

Additional: Install Faker to seed database with fake data

Faker is a Python package that generates fake data for various purposes, such as names, addresses, dates, and more.

1. Install Faker
   pip install faker

2. Import Faker and create an instance of Faker

   # seed_data.py
   from faker import Faker
   from database import SessionLocal
   from models import Hospital
   
   # Create an instance of Faker
   fake = Faker()
   
   # Create a hospital with fake data
   def create_fake_hospital():
       try:
           with SessionLocal() as session:
               doctor = Hospital(
                   name=fake.company() # Use Faker to generate a fake company name as a hospital name
                   address=fake.address() # User Faker to generate a fake address
               )
   
       except Exception as e:
           print(e)

   Other usage can be found in Faker official documentation.

Tech Stack

• Python: General-purpose programming language for writing code.
• SQLAlchemy: ORM for managing database connections and operations.
• Alembic: Database migration tool for SQLAlchemy.
• Rich: Library for rich text and formatting in the terminal.
• Faker: Library for generating fake data for testing.