Jeena
501a84e0a9
Update project metadata, docs, and systemd unit names to match the new service-update-alerts naming.
70 lines
1.5 KiB
Markdown
70 lines
1.5 KiB
Markdown
# service-update-alerts
|
|
|
|
Small Python script to compare running service versions against upstream releases.
|
|
|
|
## Requirements
|
|
|
|
- Python 3.10+
|
|
|
|
## Setup
|
|
|
|
Create and activate a virtual environment, then install dependencies:
|
|
|
|
```bash
|
|
python -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -e .[dev]
|
|
```
|
|
|
|
Copy `.env.sample` to `.env` and fill required values. Export the variables before running the script:
|
|
|
|
```bash
|
|
export PAPERLESS_API_TOKEN=...
|
|
export FRESHRSS_USERNAME=...
|
|
export FRESHRSS_PASSWORD=...
|
|
export MATRIX_HOMESERVER=...
|
|
export MATRIX_ROOM_ID=...
|
|
export MATRIX_ACCESS_TOKEN=...
|
|
export UPTIME_KUMA_PUSH_URL=...
|
|
```
|
|
|
|
The script also reads `.env` automatically if present.
|
|
|
|
The Matrix bot will attempt to join the configured room automatically if it is not already a member.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
python3 check_updates.py --config services.yaml
|
|
python3 check_updates.py --config services.yaml --all
|
|
```
|
|
|
|
## Tests
|
|
|
|
```bash
|
|
python -m pytest
|
|
```
|
|
|
|
To run live integration checks against the real services:
|
|
|
|
```bash
|
|
RUN_LIVE_TESTS=1 python -m pytest tests/test_live_services.py
|
|
```
|
|
|
|
## Systemd (user)
|
|
|
|
Copy the unit files and enable the timer:
|
|
|
|
```bash
|
|
mkdir -p ~/.config/systemd/user
|
|
cp systemd/service-update-alerts.service ~/.config/systemd/user/
|
|
cp systemd/service-update-alerts.timer ~/.config/systemd/user/
|
|
systemctl --user daemon-reload
|
|
systemctl --user enable --now service-update-alerts.timer
|
|
```
|
|
|
|
View logs:
|
|
|
|
```bash
|
|
journalctl --user -u service-update-alerts.service
|
|
```
|