From bb9fd9c78987f8ff7666c92901edc9a1c195bf5d Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Thu, 18 Sep 2025 21:32:13 -0500 Subject: [PATCH] feat: time-ui --- servers/time-ui/.dockerignore | 34 +++++ servers/time-ui/.webui_secret_key | 1 + servers/time-ui/Dockerfile | 51 ++++++++ servers/time-ui/README.md | 14 ++ servers/time-ui/compose.yaml | 7 + servers/time-ui/main.py | 208 ++++++++++++++++++++++++++++++ servers/time-ui/requirements.txt | 7 + 7 files changed, 322 insertions(+) create mode 100644 servers/time-ui/.dockerignore create mode 100644 servers/time-ui/.webui_secret_key create mode 100644 servers/time-ui/Dockerfile create mode 100644 servers/time-ui/README.md create mode 100644 servers/time-ui/compose.yaml create mode 100644 servers/time-ui/main.py create mode 100644 servers/time-ui/requirements.txt diff --git a/servers/time-ui/.dockerignore b/servers/time-ui/.dockerignore new file mode 100644 index 0000000..03a268b --- /dev/null +++ b/servers/time-ui/.dockerignore @@ -0,0 +1,34 @@ +# Include any files or directories that you don't want to be copied to your +# container here (e.g., local build artifacts, temporary files, etc.). +# +# For more help, visit the .dockerignore file reference guide at +# https://docs.docker.com/go/build-context-dockerignore/ + +**/.DS_Store +**/__pycache__ +**/.venv +**/.classpath +**/.dockerignore +**/.env +**/.git +**/.gitignore +**/.project +**/.settings +**/.toolstarget +**/.vs +**/.vscode +**/*.*proj.user +**/*.dbmdl +**/*.jfm +**/bin +**/charts +**/docker-compose* +**/compose.y*ml +**/Dockerfile* +**/node_modules +**/npm-debug.log +**/obj +**/secrets.dev.yaml +**/values.dev.yaml +LICENSE +README.md diff --git a/servers/time-ui/.webui_secret_key b/servers/time-ui/.webui_secret_key new file mode 100644 index 0000000..0bcb70c --- /dev/null +++ b/servers/time-ui/.webui_secret_key @@ -0,0 +1 @@ +I9NqZuYZF2k68nCw \ No newline at end of file diff --git a/servers/time-ui/Dockerfile b/servers/time-ui/Dockerfile new file mode 100644 index 0000000..e91fca9 --- /dev/null +++ b/servers/time-ui/Dockerfile @@ -0,0 +1,51 @@ +# syntax=docker/dockerfile:1 + +# Comments are provided throughout this file to help you get started. +# If you need more help, visit the Dockerfile reference guide at +# https://docs.docker.com/go/dockerfile-reference/ + +# Want to help us make this template better? Share your feedback here: https://forms.gle/ybq9Krt8jtBL3iCk7 + +ARG PYTHON_VERSION=3.10.12 +FROM python:${PYTHON_VERSION}-slim as base + +# Prevents Python from writing pyc files. +ENV PYTHONDONTWRITEBYTECODE=1 + +# Keeps Python from buffering stdout and stderr to avoid situations where +# the application crashes without emitting any logs due to buffering. +ENV PYTHONUNBUFFERED=1 + +WORKDIR /app + +# Create a non-privileged user that the app will run under. +# See https://docs.docker.com/go/dockerfile-user-best-practices/ +ARG UID=10001 +RUN adduser \ + --disabled-password \ + --gecos "" \ + --home "/nonexistent" \ + --shell "/sbin/nologin" \ + --no-create-home \ + --uid "${UID}" \ + appuser + +# Download dependencies as a separate step to take advantage of Docker's caching. +# Leverage a cache mount to /root/.cache/pip to speed up subsequent builds. +# Leverage a bind mount to requirements.txt to avoid having to copy them into +# into this layer. +RUN --mount=type=cache,target=/root/.cache/pip \ + --mount=type=bind,source=requirements.txt,target=requirements.txt \ + python -m pip install -r requirements.txt + +# Switch to the non-privileged user to run the application. +USER appuser + +# Copy the source code into the container. +COPY . . + +# Expose the port that the application listens on. +EXPOSE 8000 + +# Run the application. +CMD uvicorn 'main:app' --host=0.0.0.0 --port=8000 diff --git a/servers/time-ui/README.md b/servers/time-ui/README.md new file mode 100644 index 0000000..15327e6 --- /dev/null +++ b/servers/time-ui/README.md @@ -0,0 +1,14 @@ +# 🕒 Time Tool Server + +Blazingly fast time API server ⚡️ + +## 🚀 Quickstart + +```bash +git clone https://github.com/open-webui/openapi-servers +cd openapi-servers/servers/time +pip install -r requirements.txt +uvicorn main:app --host 0.0.0.0 --reload +``` + +You're live. ⏱️📡 \ No newline at end of file diff --git a/servers/time-ui/compose.yaml b/servers/time-ui/compose.yaml new file mode 100644 index 0000000..9fc4d98 --- /dev/null +++ b/servers/time-ui/compose.yaml @@ -0,0 +1,7 @@ +services: + server: + build: + context: . + ports: + - 8000:8000 + diff --git a/servers/time-ui/main.py b/servers/time-ui/main.py new file mode 100644 index 0000000..dd47813 --- /dev/null +++ b/servers/time-ui/main.py @@ -0,0 +1,208 @@ +from fastapi import FastAPI, HTTPException, Body +from fastapi.middleware.cors import CORSMiddleware +from fastapi.responses import HTMLResponse, RedirectResponse +from pydantic import BaseModel, Field +from datetime import datetime, timezone +from typing import Literal +import pytz +from dateutil import parser as dateutil_parser + +app = FastAPI( + title="Secure Time Utilities API", + version="1.0.0", + description="Provides secure UTC/local time retrieval, formatting, timezone conversion, and comparison.", +) + +origins = ["*"] +app.add_middleware( + CORSMiddleware, + allow_origins=origins, + allow_credentials=True, + allow_methods=["*"], + allow_headers=["*"], +) + + +# ------------------------------- +# Pydantic models +# ------------------------------- +class FormatTimeInput(BaseModel): + format: str = Field( + "%Y-%m-%d %H:%M:%S", description="Python strftime format string" + ) + timezone: str = Field( + "UTC", description="IANA timezone name (e.g., UTC, America/New_York)" + ) + + +class ConvertTimeInput(BaseModel): + timestamp: str = Field( + ..., description="ISO 8601 formatted time string (e.g., 2024-01-01T12:00:00Z)" + ) + from_tz: str = Field( + ..., description="Original IANA time zone of input (e.g. UTC or Europe/Berlin)" + ) + to_tz: str = Field(..., description="Target IANA time zone to convert to") + + +class ElapsedTimeInput(BaseModel): + start: str = Field(..., description="Start timestamp in ISO 8601 format") + end: str = Field(..., description="End timestamp in ISO 8601 format") + units: Literal["seconds", "minutes", "hours", "days"] = Field( + "seconds", description="Unit for elapsed time" + ) + + +class ParseTimestampInput(BaseModel): + timestamp: str = Field( + ..., description="Flexible input timestamp string (e.g., 2024-06-01 12:00 PM)" + ) + timezone: str = Field( + "UTC", description="Assumed timezone if none is specified in input" + ) + + +# ------------------------------- +# Helper for pretty HTML +# ------------------------------- +def html_page(title: str, body: str) -> HTMLResponse: + html = f""" + + + {title} + + + +

{title}

+ {body} + + + """ + return html + + +# ------------------------------- +# Routes +# ------------------------------- +@app.get("/get_current_local_time", summary="Current Local Time") +def get_current_local(): + local_time = datetime.now().isoformat() + headers = {"Content-Disposition": "inline"} + return HTMLResponse( + content=html_page("Current Local Time", f"
{local_time}
"), + headers=headers, + ) + + +@app.post("/format_time", summary="Format current time") +def format_current_time(data: FormatTimeInput): + try: + tz = pytz.timezone(data.timezone) + except Exception: + raise HTTPException( + status_code=400, detail=f"Invalid timezone: {data.timezone}" + ) + now = datetime.now(tz) + try: + formatted = now.strftime(data.format) + headers = {"Content-Disposition": "inline"} + return HTMLResponse( + content=html_page("Formatted Time", f"
{formatted}
"), + headers=headers, + ) + except Exception as e: + raise HTTPException(status_code=400, detail=f"Invalid format string: {e}") + + +@app.post("/convert_time", summary="Convert between timezones") +def convert_time(data: ConvertTimeInput): + try: + from_zone = pytz.timezone(data.from_tz) + to_zone = pytz.timezone(data.to_tz) + except Exception as e: + raise HTTPException(status_code=400, detail=f"Invalid timezone: {e}") + try: + dt = dateutil_parser.parse(data.timestamp) + if dt.tzinfo is None: + dt = from_zone.localize(dt) + else: + dt = dt.astimezone(from_zone) + converted = dt.astimezone(to_zone).isoformat() + headers = {"Content-Disposition": "inline"} + return HTMLResponse( + content=html_page("Converted Time", f"
{converted}
"), + headers=headers, + ) + except Exception as e: + raise HTTPException(status_code=400, detail=f"Invalid timestamp: {e}") + + +@app.post("/parse_timestamp", summary="Parse and normalize timestamps") +def parse_timestamp(data: ParseTimestampInput): + try: + tz = pytz.timezone(data.timezone) + dt = dateutil_parser.parse(data.timestamp) + if dt.tzinfo is None: + dt = tz.localize(dt) + dt_utc = dt.astimezone(pytz.utc).isoformat() + headers = {"Content-Disposition": "inline"} + return HTMLResponse( + content=html_page("Parsed Timestamp (UTC)", f"
{dt_utc}
"), + headers=headers, + ) + except Exception as e: + raise HTTPException(status_code=400, detail=f"Could not parse: {e}") + + +@app.get("/list_time_zones", summary="All valid time zones") +def list_time_zones(): + tz_list_html = ( + "" + ) + headers = {"Content-Disposition": "inline"} + return HTMLResponse( + content=html_page("Valid Time Zones", tz_list_html), headers=headers + ) + + +@app.get("/go_to_timezones", summary="Redirect to /list_time_zones") +def redirect_to_timezones(): + """ + Redirects user to the list of time zones. + """ + return RedirectResponse(url="/list_time_zones") + + +@app.get("/useful_redirect", summary="Redirect to useful external time resource") +def useful_redirect(): + """ + Redirects users to a useful external website (timeanddate.com). + """ + headers = {"Content-Disposition": "inline"} + external_url = "https://time.is" + return RedirectResponse(url=external_url, headers=headers) diff --git a/servers/time-ui/requirements.txt b/servers/time-ui/requirements.txt new file mode 100644 index 0000000..b08d10d --- /dev/null +++ b/servers/time-ui/requirements.txt @@ -0,0 +1,7 @@ +fastapi +uvicorn[standard] +pydantic +python-multipart + +pytz +python-dateutil \ No newline at end of file