From 5c2069af4246816c41bc999e150850e72981e3fe Mon Sep 17 00:00:00 2001
From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>
Date: Sun, 15 Feb 2026 18:34:39 -0500
Subject: [PATCH] chore(build): add pyproject.toml and externalize version

Introduce pyproject.toml for modern packaging and test configuration, moving dependencies and dev extras into the project metadata. Replace requirements.txt and requirements-dev.txt with editable installs (CI updated to pip install -e ".[dev]", README install instructions added). Externalize the package version into src/common/version.py and update src/common/common.py to use __version__; Dockerfile now writes the version file and installs the package (pip install .) instead of editing source or using requirements files. Overall cleanup to support setuptools/pyproject-based builds and simplified dependency management.
---
 .github/workflows/ci.yml | 14 +-----
 Dockerfile               | 10 +++--
 README.md                | 14 ++++++
 pyproject.toml           | 97 ++++++++++++++++++++++++++++++++++++++++
 requirements-dev.txt     |  6 ---
 requirements.txt         | 11 -----
 src/common/common.py     |  5 ++-
 src/common/version.py    |  3 ++
 8 files changed, 127 insertions(+), 33 deletions(-)
 create mode 100644 pyproject.toml
 delete mode 100644 requirements-dev.txt
 delete mode 100644 requirements.txt
 create mode 100644 src/common/version.py

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 513d046..a1cdaed 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -55,8 +55,7 @@ jobs:
       - name: Install Python Dependencies
         run: |
           python -m pip install --upgrade pip setuptools wheel
-          python -m pip install --upgrade -r requirements.txt
-          python -m pip install --upgrade -r requirements-dev.txt
+          python -m pip install -e ".[dev]"
 
       - name: Test with pytest
         id: test
@@ -76,16 +75,7 @@ jobs:
           REDDIT_USERNAME: ${{ vars.REDDIT_USERNAME }}
           REDDIT_PASSWORD: ${{ secrets.REDDIT_PASSWORD }}
         shell: bash
-        run: |
-          python -m pytest \
-            -rxXs \
-            --tb=native \
-            --verbose \
-            --color=yes \
-            --cov=src \
-            --junitxml=junit.xml \
-            -o junit_family=legacy \
-            tests
+        run: python -m pytest tests
 
       - name: Upload test coverage
         # any except canceled or skipped
diff --git a/Dockerfile b/Dockerfile
index b579e9d..e339529 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -34,11 +34,15 @@ RUN <<_SETUP
 #!/bin/bash
 set -e
 
-# replace the version in the code
-sed -i "s/version = '0.0.0'/version = '${BUILD_VERSION}'/g" src/common/common.py
+# write the version to the version file
+cat > src/common/version.py <<EOF
+"""Version information for support-bot."""
+
+__version__ = "${BUILD_VERSION}"
+EOF
 
 # install dependencies
-python -m pip install --no-cache-dir -r requirements.txt
+python -m pip install --no-cache-dir .
 _SETUP
 
 CMD ["python", "-m", "src"]
diff --git a/README.md b/README.md
index 5d9cf48..f67632e 100644
--- a/README.md
+++ b/README.md
@@ -70,6 +70,20 @@ platforms such as GitHub discussions/issues might be added in the future.
 | SUPPORT_COMMANDS_REPO            | False    | `https://github.com/LizardByte/support-bot-commands` | Repository for support commands.                                                           |
 | SUPPORT_COMMANDS_BRANCH          | False    | `master`                                             | Branch for support commands.                                                               |
 
+### Install
+
+Install the project and its dependencies:
+
+```bash
+python -m pip install -e .
+```
+
+For development (includes test dependencies):
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
 ### Start
 
 ```bash
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..d13132a
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,97 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "support-bot"
+dynamic = ["version"]
+description = "Support bot written in python to help manage LizardByte communities"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "AGPL-3.0-only"}
+authors = [
+    {name = "LizardByte", email = "lizardbyte@users.noreply.github.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "cryptography==46.0.5",
+    "Flask==3.1.2",
+    "GitPython==3.1.46",
+    "libgravatar==1.0.4",
+    "mistletoe==1.5.1",
+    "praw==7.8.1",
+    "py-cord==2.6.1",
+    "python-dotenv==1.2.1",
+    "requests==2.32.5",
+    "requests-oauthlib==2.0.0",
+    "tinydb==4.8.2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "betamax==0.9.0",
+    "betamax-serializers==0.2.1",
+    "pytest==9.0.2",
+    "pytest-asyncio==1.3.0",
+    "pytest-cov==7.0.0",
+    "pytest-mock==3.15.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/LizardByte/support-bot"
+Repository = "https://github.com/LizardByte/support-bot"
+Issues = "https://github.com/LizardByte/support-bot/issues"
+
+[tool.setuptools]
+packages = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "src.common.version.__version__"}
+
+[tool.setuptools.package-data]
+"*" = ["*.md", "*.txt"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "-rxXs",
+    "--tb=native",
+    "--verbose",
+    "--color=yes",
+    "--cov=src",
+    "--cov-report=term-missing",
+    "--junitxml=junit.xml",
+    "-o", "junit_family=legacy",
+]
+markers = [
+    "unit: Unit tests",
+    "integration: Integration tests",
+]
+
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "*/tests/*",
+    "*/__pycache__/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]
diff --git a/requirements-dev.txt b/requirements-dev.txt
deleted file mode 100644
index 8d6a828..0000000
--- a/requirements-dev.txt
+++ /dev/null
@@ -1,6 +0,0 @@
-betamax==0.9.0
-betamax-serializers==0.2.1
-pytest==9.0.2
-pytest-asyncio==1.3.0
-pytest-cov==7.0.0
-pytest-mock==3.15.1
diff --git a/requirements.txt b/requirements.txt
deleted file mode 100644
index cf0c516..0000000
--- a/requirements.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-cryptography==46.0.5
-Flask==3.1.2
-GitPython==3.1.46
-libgravatar==1.0.4
-mistletoe==1.5.1
-praw==7.8.1
-py-cord==2.6.1
-python-dotenv==1.2.1
-requests==2.32.5
-requests-oauthlib==2.0.0
-tinydb==4.8.2
diff --git a/src/common/common.py b/src/common/common.py
index 7997a13..a4f7724 100644
--- a/src/common/common.py
+++ b/src/common/common.py
@@ -6,6 +6,9 @@
 from libgravatar import Gravatar
 import requests
 
+# local imports
+from src.common.version import __version__
+
 
 colors = {
     'black': 0x000000,
@@ -66,4 +69,4 @@ def get_app_dirs():
 bot_name = f'{org_name}-Bot'
 bot_url = 'https://app.lizardbyte.dev'
 app_dir, data_dir = get_app_dirs()
-version = '0.0.0'
+version = __version__
diff --git a/src/common/version.py b/src/common/version.py
new file mode 100644
index 0000000..318cc56
--- /dev/null
+++ b/src/common/version.py
@@ -0,0 +1,3 @@
+"""Version information for support-bot."""
+
+__version__ = "0.0.0"