943acbc573
Durcit la convention de nommage des projets (dérive constatée : 'Sliding Automation', 'code_versioning'... au lieu des formes canoniques). - trilium_api.py : projets_canoniques() lit le référentiel = valeurs du label projet sur les notes de type=projet (source unique, pas de constante en dur). Note-projet CodeVersioning créée (manquait). - mcp_server.py : _valider_projet() branché dans les 6 tools de création (add_decision/history/backlog, new_conversation, create_entite, add_skill). Refuse un projet non canonique (suggestion si faute) ou inconnu (renvoi au processus de création de projet). Ne verrouille pas si référentiel illisible. - lint_audit.py : VAL-nommage aligné sur le référentiel (attrape casse, espace ET snake_case ; l'ancien 'contient un espace' ratait code_versioning). - Données : 79 notes ré-étiquetées vers les 3 formes canoniques. Quality by design : l'erreur de nommage devient impossible à l'écriture, le Lint n'est plus que le filet de sécurité.
75 lines
2.0 KiB
Python
75 lines
2.0 KiB
Python
from __future__ import annotations
|
|
|
|
import http
|
|
import logging
|
|
from typing import TYPE_CHECKING, Any, NewType, Optional, Sequence, Union
|
|
|
|
|
|
__all__ = [
|
|
"Data",
|
|
"LoggerLike",
|
|
"StatusLike",
|
|
"Origin",
|
|
"Subprotocol",
|
|
"ExtensionName",
|
|
"ExtensionParameter",
|
|
]
|
|
|
|
|
|
# Public types used in the signature of public APIs
|
|
|
|
# Change to str | bytes when dropping Python < 3.10.
|
|
Data = Union[str, bytes]
|
|
"""Types supported in a WebSocket message:
|
|
:class:`str` for a Text_ frame, :class:`bytes` for a Binary_.
|
|
|
|
.. _Text: https://datatracker.ietf.org/doc/html/rfc6455#section-5.6
|
|
.. _Binary : https://datatracker.ietf.org/doc/html/rfc6455#section-5.6
|
|
|
|
"""
|
|
|
|
|
|
# Change to logging.Logger | ... when dropping Python < 3.10.
|
|
if TYPE_CHECKING:
|
|
LoggerLike = Union[logging.Logger, logging.LoggerAdapter[Any]]
|
|
"""Types accepted where a :class:`~logging.Logger` is expected."""
|
|
else: # remove this branch when dropping support for Python < 3.11
|
|
LoggerLike = Union[logging.Logger, logging.LoggerAdapter]
|
|
"""Types accepted where a :class:`~logging.Logger` is expected."""
|
|
|
|
|
|
# Change to http.HTTPStatus | int when dropping Python < 3.10.
|
|
StatusLike = Union[http.HTTPStatus, int]
|
|
"""
|
|
Types accepted where an :class:`~http.HTTPStatus` is expected."""
|
|
|
|
|
|
Origin = NewType("Origin", str)
|
|
"""Value of a ``Origin`` header."""
|
|
|
|
|
|
Subprotocol = NewType("Subprotocol", str)
|
|
"""Subprotocol in a ``Sec-WebSocket-Protocol`` header."""
|
|
|
|
|
|
ExtensionName = NewType("ExtensionName", str)
|
|
"""Name of a WebSocket extension."""
|
|
|
|
# Change to tuple[str, str | None] when dropping Python < 3.10.
|
|
ExtensionParameter = tuple[str, Optional[str]]
|
|
"""Parameter of a WebSocket extension."""
|
|
|
|
|
|
# Private types
|
|
|
|
ExtensionHeader = tuple[ExtensionName, Sequence[ExtensionParameter]]
|
|
"""Extension in a ``Sec-WebSocket-Extensions`` header."""
|
|
|
|
|
|
ConnectionOption = NewType("ConnectionOption", str)
|
|
"""Connection option in a ``Connection`` header."""
|
|
|
|
|
|
UpgradeProtocol = NewType("UpgradeProtocol", str)
|
|
"""Upgrade protocol in an ``Upgrade`` header."""
|