📖 docs(readme): ajouter l'exemple du cas d'usage réel#22
Merged
Conversation
Traiter un dossier est ce que fera l'immense majorité des utilisateurs, et c'est ce qui montre le mieux la dégradation gracieuse : un seul catch, un continue, aucun fichier non-RAW ne casse la boucle. L'exemple a été exécuté tel quel avant commit. Le README ne contient pas le code de bin/extract-local.php : ce script ne fait que ces mêmes quatre lignes dans une boucle, plus 90 lignes de formatage tabulaire. Le dupliquer n'apprendrait rien sur l'API et créerait deux copies à maintenir, dont une silencieusement fausse au premier changement.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Traiter un dossier de photos est ce que fera l'immense majorité des utilisateurs. C'est aussi ce qui montre le mieux la dégradation gracieuse : un seul
catch, uncontinue, et aucun fichier non-RAW ne casse la boucle.Exécuté tel quel avant commit sur les fixtures locales : trois RAW traités, le sous-dossier
output/ignoré proprement par lecatch.Ajoute aussi la propriété qui justifie l'approche : l'extraction est O(1) en taille de fichier — 30 Mo prennent les mêmes ~2 ms que 7 Mo, parce que le fichier n'est jamais chargé.
Pourquoi pas le code de
bin/extract-local.phpCe script ne fait que ces quatre lignes dans une boucle, plus ~90 lignes de
glob,mkdiret formatage tabulaire. Le coller dans le README n'apprendrait rien de plus sur l'API, noierait l'information utile, et créerait deux copies à maintenir — dont une silencieusement fausse au premier changement du script.Le README documente l'API ; le script est un outil dont on donne la commande, et son code est sur GitHub à un clic.