Master
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é.
37 lines
1.0 KiB
Python
37 lines
1.0 KiB
Python
class Doc:
|
|
"""Define the documentation of a type annotation using `Annotated`, to be
|
|
used in class attributes, function and method parameters, return values,
|
|
and variables.
|
|
|
|
The value should be a positional-only string literal to allow static tools
|
|
like editors and documentation generators to use it.
|
|
|
|
This complements docstrings.
|
|
|
|
The string value passed is available in the attribute `documentation`.
|
|
|
|
Example:
|
|
|
|
```Python
|
|
from typing import Annotated
|
|
from annotated_doc import Doc
|
|
|
|
def hi(name: Annotated[str, Doc("Who to say hi to")]) -> None:
|
|
print(f"Hi, {name}!")
|
|
```
|
|
"""
|
|
|
|
def __init__(self, documentation: str, /) -> None:
|
|
self.documentation = documentation
|
|
|
|
def __repr__(self) -> str:
|
|
return f"Doc({self.documentation!r})"
|
|
|
|
def __hash__(self) -> int:
|
|
return hash(self.documentation)
|
|
|
|
def __eq__(self, other: object) -> bool:
|
|
if not isinstance(other, Doc):
|
|
return NotImplemented
|
|
return self.documentation == other.documentation
|