Chore: Ruff linting updated and fixed errors.

Chore: Moved from poetry to uv
This commit is contained in:
2026-02-22 04:23:14 +00:00
parent 2b844bc44b
commit 34e30efcaf
36 changed files with 2174 additions and 4057 deletions

120
README.md
View File

@ -4,22 +4,12 @@ This project uses **pyenv** for Python version management and **Poetry** for dep
---
## 1. Install pyenv
## 1. Install uv
### 1.1 Install pyenv (if not already installed)
```bash
curl -fsSL https://pyenv.run | bash
```
### 1.2 Configure shell for pyenv
Add the following to `~/.zshrc`:
### 1.1 Install uv (if not already installed)
```zsh
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc
curl -LsSf https://astral.sh/uv/install.sh | sh
```
Reload the shell:
@ -31,28 +21,18 @@ exec "$SHELL"
Verify:
```zsh
pyenv --version
uv --version
```
### 1.3 Install system dependencies
## 2. Install Python 3.14 using uv
```zsh
sudo apt update; sudo apt install make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl git \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
````
---
## 2. Install Python 3.14 using pyenv
```zsh
pyenv install 3.14
uv python install 3.14
```
Set the local Python version for this project:
```zsh
pyenv local 3.14
uv python pin 3.14
```
Verify:
@ -63,97 +43,51 @@ python --version
---
## 3. Install Poetry
## 3. Install project dependencies
### 3.1 Install Poetry (if not already installed)
### 3.1 Install dependencies
```zsh
curl -sSL https://install.python-poetry.org | python3 -
```
Ensure Poetry is on PATH:
```zsh
export PATH="$HOME/.local/bin:$PATH"
```
Enable tab completion for Zsh
```zsh
mkdir $ZSH_CUSTOM/plugins/poetry
poetry completions zsh > $ZSH_CUSTOM/plugins/poetry/_poetry
```
You must then add poetry to your plugins array in ~/.zshrc:
```zsh
plugins(
poetry
...
)
```
Verify:
```zsh
poetry --version
```
---
## 4. Configure Poetry to use pyenvs Python
From the project root directory:
```zsh
poetry env use "$(pyenv which python)"
```
Verify the environment:
```zsh
poetry env info
```
---
## 5. Install the project
### 5.1 Install dependencies
```zsh
poetry install
uv sync
```
This will:
* Create a virtual environment
* Create a local `.venv`
* Install all dependencies defined in `pyproject.toml`
* Use Python **3.14** from pyenv
* Generate/update `uv.lock`
* Use Python **3.14**
---
## 6. Activate the environment (optional)
## 4. Activate the environment (optional)
```zsh
eval $(poetry env activate)
source .venv/bin/activate
```
Deactivate:
```zsh
deactivate
```
Or run commands directly:
```zsh
poetry run python your_script.py
uv run python your_script.py
```
---
## 7. Install nvm
## 5. Install nvm
### 7.1 Install nvm (if not already installed)
### 5.1 Install nvm (if not already installed)
```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
```
### 7.2 Configure shell for pyenv
### 5.2 Configure shell for pyenv
Add the following to `~/.zshrc`:
@ -179,7 +113,7 @@ nvm --version
## Notes
* Do **not** use system-wide pip for this project.
* All dependencies (including `psycopg`) are managed by Poetry.
* Do **not** install dependencies manually.
* Always use `uv sync` to install or update dependencies.
* Commit both: `pyproject.toml` and `uv.lock`
* PostgreSQL must be running and properly configured before application startup.
```