v0.1.0rc5

.devcontainer/devcontainer.json

@@ -1,9 +1,15 @@
 {
   "name": "Tux Development Container",
-  "dockerFile": "../Dockerfile",
+  "dockerFile": "../Containerfile",
   "context": "..",
-  "runArgs": ["--init", "--env-file", ".env"],
-  "forwardPorts": [3000],
+  "runArgs": [
+    "--init",
+    "--env-file",
+    ".env"
+  ],
+  "forwardPorts": [
+    3000
+  ],
   "workspaceMount": "source=${localWorkspaceFolder},target=/app,type=bind",
   "workspaceFolder": "/app",
   "build": {
@@ -21,7 +27,6 @@
         "ms-python.python",
         "detachhead.basedpyright",
         "charliermarsh.ruff",
-        "prisma.prisma",
         "kevinrose.vsc-python-indent",
         "mikestead.dotenv",
         "njpwerner.autodocstring",

.dockerignore

@@ -50,8 +50,8 @@ logs/
 .gitattributes
 
 # Docker files (prevent recursive inclusion)
-Dockerfile*
-docker-compose*.yml
+Containerfile*
+compose.yaml
 .dockerignore
 
 # Cache directories

.docstr.yaml

@@ -0,0 +1,31 @@
+---
+
+# paths:  # list or string
+#   - docstr_coverage
+# badge: docs  # Path
+# exclude: .*/test  # regex
+# verbose: 3  # int (0-4)
+# skip_magic: True  # Boolean
+# skip_file_doc: True  # Boolean
+# skip_init: True  # Boolean
+# skip_class_def: True  # Boolean
+# skip_private: True  # Boolean
+# follow_links: True  # Boolean
+# accept_empty: True  # Boolean
+# ignore_names_file: .*/test  # regex
+# fail_under: 90  # int
+# percentage_only: True  # Boolean
+# ignore_patterns:  # Dict with key/value pairs of file-pattern/node-pattern
+#   .*: method_to_ignore_in_all_files
+#   FileWhereWeWantToIgnoreAllSpecialMethods: "__.+__"
+#   SomeFile:
+#     - method_to_ignore1
+#     - method_to_ignore2
+#     - method_to_ignore3
+#   a_very_important_view_file:
+#     - "^get$"
+#     - "^set$"
+#     - "^post$"
+#   detect_.*:
+#     - "get_val.*"
+exclude: (?:(?:^|.*/)(?:\.venv|examples|\.archive|typings|tests|\.kiro|\.audit)(?:/|$))|(?:(?:^|.*/)src/tux/database/migrations(?:/versions)?(?:/|$))|(?:(?:^|.*/)migrations(?:/|$))

.editorconfig

@@ -33,10 +33,10 @@ indent_size = 4
 indent_size = 2
 
 # Docker files
-[{Dockerfile,*.dockerfile}]
-indent_size = 4
+[Containerfile]
+indent_size = 8
 
-[docker-compose*.yml]
+[compose.yaml]
 indent_size = 2
 
 # Shell scripts
@@ -65,7 +65,7 @@ indent_size = 4
 indent_size = 4
 
 # Lock files (read-only, preserve formatting)
-[{poetry.lock,package-lock.json,yarn.lock,Pipfile.lock}]
+[{uv.lock,package-lock.json,yarn.lock,Pipfile.lock}]
 insert_final_newline = false
 trim_trailing_whitespace = false
 

.env.example

@@ -1,73 +1,76 @@
-# Tux Environment Configuration (.env.example)
-# -------------------------------------------
-# Copy this file to .env and fill in the values.
-# Do NOT commit your actual .env file to version control.
-
-# Core Requirements
-# -----------------
-# These variables are fundamental and required depending on the mode.
-
-# Database URLs (Required: one depending on mode)
-# The application uses DEV_DATABASE_URL when run with '--dev' flag,
-# and PROD_DATABASE_URL otherwise (production mode).
-DEV_DATABASE_URL=""
-PROD_DATABASE_URL=""
-
-# Bot Tokens (Required: one depending on mode)
-# The application uses DEV_BOT_TOKEN when run with '--dev' flag,
-# and PROD_BOT_TOKEN otherwise (production mode).
-DEV_BOT_TOKEN=""
-PROD_BOT_TOKEN=""
-
-# Development Specific Settings
-# ---------------------------
-# These settings primarily affect development mode ('--dev').
-
-# Cogs to ignore during development (Optional, comma-separated)
-# Example: DEV_COG_IGNORE_LIST="somecog,anothercog"
-DEV_COG_IGNORE_LIST="rolecount,mail,git" # Default ignores ATL-specific cogs
-
-# Production Specific Settings
-# --------------------------
-# These settings primarily affect production mode (no '--dev' flag).
-
-# Cogs to ignore in production (Optional, comma-separated)
-# Example: PROD_COG_IGNORE_LIST="debugcog"
-PROD_COG_IGNORE_LIST="rolecount,mail,git" # Default ignores ATL-specific cogs
-
-# Optional Feature Configuration
-# ----------------------------
-# Fill these variables to enable optional integrations.
-
-# Sentry (Error Tracking)
-# SENTRY_DSN=""
-
-# Wolfram Alpha (Math/Science Queries)
-# MAKE SURE THIS IS FOR THE SIMPLE API OR IT WILL NOT WORK
-# WOLFRAM_APP_ID=""
-
-# InfluxDB (Metrics/Logging)
-# ------------------
-
-# INFLUXDB_TOKEN=""
-# INFLUXDB_URL=""
-# INFLUXDB_ORG=""
-
-# GitHub Integration
-# ------------------
-# These variables are used for the ATL GitHub integration that is is used for creating issues quickly.
-# You can safely ignore these until we have a proper way to guide using them multi guild/self hosted wise.
-
-# GITHUB_APP_ID=
-# GITHUB_CLIENT_ID=""
-# GITHUB_CLIENT_SECRET=""
-# GITHUB_PUBLIC_KEY=""
-# GITHUB_INSTALLATION_ID=
-# GITHUB_PRIVATE_KEY_BASE64="" # Base64 encoded private key
-# GITHUB_REPO_URL=
-# GITHUB_REPO_OWNER=
-# GITHUB_REPO=
-
-# Mailcow Integration (Email related features)
-# MAILCOW_API_KEY=
-# MAILCOW_API_URL=
+### Config
+
+# DEBUG=false
+# BOT_TOKEN=""
+# POSTGRES_HOST="localhost"
+# POSTGRES_PORT=5432
+# POSTGRES_DB="tuxdb"
+# POSTGRES_USER="tuxuser"
+# POSTGRES_PASSWORD="ChangeThisToAStrongPassword123!"
+# DATABASE_URL=""
+# ALLOW_SYSADMINS_EVAL=false
+
+### BotInfo
+
+# BOT_INFO__BOT_NAME="Tux"
+# BOT_INFO__ACTIVITIES="[]"
+# BOT_INFO__HIDE_BOT_OWNER=false
+# BOT_INFO__PREFIX="$"
+
+### UserIds
+
+# USER_IDS__BOT_OWNER_ID=0
+# USER_IDS__SYSADMINS=[]
+
+### StatusRoles
+
+# STATUS_ROLES__MAPPINGS=[]
+
+### TempVC
+
+# TEMPVC__TEMPVC_CHANNEL_ID=null
+# TEMPVC__TEMPVC_CATEGORY_ID=null
+
+### GifLimiter
+
+# GIF_LIMITER__RECENT_GIF_AGE=60
+# GIF_LIMITER__GIF_LIMITS_USER={}
+# GIF_LIMITER__GIF_LIMITS_CHANNEL={}
+# GIF_LIMITER__GIF_LIMIT_EXCLUDE=[]
+
+### XP
+
+# XP_CONFIG__XP_BLACKLIST_CHANNELS=[]
+# XP_CONFIG__XP_ROLES=[]
+# XP_CONFIG__XP_MULTIPLIERS=[]
+# XP_CONFIG__XP_COOLDOWN=1
+# XP_CONFIG__LEVELS_EXPONENT=2
+# XP_CONFIG__SHOW_XP_PROGRESS=true
+# XP_CONFIG__ENABLE_XP_CAP=false
+
+### Snippets
+
+# SNIPPETS__LIMIT_TO_ROLE_IDS=false
+# SNIPPETS__ACCESS_ROLE_IDS=[]
+
+### IRC
+
+# IRC_CONFIG__BRIDGE_WEBHOOK_IDS=[]
+
+### ExternalServices
+
+# EXTERNAL_SERVICES__SENTRY_DSN=""
+# EXTERNAL_SERVICES__GITHUB_APP_ID=""
+# EXTERNAL_SERVICES__GITHUB_INSTALLATION_ID=""
+# EXTERNAL_SERVICES__GITHUB_PRIVATE_KEY=""
+# EXTERNAL_SERVICES__GITHUB_CLIENT_ID=""
+# EXTERNAL_SERVICES__GITHUB_CLIENT_SECRET=""
+# EXTERNAL_SERVICES__GITHUB_REPO_URL=""
+# EXTERNAL_SERVICES__GITHUB_REPO_OWNER=""
+# EXTERNAL_SERVICES__GITHUB_REPO=""
+# EXTERNAL_SERVICES__MAILCOW_API_KEY=""
+# EXTERNAL_SERVICES__MAILCOW_API_URL=""
+# EXTERNAL_SERVICES__WOLFRAM_APP_ID=""
+# EXTERNAL_SERVICES__INFLUXDB_TOKEN=""
+# EXTERNAL_SERVICES__INFLUXDB_URL=""
+# EXTERNAL_SERVICES__INFLUXDB_ORG=""

.gitattributes

@@ -30,9 +30,8 @@
 #
 # Docker Files
 #
-Dockerfile text eol=lf
-*.dockerfile text eol=lf
-docker-compose*.yml text eol=lf
+Containerfile text eol=lf
+compose.yaml text eol=lf
 .dockerignore text eol=lf
 
 #
@@ -70,10 +69,10 @@ docker-compose*.yml text eol=lf
 #
 # Lock Files (binary-like treatment)
 #
-poetry.lock text eol=lf linguist-generated=true
 package-lock.json text eol=lf linguist-generated=true
 yarn.lock text eol=lf linguist-generated=true
 Pipfile.lock text eol=lf linguist-generated=true
+uv.lock text eol=lf linguist-generated=true
 
 #
 # Binary Files
@@ -87,6 +86,7 @@ Pipfile.lock text eol=lf linguist-generated=true
 *.svg binary
 *.bmp binary
 *.tiff binary
+*.avif binary
 
 #
 # Media Files

.github/CONTRIBUTING.md

@@ -13,15 +13,15 @@ Before you start, ensure you have:
 * [Python](https://www.python.org/) (3.13+ recommended)
   * If you don't have Python installed, we suggest using something like [mise](https://mise.jdx.dev/) or [pyenv](https://github.com/pyenv/pyenv) to manage your Python installations.
 
-* [Poetry](https://python-poetry.org/docs/) (1.2+ recommended)
-  * If you don't have Poetry installed, you can use one of the official methods. We recommend using the official installer:
+* [Uv](https://docs.astral.sh/uv/) (recommended)
+  * If you don't have Uv installed, use the official installer and verify:
 
     ```bash
-    # Linux, macOS, Windows (WSL)
-    curl -sSL https://install.python-poetry.org | python3 -
+    # Linux/macOS
+    curl -LsSf https://astral.sh/uv/install.sh | sh
 
-    # After installation and ensuring Poetry is in your PATH, you can verify it by running:
-    poetry --version
+    # Verify installation
+    uv --version
     ```
 
 * A PostgreSQL Database (local or remote)
@@ -61,19 +61,19 @@ Follow these steps to set up your local development environment. For more compre
     git remote -v
     ```
 
-2. **Install Dependencies with Poetry**
+2. **Install Dependencies with Uv**
 
-    Ensure Poetry is installed and configured to use the correct Python version (e.g., 3.13.5).
+    Ensure Uv is installed and using the correct Python version (project requires 3.13.x).
 
     ```bash
-    # Create a virtual environment
-    poetry env use 3.13.5
+    # (Optional) Pin the Python version used by uv
+    uv python pin 3.13.5
 
-    # Install project dependencies and dev tools
-    poetry install
+    # Create the virtual environment and install all dependencies
+    uv sync
 
     # Install pre-commit hooks for quality checks
-    poetry run pre-commit install
+    uv run pre-commit install
     ```
 
 3. **Configure Environment Variables**
@@ -94,19 +94,19 @@ Follow these steps to set up your local development environment. For more compre
 
     Copy the example settings file.
 
-    `cp config/settings.yml.example config/settings.yml`
+    `cp .env.example .env`
 
-    Review `config/settings.yml` and customize it.
+    Review `.env` and customize it.
 
     **Crucially, add your Discord User ID to the `BOT_OWNER` list.**
 
 5. **Initialize Development Database**
 
-    Push the Prisma schema to your development database. This also generates the Prisma client.
+    Run database migrations to set up your development database.
 
     ```bash
     # Use --dev or rely on the default development mode
-    poetry run tux --dev db push
+    uv run tux --dev db upgrade
     ```
 
 ## Development Workflow
@@ -164,16 +164,16 @@ Follow these steps to set up your local development environment. For more compre
 
     ```bash
     # Format code using Ruff
-    poetry run tux dev format
+    uv run tux dev format
 
     # Lint code using Ruff
-    poetry run tux dev lint-fix
+    uv run tux dev lint-fix
 
-    # Type-check code using basedpyright
-    poetry run tux dev type-check
+    # Type-check code using Pyright
+    uv run tux dev type-check
 
     # Run all pre-commit checks (includes formatting, linting, etc.)
-    poetry run tux dev pre-commit
+    uv run tux dev pre-commit
     ```
 
     Fix any issues reported by these tools.