v0.1.0rc5

.editorconfig

@@ -34,7 +34,7 @@ indent_size = 2
 
 # Docker files
 [{Dockerfile,*.dockerfile}]
-indent_size = 4
+indent_size = 8
 
 [docker-compose*.yml]
 indent_size = 2
@@ -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
 

.gitattributes

@@ -70,10 +70,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

.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.

.github/actions/action-basedpyright/action.yml

@@ -0,0 +1,56 @@
+---
+name: action-basedpyright
+description: Run basedpyright with reviewdog on pull requests to improve code review
+  experience
+inputs:
+  github_token:
+    description: GITHUB_TOKEN
+    default: ${{ github.token }}
+  workdir:
+    description: Working directory relative to the root directory.
+    default: .
+  ### Flags for reviewdog  ###
+  tool_name:
+    description: Tool name to use for reviewdog reporter.
+    default: basedpyright
+  level:
+    description: Report level for reviewdog [info,warning,error].
+    default: warning
+  reporter:
+    description: Reporter of reviewdog command [github-check,github-pr-review,github-pr-check,sarif].
+    default: github-pr-review
+  filter_mode:
+    description: |
+      Filtering mode for the reviewdog command [added,diff_context,file,nofilter].
+      Default is `added` except that sarif reporter uses `nofilter`.
+    default: file
+  fail_level:
+    description: |
+      If set to `none`, always use exit code 0 for reviewdog. Otherwise, exit code 1 for reviewdog if it finds at least 1 issue with severity greater than or equal to the given level.
+      Possible values: [none,any,info,warning,error]
+      Default is `none`.
+    default: none
+  reviewdog_flags:
+    description: Additional reviewdog flags.
+    default: ''
+  ### Flags for basedpyright  ###
+  basedpyright_flags:
+    description: Additional flags for basedpyright command.
+    default: --outputjson
+runs:
+  using: composite
+  steps:
+    - name: Run basedpyright with reviewdog
+      shell: bash
+      working-directory: ${{ inputs.workdir }}
+      run: |
+        (uv run basedpyright ${{ inputs.basedpyright_flags }} || true) | \
+        reviewdog -f=rdjson \
+          -reporter=${{ inputs.reporter }} \
+          -level=${{ inputs.level }} \
+          -filter-mode=${{ inputs.filter_mode }} \
+          -fail-level=${{ inputs.fail_level }} \
+          -name=${{ inputs.tool_name }} \
+          ${{ inputs.reviewdog_flags }}
+      env:
+        REVIEWDOG_GITHUB_API_TOKEN: ${{ inputs.github_token }}

.github/actions/create-test-env/action.yml

@@ -1,10 +1,8 @@
+---
 name: Create Test Environment
-description: Create .env file with test configuration for CI/testing purposes
+description: Create .env file with test configuration for CI/testing purposes using
+  pydantic settings
 inputs:
-  database-url:
-    description: Database URL for testing
-    required: false
-    default: sqlite:///tmp/test.db
   bot-token:
     description: Bot token for testing
     required: false
@@ -17,20 +15,33 @@ runs:
   using: composite
   steps:
     # TEST ENVIRONMENT CONFIGURATION
-    # Creates isolated test environment with safe defaults
+    # Creates isolated test environment with safe defaults for pydantic settings
     - name: Create test environment file
       shell: bash
       run: |-
-        # Create .env file for CI/testing with required values
+        # Create .env file for CI/testing with pydantic settings format
         cat > .env << EOF
-        DEV_DATABASE_URL=${{ inputs.database-url }}
-        PROD_DATABASE_URL=${{ inputs.database-url }}
-        DEV_BOT_TOKEN=${{ inputs.bot-token }}
-        PROD_BOT_TOKEN=${{ inputs.bot-token }}
+        # Core configuration
+        DEBUG=True
+
+        # Bot token
+        BOT_TOKEN=${{ inputs.bot-token }}
+
+        # Database configuration (tests use py-pglite, so these are just defaults)
+        POSTGRES_HOST=localhost
+        POSTGRES_PORT=5432
+        POSTGRES_DB=tuxdb_test
+        POSTGRES_USER=tuxuser_test
+        POSTGRES_PASSWORD=tuxpass_test
+
+        # Bot info defaults
+        BOT_INFO__BOT_NAME=Tux Test
+        BOT_INFO__BOT_VERSION=0.0.0-test
+        BOT_INFO__PREFIX=$
         EOF
 
         # Add any additional environment variables if provided
         if [ -n "${{ inputs.additional-vars }}" ]; then
           echo "${{ inputs.additional-vars }}" >> .env
         fi
-        echo "✅ Test environment file created"
+        echo "✅ Test environment file created with pydantic settings format"

.github/actions/setup-python/action.yml

@@ -1,66 +1,38 @@
+---
 name: Setup Python Environment
-description: Set up Python with Poetry, dependencies, and optional Prisma client generation
+description: Set up Python with Uv and dependencies
 inputs:
   python-version:
     description: Python version to use
     required: false
     default: '3.13'
-  install-groups:
-    description: Poetry groups to install (comma-separated)
+  uv-version:
+    description: Uv version to install (e.g. 0.8.8)
     required: false
-    default: dev,types
-  cache-suffix:
-    description: Cache key suffix for differentiation
-    required: false
-    default: default
-  generate-prisma:
-    description: Whether to generate Prisma client
+    default: 0.8.8
+  enable-cache:
+    description: Enable uv cache persistence
     required: false
     default: 'true'
 runs:
   using: composite
   steps:
-    # POETRY INSTALLATION
-    # Uses pipx for isolated Poetry installation without conflicts
-    - name: Install Poetry
-      shell: bash
-      run: pipx install poetry
-
-    # PYTHON ENVIRONMENT SETUP
-    # Configures Python with integrated Poetry cache support
+    # PYTHON ENVIRONMENT SETUP (use GitHub's cached Python)
     - name: Set up Python
-      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ inputs.python-version }}
-        cache: poetry
 
-    # ADVANCED DEPENDENCY CACHING
-    # Multi-level caching strategy for maximum cache hit rate
-    - name: Cache Poetry dependencies
-      uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4
+    # UV INSTALLATION
+    # Installs uv and optionally enables cache persistence
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
       with:
-        path: |
-          ~/.cache/pypoetry
-          ~/.cache/pip
-        key: poetry-${{ inputs.cache-suffix }}-${{ runner.os }}-${{ hashFiles('poetry.lock')
-          }}
-        restore-keys: |
-          poetry-${{ inputs.cache-suffix }}-${{ runner.os }}-
+        version: ${{ inputs.uv-version }}
+        enable-cache: ${{ inputs.enable-cache }}
 
     # DEPENDENCY INSTALLATION
-    # Installs specified Poetry groups with CI-optimized settings
+    # Install project with locked dependencies
     - name: Install dependencies
       shell: bash
-      run: |
-        if [[ "${{ inputs.install-groups }}" == "main" ]]; then
-          poetry install --only=main --no-interaction --no-ansi
-        else
-          poetry install --with=${{ inputs.install-groups }} --no-interaction --no-ansi
-        fi
-
-    # CONDITIONAL PRISMA CLIENT GENERATION
-    # Generates Prisma database client when needed for database operations
-    - name: Generate Prisma client
-      if: ${{ inputs.generate-prisma == 'true' }}
-      shell: bash
-      run: poetry run prisma generate
+      run: uv sync --frozen