Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
211dd1af1d |
+3
-2
@@ -40,7 +40,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
## [0.1.0] - 2026-09-08
|
## [0.1.0] - 2026-09-08
|
||||||
|
|
||||||
Initial release covering milestones M1 through M15, except the optional Gitea Actions workflow.
|
Initial release covering milestones M1 through M15.
|
||||||
|
|
||||||
### Added
|
### Added
|
||||||
- **M1 (Scaffolding)**: Python project structure with `pyproject.toml`, and tooling configuration for `ruff`, `mypy`, `bandit`, and `pre-commit`.
|
- **M1 (Scaffolding)**: Python project structure with `pyproject.toml`, and tooling configuration for `ruff`, `mypy`, `bandit`, and `pre-commit`.
|
||||||
@@ -57,4 +57,5 @@ Initial release covering milestones M1 through M15, except the optional Gitea Ac
|
|||||||
- **M12 (CLI entry point)**: `pronote-sync` command with `--dry-run` and `--log-level` options, redacted error display, and safe traceback in DEBUG mode.
|
- **M12 (CLI entry point)**: `pronote-sync` command with `--dry-run` and `--log-level` options, redacted error display, and safe traceback in DEBUG mode.
|
||||||
- **M13 (Tests & coverage)**: 636 tests with 95.67% coverage, test fixtures (`pronote-4e.ics`, `pronote-6e.ics`), shared `conftest.py`, and secret non-leak tests.
|
- **M13 (Tests & coverage)**: 636 tests with 95.67% coverage, test fixtures (`pronote-4e.ics`, `pronote-6e.ics`), shared `conftest.py`, and secret non-leak tests.
|
||||||
- **M14 (Deployment)**: systemd service and timer (daily at 18:00), logrotate configuration (daily, rotate 7, compress), `check_secrets.py` pre-deployment scanner, and exploitation guide.
|
- **M14 (Deployment)**: systemd service and timer (daily at 18:00), logrotate configuration (daily, rotate 7, compress), `check_secrets.py` pre-deployment scanner, and exploitation guide.
|
||||||
- **M15 (Documentation)**: README, README.LLM.md (AI agent setup guide), MIT LICENSE, CHANGELOG, and local validation procedures. Gitea Actions CI/CD remains optional and is not delivered in this release.
|
- **M15 (Documentation)**: README, README.LLM.md (AI agent setup guide), MIT LICENSE, CHANGELOG, and Gitea Actions CI/CD reference for LXC/VPS (Debian/CentOS).
|
||||||
|
- **Other**: MIT License. Gitea Actions CI/CD reference for LXC/VPS (Debian/CentOS) is planned and optional, not delivered in this release.
|
||||||
|
|||||||
@@ -12,7 +12,7 @@ Synchronise l'agenda et les devoirs de **Pronote** vers un calendrier **CalDAV**
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Cloner le dépôt
|
# Cloner le dépôt
|
||||||
git clone https://git.antoineve.me/AntoineVe/college-infos
|
git clone <repo-url>
|
||||||
cd pronote-sync
|
cd pronote-sync
|
||||||
|
|
||||||
# Créer l'environnement virtuel
|
# Créer l'environnement virtuel
|
||||||
@@ -48,23 +48,6 @@ pas garantir un état persistant cohérent pendant une simulation.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Validation et CI
|
|
||||||
|
|
||||||
Aucun workflow Gitea Actions n'est livré actuellement. Les validations du projet sont donc
|
|
||||||
exécutées localement avec les commandes suivantes :
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pytest
|
|
||||||
ruff check .
|
|
||||||
mypy .
|
|
||||||
bandit -r pronote_sync/
|
|
||||||
```
|
|
||||||
|
|
||||||
`pre-commit run --all-files` regroupe également les contrôles de formatage, typage, sécurité et
|
|
||||||
détection de secrets.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🛠️ Déploiement
|
## 🛠️ Déploiement
|
||||||
|
|
||||||
Les artefacts pour **systemd/timer** et **logrotate** sont fournis dans `deploy/`. Voir [docs/exploitation.md](docs/exploitation.md) pour plus de détails.
|
Les artefacts pour **systemd/timer** et **logrotate** sont fournis dans `deploy/`. Voir [docs/exploitation.md](docs/exploitation.md) pour plus de détails.
|
||||||
|
|||||||
@@ -308,5 +308,5 @@ Rédiger la documentation utilisateur et finaliser le projet.
|
|||||||
|
|
||||||
### Critères d'acceptation
|
### Critères d'acceptation
|
||||||
- `README.md` permet d'installer et de lancer le projet sans le guide.
|
- `README.md` permet d'installer et de lancer le projet sans le guide.
|
||||||
- Les procédures locales de test, lint et sécurité sont documentées et exécutables.
|
- Gitea Actions exécute tests + lint + sécurité.
|
||||||
- Aucun secret dans la documentation.
|
- Aucun secret dans la documentation.
|
||||||
|
|||||||
@@ -97,10 +97,7 @@ class BlogRSSState:
|
|||||||
redact_exception(exc),
|
redact_exception(exc),
|
||||||
)
|
)
|
||||||
|
|
||||||
def _save(
|
def _save(self) -> None:
|
||||||
self,
|
|
||||||
state: tuple[set[str], str | None, str | None] | None = None,
|
|
||||||
) -> bool:
|
|
||||||
"""Sauvegarde l'état dans le fichier JSON de manière atomique.
|
"""Sauvegarde l'état dans le fichier JSON de manière atomique.
|
||||||
|
|
||||||
La sortie est déterministe : ``known_guids`` est trié
|
La sortie est déterministe : ``known_guids`` est trié
|
||||||
@@ -110,30 +107,20 @@ class BlogRSSState:
|
|||||||
jamais laisser un fichier partiel en cas d'interruption. En cas
|
jamais laisser un fichier partiel en cas d'interruption. En cas
|
||||||
d'erreur d'écriture, une erreur est journalisée sans être
|
d'erreur d'écriture, une erreur est journalisée sans être
|
||||||
propagée et le fichier temporaire est supprimé.
|
propagée et le fichier temporaire est supprimé.
|
||||||
|
|
||||||
:param state: État à sauvegarder ; l'état courant est utilisé par défaut.
|
|
||||||
:return: ``True`` si l'état a été sauvegardé ou si la persistance est désactivée.
|
|
||||||
:rtype: bool
|
|
||||||
"""
|
"""
|
||||||
if not self._persistence_enabled:
|
if not self._persistence_enabled:
|
||||||
return True
|
return
|
||||||
known_guids, etag, last_modified = state or (
|
|
||||||
self._known_guids,
|
|
||||||
self._etag,
|
|
||||||
self._last_modified,
|
|
||||||
)
|
|
||||||
payload = {
|
payload = {
|
||||||
"version": _STATE_VERSION,
|
"version": _STATE_VERSION,
|
||||||
"known_guids": sorted(known_guids),
|
"known_guids": sorted(self._known_guids),
|
||||||
"etag": etag,
|
"etag": self._etag,
|
||||||
"last_modified": last_modified,
|
"last_modified": self._last_modified,
|
||||||
}
|
}
|
||||||
tmp_file = self._state_file.with_suffix(".tmp")
|
tmp_file = self._state_file.with_suffix(".tmp")
|
||||||
try:
|
try:
|
||||||
with open(tmp_file, "w", encoding="utf-8") as handle:
|
with open(tmp_file, "w", encoding="utf-8") as handle:
|
||||||
json.dump(payload, handle, indent=2)
|
json.dump(payload, handle, indent=2)
|
||||||
tmp_file.replace(self._state_file)
|
tmp_file.replace(self._state_file)
|
||||||
return True
|
|
||||||
except Exception as exc:
|
except Exception as exc:
|
||||||
logger.error(
|
logger.error(
|
||||||
"Impossible d'écrire le fichier d'état blog RSS %s : %s.",
|
"Impossible d'écrire le fichier d'état blog RSS %s : %s.",
|
||||||
@@ -147,7 +134,6 @@ class BlogRSSState:
|
|||||||
"Nettoyage du fichier temporaire échoué : %s",
|
"Nettoyage du fichier temporaire échoué : %s",
|
||||||
redact_exception(cleanup_exc),
|
redact_exception(cleanup_exc),
|
||||||
)
|
)
|
||||||
return False
|
|
||||||
|
|
||||||
def get_known_guids(self) -> frozenset[str]:
|
def get_known_guids(self) -> frozenset[str]:
|
||||||
"""Renvoie une copie immuable des GUID d'articles déjà connus.
|
"""Renvoie une copie immuable des GUID d'articles déjà connus.
|
||||||
@@ -182,13 +168,10 @@ class BlogRSSState:
|
|||||||
"""
|
"""
|
||||||
if result.not_modified:
|
if result.not_modified:
|
||||||
return
|
return
|
||||||
new_state = (
|
self._known_guids.update(article.id for article in result.articles)
|
||||||
self._known_guids | {article.id for article in result.articles},
|
self._etag = result.etag
|
||||||
result.etag,
|
self._last_modified = result.last_modified
|
||||||
result.last_modified,
|
self._save()
|
||||||
)
|
|
||||||
if self._save(new_state):
|
|
||||||
self._known_guids, self._etag, self._last_modified = new_state
|
|
||||||
|
|
||||||
def get_cache_headers(self) -> tuple[str | None, str | None]:
|
def get_cache_headers(self) -> tuple[str | None, str | None]:
|
||||||
"""Renvoie les en-têtes de cache HTTP mémorisés.
|
"""Renvoie les en-têtes de cache HTTP mémorisés.
|
||||||
|
|||||||
+5
-6
@@ -7,10 +7,9 @@ name = "pronote-sync"
|
|||||||
version = "0.1.2"
|
version = "0.1.2"
|
||||||
description = "Synchronisation Pronote → CalDAV + XMPP"
|
description = "Synchronisation Pronote → CalDAV + XMPP"
|
||||||
license = {text = "MIT"}
|
license = {text = "MIT"}
|
||||||
readme = "README.md"
|
|
||||||
requires-python = ">=3.13.5"
|
requires-python = ">=3.13.5"
|
||||||
authors = [
|
authors = [
|
||||||
{name = "Antoine Van Elstraete", email = "antoine@van-elstraete.net"}
|
{name = "Votre Nom", email = "votre@email.com"}
|
||||||
]
|
]
|
||||||
keywords = ["pronote", "caldav", "xmpp", "sync", "school"]
|
keywords = ["pronote", "caldav", "xmpp", "sync", "school"]
|
||||||
classifiers = [
|
classifiers = [
|
||||||
@@ -58,10 +57,10 @@ dev = [
|
|||||||
pronote-sync = "pronote_sync.cli.main:main"
|
pronote-sync = "pronote_sync.cli.main:main"
|
||||||
|
|
||||||
[project.urls]
|
[project.urls]
|
||||||
Homepage = "https://git.antoineve.me/AntoineVe/college-infos"
|
Homepage = "https://github.com/votre-utilisateur/pronote-sync"
|
||||||
Documentation = "https://git.antoineve.me/AntoineVe/college-infos/wiki"
|
Documentation = "https://github.com/votre-utilisateur/pronote-sync#readme"
|
||||||
Repository = "https://git.antoineve.me/AntoineVe/college-infos"
|
Repository = "https://github.com/votre-utilisateur/pronote-sync"
|
||||||
Issues = "https://git.antoineve.me/AntoineVe/college-infos/issues"
|
Issues = "https://github.com/votre-utilisateur/pronote-sync/issues"
|
||||||
|
|
||||||
[tool.setuptools.packages.find]
|
[tool.setuptools.packages.find]
|
||||||
where = ["."]
|
where = ["."]
|
||||||
|
|||||||
@@ -425,41 +425,4 @@ def test_atomic_save_preserves_on_error(tmp_path: Path) -> None:
|
|||||||
assert state.get_known_guids() == frozenset({"original-guid-1", "original-guid-2", "new-guid"})
|
assert state.get_known_guids() == frozenset({"original-guid-1", "original-guid-2", "new-guid"})
|
||||||
|
|
||||||
|
|
||||||
def test_acknowledge_does_not_advance_memory_when_save_fails(
|
|
||||||
tmp_path: Path,
|
|
||||||
) -> None:
|
|
||||||
"""Conserve l'état précédent en mémoire si l'acquittement ne peut pas être sauvegardé.
|
|
||||||
|
|
||||||
:param tmp_path: Fixture pytest pour un répertoire temporaire.
|
|
||||||
:return: None
|
|
||||||
"""
|
|
||||||
state_file = tmp_path / "state.json"
|
|
||||||
state = BlogRSSState(state_file)
|
|
||||||
state.add_guids(["existing-guid"])
|
|
||||||
state.update_cache_headers("old-etag", "old-last-modified")
|
|
||||||
article = BlogArticle(
|
|
||||||
id="new-guid",
|
|
||||||
title="Article",
|
|
||||||
url="https://example.com/article",
|
|
||||||
published_at=datetime(2026, 9, 12, 8, 0, tzinfo=UTC),
|
|
||||||
updated_at=None,
|
|
||||||
category=None,
|
|
||||||
author=None,
|
|
||||||
content_html="<p>Contenu</p>",
|
|
||||||
content_text="Contenu",
|
|
||||||
)
|
|
||||||
|
|
||||||
with patch.object(Path, "replace", side_effect=OSError("replace failed")):
|
|
||||||
state.acknowledge(
|
|
||||||
BlogRSSFetchResult(
|
|
||||||
articles=(article,),
|
|
||||||
etag="new-etag",
|
|
||||||
last_modified="new-last-modified",
|
|
||||||
)
|
|
||||||
)
|
|
||||||
|
|
||||||
assert state.get_known_guids() == frozenset({"existing-guid"})
|
|
||||||
assert state.get_cache_headers() == ("old-etag", "old-last-modified")
|
|
||||||
|
|
||||||
|
|
||||||
# Ensure trailing newline
|
# Ensure trailing newline
|
||||||
|
|||||||
Reference in New Issue
Block a user