feat: configuring password generator

Author: MeelahMe

app/main.py

@@ -1,12 +1,13 @@
 from fastapi import FastAPI
-from app.routes import json_tools, uuid_tools, base64_tools, time_tools
+from app.routes import json_tools, uuid_tools, base64_tools, time_tools, password_tools
 
 app = FastAPI(title="Developer Toolkit API")
 
 app.include_router(json_tools.router)
 app.include_router(uuid_tools.router)
 app.include_router(base64_tools.router)
 app.include_router(time_tools.router)
+app.include_router(password_tools.router)
 
 @app.get("/")
 def read_root():

app/routes/password_tools.py

@@ -0,0 +1,57 @@
+from fastapi import APIRouter, Query, HTTPException
+from pydantic import BaseModel, Field
+import random
+import string
+
+router = APIRouter(prefix="/tools/password", tags=["Password Tools"])
+
+# Response model for password generation
+class PasswordResponse(BaseModel):
+    password: str = Field(
+        example="a9B!7xTq@1l#",
+        description="A randomly generated password"
+    )
+
+@router.get(
+    "/generate",
+    response_model=PasswordResponse,
+    summary="Generate a secure random password",
+    response_description="Returns a randomly generated password based on query parameters"
+)
+def generate_password(
+    length: int = Query(12, ge=4, le=128, description="Length of the password"),
+    include_symbols: bool = Query(True, description="Include special characters"),
+    include_numbers: bool = Query(True, description="Include digits"),
+    include_uppercase: bool = Query(True, description="Include uppercase letters"),
+    include_lowercase: bool = Query(True, description="Include lowercase letters")
+):
+    """
+    Generate a secure, random password.
+
+    You can customize:
+    - Length
+    - Whether to include symbols, numbers, uppercase, and lowercase characters
+
+    Returns:
+        A JSON object containing the generated password.
+    """
+    character_pool = ""
+
+    if include_lowercase:
+        character_pool += string.ascii_lowercase
+    if include_uppercase:
+        character_pool += string.ascii_uppercase
+    if include_numbers:
+        character_pool += string.digits
+    if include_symbols:
+        character_pool += string.punctuation
+
+    if not character_pool:
+        raise HTTPException(
+            status_code=400,
+            detail="At least one character set must be selected."
+        )
+
+    password = ''.join(random.choices(character_pool, k=length))
+    return {"password": password}
+

app/routes/time_tools.py

@@ -3,6 +3,7 @@
 from typing import Optional
 from typing import Union
 from datetime import datetime
+from datetime import timezone
 
 
 router = APIRouter(prefix="/tools/time", tags=["Time Tools"])
@@ -48,11 +49,11 @@ def convert_time(data: TimeConversionInput):
     """
     try:
         if data.timestamp is not None:
-            dt = datetime.fromtimestamp(data.timestamp)
+            dt = datetime.utcfromtimestamp(data.timestamp)
             return {"date_string": dt.isoformat()}
 
         elif data.date_string is not None:
-            dt = datetime.fromisoformat(data.date_string)
+            dt = datetime.fromisoformat(data.date_string).replace(tzinfo=timezone.utc)
             return {"timestamp": int(dt.timestamp())}
 
         else:

tests/test_json_tools.py

@@ -18,5 +18,6 @@ def test_prettify_invalid_json():
         json={"content": "{name: Jameelah"}  # Invalid JSON
     )
     assert response.status_code == 400
-    assert response.json()["detail"] == "Invalid JSON input."
+    assert response.json()["detail"] == "Invalid JSON string."
+
 

tests/test_password_tools.py

@@ -0,0 +1,30 @@
+from fastapi.testclient import TestClient
+from app.main import app
+
+client = TestClient(app)
+
+def test_generate_password_default():
+    response = client.get("/tools/password/generate")
+    assert response.status_code == 200
+    data = response.json()
+    assert "password" in data
+    assert len(data["password"]) == 12  # Default length
+
+def test_generate_password_custom_length():
+    response = client.get("/tools/password/generate?length=20")
+    assert response.status_code == 200
+    assert len(response.json()["password"]) == 20
+
+def test_generate_password_without_symbols():
+    response = client.get("/tools/password/generate?include_symbols=false")
+    assert response.status_code == 200
+    password = response.json()["password"]
+    assert all(char.isalnum() or char in string.ascii_letters + string.digits for char in password)
+
+def test_generate_password_with_all_sets_false():
+    response = client.get(
+        "/tools/password/generate?include_symbols=false&include_numbers=false&include_uppercase=false&include_lowercase=false"
+    )
+    assert response.status_code == 400
+    assert response.json()["detail"] == "At least one character set must be selected."
+

tests/test_time_tools.py

@@ -12,5 +12,6 @@ def test_convert_timestamp_to_date():
 def test_convert_date_to_timestamp():
     response = client.post("/tools/time/convert", json={"date_string": "2021-01-01T00:00:00"})
     assert response.status_code == 200
-    assert response.json()["timestamp"] == 1609459200
+    assert response.json()["timestamp"] == 1609459200  # This assumes UTC!
+