Add step folders

Author: acsany

fastapi-url-shortener/source_code_step_1/README.md

@@ -0,0 +1,67 @@
+# FastAPI URL Shortener
+
+## Install the Project
+
+1. Create a Python virtual environment
+
+```sh
+$ python -m venv venv
+$ source venv/bin/activate
+(venv) $
+```
+
+2. Install the requirements
+
+```
+(venv) $ python -m pip install -r requirements.txt
+```
+
+## Run the Project
+
+You can run the project with this command in your terminal:
+
+```sh
+(venv) $ uvicorn shortener_app.main:app --reload
+```
+
+Your server will reload automacially when you change a file.
+
+## Verify Your Environment Variables
+
+The project provides default environment settings in [`shortener_app/config.py`](shortener_app/config.py).
+While you can use the default settings, [it's recommended](https://12factor.net/config) to create a `.env` file to store your settings outside of your production code. E.g.:
+
+```config
+# .env
+ENV_NAME="Development"
+BASE_URL="http://url.shortener"
+DB_URL="sqlite:///./test_database.db"
+```
+
+With an `.env` file that contains the `ENV_NAME` variable with the value `"Development"` you can verify if your external `.env` file loads correctly:
+
+```pycon
+>>> from shortener_app.config import get_settings
+>>> get_settings().env_name
+... loading Settings
+'Development'
+```
+
+To get an overview of the environment variables you can set, check the [`shortener_app/config.py`](shortener_app/config.py) file.
+
+> ☝️ **Note:** You should never add the `.env` file to your version control system. 
+
+## Visit the Documentation
+
+When the project is running you can visit the documentation in your browser:
+
+- http://127.0.0.1:8000/docs
+- http://127.0.0.1:8000/redoc
+
+## About the Author
+
+Philipp Acsany - Email: [email protected]
+
+## License
+
+Distributed under the MIT license. See `LICENSE` in the root directory of this `materials` repo for more information.

fastapi-url-shortener/source_code_step_1/requirements.txt

@@ -0,0 +1,16 @@
+anyio==3.6.0
+asgiref==3.5.1
+click==8.1.3
+decorator==5.1.1
+fastapi==0.75.0
+h11==0.13.0
+idna==3.3
+pydantic==1.9.0
+python-dotenv==0.19.2
+six==1.16.0
+sniffio==1.2.0
+SQLAlchemy==1.4.32
+starlette==0.17.1
+typing_extensions==4.2.0
+uvicorn==0.17.6
+validators==0.18.2

fastapi-url-shortener/source_code_step_1/shortener_app/__init__.py

@@ -0,0 +1,19 @@
+from functools import lru_cache
+
+from pydantic import BaseSettings
+
+
+class Settings(BaseSettings):
+    env_name: str = "Local"
+    base_url: str = "http://localhost:8000"
+    db_url: str = "sqlite:///./shortener.db"
+
+    class Config:
+        env_file = ".env"
+
+
+@lru_cache
+def get_settings() -> Settings:
+    settings = Settings()
+    print(f"Loading settings for: {settings.env_name}")
+    return settings

fastapi-url-shortener/source_code_step_1/shortener_app/config.py

@@ -0,0 +1,67 @@
+# FastAPI URL Shortener
+
+## Install the Project
+
+1. Create a Python virtual environment
+
+```sh
+$ python -m venv venv
+$ source venv/bin/activate
+(venv) $
+```
+
+2. Install the requirements
+
+```
+(venv) $ python -m pip install -r requirements.txt
+```
+
+## Run the Project
+
+You can run the project with this command in your terminal:
+
+```sh
+(venv) $ uvicorn shortener_app.main:app --reload
+```
+
+Your server will reload automacially when you change a file.
+
+## Verify Your Environment Variables
+
+The project provides default environment settings in [`shortener_app/config.py`](shortener_app/config.py).
+While you can use the default settings, [it's recommended](https://12factor.net/config) to create a `.env` file to store your settings outside of your production code. E.g.:
+
+```config
+# .env
+ENV_NAME="Development"
+BASE_URL="http://url.shortener"
+DB_URL="sqlite:///./test_database.db"
+```
+
+With an `.env` file that contains the `ENV_NAME` variable with the value `"Development"` you can verify if your external `.env` file loads correctly:
+
+```pycon
+>>> from shortener_app.config import get_settings
+>>> get_settings().env_name
+... loading Settings
+'Development'
+```
+
+To get an overview of the environment variables you can set, check the [`shortener_app/config.py`](shortener_app/config.py) file.
+
+> ☝️ **Note:** You should never add the `.env` file to your version control system. 
+
+## Visit the Documentation
+
+When the project is running you can visit the documentation in your browser:
+
+- http://127.0.0.1:8000/docs
+- http://127.0.0.1:8000/redoc
+
+## About the Author
+
+Philipp Acsany - Email: [email protected]
+
+## License
+
+Distributed under the MIT license. See `LICENSE` in the root directory of this `materials` repo for more information.

fastapi-url-shortener/source_code_step_2/README.md

@@ -0,0 +1,16 @@
+anyio==3.6.0
+asgiref==3.5.1
+click==8.1.3
+decorator==5.1.1
+fastapi==0.75.0
+h11==0.13.0
+idna==3.3
+pydantic==1.9.0
+python-dotenv==0.19.2
+six==1.16.0
+sniffio==1.2.0
+SQLAlchemy==1.4.32
+starlette==0.17.1
+typing_extensions==4.2.0
+uvicorn==0.17.6
+validators==0.18.2

fastapi-url-shortener/source_code_step_2/requirements.txt

@@ -0,0 +1,19 @@
+from functools import lru_cache
+
+from pydantic import BaseSettings
+
+
+class Settings(BaseSettings):
+    env_name: str = "Local"
+    base_url: str = "http://localhost:8000"
+    db_url: str = "sqlite:///./shortener.db"
+
+    class Config:
+        env_file = ".env"
+
+
+@lru_cache
+def get_settings() -> Settings:
+    settings = Settings()
+    print(f"Loading settings for: {settings.env_name}")
+    return settings

fastapi-url-shortener/source_code_step_2/shortener_app/__init__.py

@@ -0,0 +1,13 @@
+from sqlalchemy import create_engine
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+
+from .config import get_settings
+
+engine = create_engine(
+    get_settings().db_url, connect_args={"check_same_thread": False}
+)
+SessionLocal = sessionmaker(
+    autocommit=False, autoflush=False, bind=engine
+)
+Base = declarative_base()

fastapi-url-shortener/source_code_step_2/shortener_app/config.py

@@ -0,0 +1,69 @@
+import secrets
+import validators
+
+from fastapi import Depends, FastAPI, HTTPException, Request
+from fastapi.responses import RedirectResponse
+from sqlalchemy.orm import Session
+
+from . import models, schemas
+from .database import SessionLocal, engine
+
+app = FastAPI()
+models.Base.metadata.create_all(bind=engine)
+
+
+def get_db():
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()
+
+
+def raise_bad_request(message):
+    raise HTTPException(status_code=400, detail=message)
+
+
+def raise_not_found(request):
+    message = f"URL '{request.url}' doesn't exist"
+    raise HTTPException(status_code=404, detail=message)
+
+
+@app.get("/")
+def read_root():
+    return "Welcome to the URL shortener API :)"
+
+
+@app.post("/url", response_model=schemas.URLInfo)
+def create_url(url: schemas.URLBase, db: Session = Depends(get_db)):
+    if not validators.url(url.target_url):
+        raise_bad_request(message="Your provided URL is not valid")
+
+    chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+    key = "".join(secrets.choice(chars) for _ in range(5))
+    secret_key = "".join(secrets.choice(chars) for _ in range(8))
+    db_url = models.URL(
+        target_url=url.target_url, key=key, secret_key=secret_key
+    )
+    db.add(db_url)
+    db.commit()
+    db.refresh(db_url)
+    db_url.url = key
+    db_url.admin_url = secret_key
+
+    return db_url
+
+
+@app.get("/{url_key}")
+def forward_to_target_url(
+    url_key: str, request: Request, db: Session = Depends(get_db)
+):
+    db_url = (
+        db.query(models.URL)
+        .filter(models.URL.key == url_key, models.URL.is_active)
+        .first()
+    )
+    if db_url:
+        return RedirectResponse(db_url.target_url)
+    else:
+        raise_not_found(request)