v2.3.0

[rtuszik]

Changelog

2.3.0

This release adds experimental JSONL dump support, letting you combine multiple regions/countries into a
single index instead of relying on prebuilt databases. It also bumps Photon to 1.2.0, and adds additional Apprise notifications for
download, update, and error events.

⚠️ JSONL import does not support automatic updates. The default db mode is unchanged and retains all existing functionality. In jsonl mode the index is built once at startup and is not updated automatically.

Features

• Implement JSONL imports and add end-to-end tests by @rtuszik in Implement JSONL imports and add end-to-end tests #300, closes Feature: Add support for building Photon databases from JSONL dumps #122

Changes

• Update Photon version to 1.2.0 by @rtuszik in Update Photon version to 1.2.0 #330
• feat: multi-stage build without uv runtime dependency by @rtuszik in feat: multi-stage build without uv runtime dependency #317, closes [BUG] Cannot run container without access to internet connection #316
• refactor: split filesystem/updater into index and update modules by @rtuszik in refactor: split filesystem/updater into index and update modules #328

Fixes

• fix: reconcile partial JSONL index on startup instead of empty serve by @rtuszik in fix: reconcile partial JSONL index on startup instead of empty serve #326
• Verify the checksum and move the index into place before extraction by @rtuszik, fixes [BUG] Update / Install process fails #322
• Send notifications for download, update, and error events by @rtuszik, addresses [BUG] Apprise only notify "Initializing" #331

Dependencies & CI

• [Aikido] Fix security issue in urllib3 via minor version upgrade from 2.6.3 to 2.7.0 by @aikido-autofix[bot] in [Aikido] Fix security issue in urllib3 via minor version upgrade from 2.6.3 to 2.7.0 #320
• chore(deps): update dependency pytest to v9.0.3 [security] by @koalabot-rt[bot] in chore(deps): update dependency pytest to v9.0.3 [security] #329
• Update docker/login-action action to v4 by @rtuszik in Update docker/login-action action to v4 #297
• Update docker/setup-buildx-action action to v4 by @rtuszik in Update docker/setup-buildx-action action to v4 #312
• increase test coverage by @rtuszik in increase test coverage #319

⚠️ JSONL imports are still experimental and do not
support scheduled updates, UPDATE_STRATEGY, UPDATE_INTERVAL, FILE_URL, and
MD5_URL are ignored.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
src
downloader.py	244	19	92%	96–97, 221–222, 239, 249–260, 263–264, 308–309, 361
importer.py	54	2	96%	19, 30
index.py	97	1	99%	137
process_manager.py	243	13	95%	151–152, 203–204, 228, 255–256, 277–279, 336–338
update.py	131	2	98%	93, 172
src/jsonl
decompressor.py	5	3	40%	5–7
downloader.py	31	14	55%	14, 18, 23, 25, 32–46
src/utils
config.py	48	3	94%	62–64
regions.py	105	8	92%	407, 420, 428, 432, 435, 448, 459, 474
validate_config.py	40	4	90%	44, 46, 52–53
TOTAL	1226	69	94%

Tests	Skipped	Failures	Errors	Time
257	0 💤	0 ❌	0 🔥	1.757s ⏱️

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pytest@​9.0.2 ⏵ 9.0.3	+1	+2
	zstandard@​0.25.0

View full report

[coderabbitai]

Actionable comments posted: 7

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 105e83e8-4c25-4830-ae71-0e3d84ed872f

📥 Commits

Reviewing files that changed from the base of the PR and between c08b12a and 50fbd41.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock

📒 Files selected for processing (37)

• .github/workflows/build-and-push.yml
• .github/workflows/full-test-jsonl.yml
• .github/workflows/full-test.yml
• .github/workflows/lint.yml
• .last_release
• Dockerfile
• README.md
• pyproject.toml
• src/__init__.py
• src/check_remote.py
• src/downloader.py
• src/entrypoint.py
• src/filesystem.py
• src/importer.py
• src/index.py
• src/jsonl/__init__.py
• src/jsonl/decompressor.py
• src/jsonl/downloader.py
• src/process_manager.py
• src/update.py
• src/updater.py
• src/utils/config.py
• src/utils/regions.py
• src/utils/sanitize.py
• src/utils/validate_config.py
• tests/jsonl/test_jsonl_downloader.py
• tests/test_check_remote.py
• tests/test_downloader.py
• tests/test_entrypoint.py
• tests/test_importer.py
• tests/test_index.py
• tests/test_process_manager.py
• tests/test_update.py
• tests/utils/test_logger.py
• tests/utils/test_notify.py
• tests/utils/test_regions.py
• tests/utils/test_validate_config.py

💤 Files with no reviewable changes (3)

• src/updater.py
• src/filesystem.py
• src/init.py

✅ Files skipped from review due to trivial changes (2)

• .last_release
• src/utils/sanitize.py

🚧 Files skipped from review as they are similar to previous changes (21)

• .github/workflows/full-test.yml
• tests/jsonl/test_jsonl_downloader.py
• src/jsonl/init.py
• .github/workflows/build-and-push.yml
• src/jsonl/decompressor.py
• src/utils/validate_config.py
• tests/utils/test_regions.py
• pyproject.toml
• tests/utils/test_logger.py
• tests/utils/test_notify.py
• tests/test_index.py
• src/jsonl/downloader.py
• tests/test_entrypoint.py
• src/check_remote.py
• src/downloader.py
• src/utils/config.py
• src/index.py
• src/utils/regions.py
• tests/test_importer.py
• src/entrypoint.py
• src/process_manager.py