Scalable URL Shortener API built with FastAPI

Author: lyushher

.github/workflows/deploy.yml

@@ -0,0 +1,26 @@
+name: Deploy to EC2
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: SSH into EC2 and deploy with Docker Compose
+        uses: appleboy/ssh-action@master
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ${{ secrets.EC2_USER }}
+          key: ${{ secrets.EC2_KEY }}
+          script: |
+            cd ~/app
+            git pull origin main
+            docker compose down
+            docker compose up -d --build

.gitignore

@@ -0,0 +1,4 @@
+venv/
+__pycache__/
+*.pyc
+.DS_Store

Dockerfile

@@ -0,0 +1,14 @@
+# 1. Python base image
+FROM python:3.10-slim
+
+# 2. Çalışma dizinini oluştur ve ayarla
+WORKDIR /app
+
+# 3. Gereken dosyaları kopyala
+COPY . .
+
+# 4. Gerekli paketleri yükle
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 5. Uvicorn ile başlat
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -0,0 +1,2 @@
+# Geçici bellek – ileride DB eklenecek
+url_db = {}

app/database.py

@@ -0,0 +1,19 @@
+from fastapi import FastAPI
+from fastapi.responses import RedirectResponse
+from app.schemas import URLRequest
+from app.services import generate_short_code, save_url, get_url
+
+app = FastAPI()
+
+@app.post("/shorten")
+def shorten_url(request: URLRequest):
+    short_code = generate_short_code()
+    save_url(short_code, request.long_url)
+    return {"short_url": f"http://localhost:8001/{short_code}"}
+
+@app.get("/{short_code}")
+def redirect_url(short_code: str):
+    long_url = get_url(short_code)
+    if long_url:
+        return RedirectResponse(url=long_url)
+    return {"error": "URL not found"}

app/main.py

@@ -0,0 +1,6 @@
+from pydantic import BaseModel
+
+class URLRequest(BaseModel):
+    long_url: str
+
+

app/schemas.py

@@ -0,0 +1,16 @@
+import string
+import random
+from app.database import url_db  # veritabani gibi davranan dict
+
+#kisa kod uretici
+def generate_short_code(length=6):
+    return ''.join(random.choices(string.ascii_letters + string.digits, k=length))
+
+# url kaydetme
+def save_url(short_code, long_url):
+    url_db[short_code] = long_url
+
+# url getirme (yonlendirme icin)
+def get_url(short_code):
+    return url_db.get(short_code)
+

app/services.py

@@ -0,0 +1,14 @@
+annotated-types==0.7.0
+anyio==4.9.0
+click==8.2.1
+exceptiongroup==1.3.0
+fastapi==0.116.1
+h11==0.16.0
+idna==3.10
+pydantic==2.11.7
+pydantic_core==2.33.2
+sniffio==1.3.1
+starlette==0.47.2
+typing-inspection==0.4.1
+typing_extensions==4.14.1
+uvicorn==0.35.0