feat: add development linting notebook and documentation for ruff checks

Author: arinadi-rohmad

README.md

@@ -180,4 +180,17 @@ python start.py
 
 ---
 
+## 🛠️ Development
+
+### Lint (Colab)
+
+```python
+!git clone https://github.com/arinadi/HeadlineBot.git
+%cd HeadlineBot
+!pip install ruff -q
+!ruff check . --output-format=concise
+```
+
+---
+
 **HeadlineBot** — *Your story is breaking. Your AI is ready.* 📰⚡

dev_lint.ipynb

@@ -0,0 +1,37 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# 🛠️ HeadlineBot — Lint\n",
+    "Clone repo, install ruff, run lint."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!git clone https://github.com/arinadi/HeadlineBot.git\n",
+    "%cd HeadlineBot\n",
+    "!pip install ruff -q\n",
+    "!ruff check . --output-format=concise"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.10.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

pyproject.toml

@@ -0,0 +1,21 @@
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "B",    # flake8-bugbear
+    "UP",   # pyupgrade
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "B008",   # function call in default argument (FastAPI/Telegram style)
+    "UP007",  # use X | Y for union types
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["config", "model_manager", "utils", "bot_classes"]