Adding unified linting/formatting using Ruff (#54)

* Adding unified linting/formatting using Ruff.
* Continue on error for now until I run it on the entire codebase (to prevent merge conflicts in the recent PR).

Author: fosdickio

.github/workflows/lint-format.yml

@@ -0,0 +1,29 @@
+name: Ruff
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      
+      - name: Install Ruff
+        run: pip install ruff>=0.8.4
+      
+      - name: Run Ruff linter
+        run: ruff check .
+        continue-on-error: true
+      
+      - name: Run Ruff formatter check
+        run: ruff format --check .
+        continue-on-error: true

README.md

@@ -211,6 +211,43 @@ These are the list of HTTP endpoints that can be called:
     - `pairs`: compact string `old1:new1,old2:new2`
           Returns per-item results plus totals. Order is respected; later pairs can refer to earlier new names.
 
+## Development
+
+### Code Quality
+
+This project uses [Ruff](https://docs.astral.sh/ruff/) for linting and formatting. Configuration is in `ruff.toml`.
+
+#### Running Ruff Manually
+
+Check for issues:
+```bash
+ruff check .
+```
+
+Auto-fix issues:
+```bash
+ruff check --fix .
+```
+
+Check formatting issues:
+```bash
+ruff format --check .
+```
+
+Format code:
+```bash
+ruff format .
+```
+
+#### GitHub Actions
+
+A GitHub Action workflow (`.github/workflows/lint-format.yml`) automatically runs Ruff on:
+
+- Every push to the `main` branch
+- Every pull request targeting the `main` branch
+
+The workflow will fail if there are linting errors or formatting issues, ensuring code quality in CI.
+
 ## Contributing
 
 Contributions are welcome. Please feel free to submit a pull request.

ruff.toml

@@ -0,0 +1,19 @@
+target-version = "py312"
+line-length = 100
+
+[lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "UP",  # pyupgrade
+    "RUF", # Ruff-specific rules
+]
+
+[lint.isort]
+known-first-party = ["plugin", "bridge"]
+
+[lint.per-file-ignores]
+"__init__.py" = ["F401"]  # Allow unused imports in __init__.py files
+"scripts/*" = ["T201"]    # Allow print statements in scripts