Utilisation locale · 0.1.3
Ready Check
Diagnostic local de copies HTML, JSON et OpenAPI JSON.
Prérequis : Python déjà installé ; qualification Windows/Python 3.14.3 uniquement ; aucune dépendance supplémentaire.
15648 octets · SHA256 b7dc6fa578b23f00492b7c512b637c18cc4c8ce0b3762f58e3c99b98a23243b6
Usage gratuit personnel et professionnel autorisé. Aucun droit de redistribution ni de modification accordé. Conditions exactes.
Limites
Aucun site visité ; diagnostic limité, pas de certification. Exemple fictif : code1 attendu.
En cas de problème
E_MANIFEST_MISSING : ready-check-input.json manque dans le dossier choisi. Vérifiez le dossier ou créez le manifeste selon la notice. Aucun fichier du corpus n’a alors été analysé. Reprenez vers la même sortie seulement si elle n’existe pas encore.
Première utilisation, résultat et reprise
# Ready Check 0.1.3 — premier rapport local
Ready Check est un outil gratuit de diagnostic limité sur des copies locales HTML, JSON et OpenAPI JSON. Il produit un rapport lisible et un export JSON, avec observations, écarts, corrections et points non évalués. Aucun compte, portefeuille ou service en ligne n’est utilisé par le programme.
## Préparer
Qualification réalisée sur Windows avec Python 3.14.3. Python n’est pas inclus dans ce paquet. Aucune dépendance supplémentaire n’est à installer. Les autres systèmes et versions de Python n’ont pas été qualifiés dans cette remise.
1. Extraire l’archive dans un **nouveau dossier vide** avec l’outil ZIP de Windows. Ne pas exécuter depuis l’intérieur du ZIP et ne pas écraser une ancienne version.
2. Ouvrir PowerShell dans le dossier extrait qui contient ready_check.py et README.md.
3. Vérifier la présence de Python : `python --version`. Si la commande manque, le prérequis n’est pas satisfait ; le paquet ne déclenche aucune installation automatique.
## Produire le premier rapport
```powershell
python -X utf8 -B ready_check.py examples/demo --out mon-premier-rapport
$LASTEXITCODE
Get-Content -Encoding utf8 .\mon-premier-rapport\report.md
```
La démonstration ne contient que des données fictives. Le **code 1 est attendu** : elle comporte volontairement une réponse d’erreur non documentée et une référence à un schéma de sécurité absent. Ouvrir report.md pour les corrections ; report.json contient les mêmes constats structurés. Il ne s’agit pas d’une panne du programme. Ce scénario fictif ne contacte aucun service réel.
## Comprendre les retours
| Retour | Action |
|---|---|
| 0 | Rapport créé, sans écart repéré par les contrôles limités. Lire aussi les points non évalués : ce n’est pas un certificat de sécurité ou de compatibilité. |
| 1 | Rapport créé avec écarts. Lire la source et la correction de chaque constat. |
| 2 | Entrée ou export refusé. Lire le message, corriger puis relancer. Aucun rapport réussi n’est annoncé. |
E_INPUT_MISSING identifie le fichier absent ; E_INPUT_IO signale une lecture impossible ; E_MANIFEST indique un manifeste incorrect ; E_SIZE/E_TOTAL signalent une limite. E_EXISTS signifie que le dossier de sortie existe déjà : utiliser un nouveau nom, jamais effacer un rapport utile pour relancer. Une erreur de syntaxe JSON indique sa ligne/colonne. Les refus ne prouvent pas une panne du site dont proviennent les exports.
Après un refus ayant empêché la création de la sortie, reprendre vers le même nom si ce dossier n’existe pas. Après un rapport avec écarts, corriger une **copie** des entrées puis choisir un nouveau dossier, par exemple `--out rapport-corrige`. Les anciens résultats restent disponibles.
## Examiner ses propres fichiers
Utiliser un dossier dédié avec seulement des copies autorisées et nettoyées. Ne pas utiliser un dossier de travail contenant accès, clés, portefeuilles, documents clients ou sauvegardes. Ready Check n’est pas un détecteur exhaustif de secrets.
Créer dans ce dossier ready-check-input.json :
```json
{
"schema_version": "ready-check-input/1",
"files": [
{"path": "index.html", "kind": "html", "captured_at": null},
{"path": "api.json", "kind": "openapi", "captured_at": null}
]
}
```
Fournir les deux fichiers ou retirer l’entrée inutile. Pour des données JSON ordinaires, utiliser kind json. captured_at peut rester null si la date est inconnue ; sinon utiliser une date UTC réelle au format 2026-10-24T12:00:00Z. Cette date est déclarative, sans vérification de fraîcheur en ligne.
```powershell
python -X utf8 -B ready_check.py .\mes-exports --out mon-rapport
```
La sortie doit être hors du dossier mes-exports, avec un parent existant. Seuls les fichiers listés sont lus. UTF-8 requis ; HTML/HTM et JSON uniquement. OpenAPI 3.0.x/3.1.x JSON : sous-ensemble de contrôles documentaires, pas validation normative complète. YAML et références externes ne sont pas importés.
Chemins relatifs simples, lettres ASCII/chiffres/_/- et sous-dossiers séparés par /. Les liens/jonctions, traversées, chemins absolus, périphériques Windows et certains noms d’accès privés sont refusés. Limites : 64 fichiers, 512 Kio par fichier, 4 Mio au total, manifeste 64 Kio ; JSON limité à 20 000 nœuds/profondeur 64 ; 5 000 constats. Garder les exports stables pendant l’analyse.
## Lire les conclusions sans les dépasser
- observed : contrôle local précis satisfait, pas service testé.
- gap : écart concret ; correction indiquée.
- absent_in_corpus : élément non trouvé dans les fichiers choisis, pas absent sur tout le site.
- not_evaluated : preuve insuffisante ou contrôle hors périmètre.
- not_applicable : valeur réservée, non émise par cette version.
Les constats renvoient à une source identifiée par SHA256 et à une position. paths-entry:N désigne la N-ième clé de paths triée ; le nom du chemin API n’est pas recopié. Pour JSON-LD, script-line situe le bloc HTML, json-line/column la position dans son texte JSON. L’empreinte relie un fichier ; elle ne certifie ni son origine ni la vérité de son contenu.
Aucun lien, script, contexte JSON-LD ou référence OpenAPI n’est suivi ou exécuté. Une définition de sécurité vide est un écart ; une référence non résolue reste non évaluée ; une déclaration de sécurité présente ne prouve pas que le serveur la respecte. Rendu JavaScript, accessibilité, disponibilité, données métier, protection effective et compatibilité universelle ne sont pas qualifiés. Aucun meilleur classement par les IA n’est promis.
## Données et retrait
Lire DONNEES.md pour la conservation et la suppression. Le programme n’installe aucun service ou tâche de fond. Pour arrêter de l’utiliser, fermer le processus puis conserver ou retirer les dossiers locaux choisis. Aucune désinscription, compte ou paiement à annuler.
Le paquet est accompagné d’un manifeste d’empreintes. Le SHA256 de l’archive doit être comparé à celui fourni par le canal de diffusion approuvé ; il détecte une différence de fichier, pas une falsification coordonnée. Aucune licence ouverte, réutilisation illimitée ou certification n’est annoncée par cette notice.
## Manifeste absent et assistance
E_MANIFEST_MISSING indique que ready-check-input.json manque dans le dossier choisi. Vérifier ce dossier ou créer le manifeste selon le format ci-dessus, puis relancer vers la même sortie seulement si elle est toujours absente. Aucun fichier du corpus n’a alors été analysé. Après un rapport avec écarts, corriger une copie et choisir une nouvelle sortie.
Pour demander de l’aide, indiquer la version, le code d’erreur et un exemple fictif ; ne pas transmettre de corpus réel, rapport contenant des métadonnées sensibles ou secret. Aucun délai de support garanti. Les diagnostics de sécurité de 0.1.2 sont conservés ; le changement 0.1.3 porte uniquement sur ce refus initial et la version de règles.