README_fr.md

English • 繁體中文 • 简体中文 • 日本語 • Español • Français • Italiano • Deutsche • Русский

Bienvenue dans Digits Solver, l'ultime compagnon Python pour conquérir le jeu de puzzle Digits qui vous fait perdre la tête, développé par le New York Times. Plongez dans un monde captivant de défis numériques et maîtrisez l'art de la manipulation stratégique. Avec Digits Solver, vous manipulerez de manière stratégique un ensemble de chiffres de départ à l'aide d'opérations mathématiques pour atteindre le chiffre cible insaisissable. Son puissant algorithme et son analyse minutieuse vous permettent de résoudre rapidement chaque puzzle en fournissant des solutions étape par étape avec une précision inébranlable. Rehaussez votre talent de résolution de puzzles et déverrouillez les secrets cachés dans les chiffres. Préparez-vous pour un voyage passionnant pour devenir un maître des Digits !

Démo

Regardez l'algorithme en action en cliquant sur

le bouton d'exécution vert après avoir été redirigé :

Vous pouvez également regarder cette démonstration rapide qui utilise l'algorithme Digits Solver :

Remarque : La démo présente la fonction solve_auto. Continuez à lire pour plus d'informations.

Table des matières

• Installation
• Utilisation
• Exemples
• Utilisation alternative
• Modules utilitaires
• Contribuer
• Licence
• Remerciements

Installation

Vous pouvez obtenir une copie du programme Digits Solver en utilisant l'une des méthodes suivantes :

1. Cloner le référentiel :

   git clone https://github.com/yuchuehw/DigitsSolver.git

2. Télécharger le fichier Zip :

   • Rendez-vous dans l'onglet Release du référentiel GitHub.
   • Téléchargez le dernier fichier zip de la version.
   • Extrayez le contenu du fichier zip à l'emplacement souhaité.

Après avoir obtenu le programme, vous pouvez passer à la section Utilisation pour exécuter le programme Digits Solver.

Utilisation

Pour exécuter le programme Digits Solver, ouvrez le terminal et naviguez vers le répertoire où vous avez téléchargé ou cloné le référentiel DigitsSolver. Une fois dans le répertoire approprié, exécutez la commande suivante dans le terminal (remplacez les valeurs entre crochets par vos entrées ; consultez la section Exemples pour plus de détails) :

python solver <starting_digits> <target_digit> [-os] [-h]

• <starting_digits> : Une liste d'entiers séparés par des espaces représentant les chiffres de départ.
• <target_digit> : Le chiffre cible à atteindre.
• -os ou --onesolution (facultatif) : Si spécifié, le programme trouvera seulement une solution. Sinon, il trouvera toutes les solutions possibles.
• -h ou --help (facultatif) : Si utilisé, le menu d'aide sera affiché.

Exemples

1. Trouver toutes les solutions pour le puzzle des chiffres :

   python solver 3 12 15 20 23 25 439

2. Trouver seulement une solution pour le puzzle des chiffres :

   python solver 3 12 15 20 23 25 439 -os

3. Notez que les chiffres de départ vont toujours avant les chiffres cibles. Voici un exemple de puzzle avec 8 chiffres de départ

:

python solver 2 3 5 7 11 13 17 19 323 -os

Sortie

Le programme affichera le nombre de solutions trouvées et affichera chaque solution dans le format suivant :

Solution trouvée :
15 + 3 = 18
23 × 18 = 414
414 + 25 = 439

Nous avons trouvé 1 solution(s)

Utilisation alternative

Le Digits Solver peut également être importé en tant que module Python et utilisé de manière programmatique. Vous êtes libre d'ajouter plus de fonctionnalités que celles que nous avons fournies. Voici un exemple minimal de son utilisation en tant qu'importation :

from solver.solver import DigitSolver

solver = DigitSolver([3, 12, 15, 20, 23, 25], 439)
# False entre parenthèses est facultatif. False résout toutes les solutions. True résout une seule solution.
# utilisez solve.printer = some_function pour remplacer le comportement de sortie par défaut.
solution_count = solver.solve(False)
print(f"Nous avons trouvé {solution_count} solution(s)")

Modules utilitaires

Nous avons également inclus quelques programmes Python supplémentaires qui complètent le programme solveur. Ils se trouvent dans le dossier solver/util. Vous pouvez en savoir plus sur leur utilisation ici :

• Comment utiliser pretty_solve.py : Fournit une version visuellement améliorée du programme solveur.
• Comment utiliser solve_auto.py : Solveur Digits entièrement automatique avec Selenium.

N'hésitez pas à explorer ces fichiers et à les utiliser pour des cas d'utilisation ou des scénarios spécifiques.

Le dossier Appendix contient 450 problèmes utilisés dans les jeux NYT. N'hésitez pas à utiliser ces problèmes pour tester le programme.

Contribuer

Les contributions au programme Digits Solver sont les bienvenues ! Si vous trouvez des problèmes ou avez des suggestions d'améliorations, veuillez ouvrir une issue ou soumettre une demande d'extraction sur le référentiel GitHub.

Lorsque vous contribuez, veuillez vous assurer de suivre les meilleures pratiques, de maintenir la qualité du code et de fournir des descriptions claires de vos modifications.

Licence

Le programme Digits Solver est sous licence MIT License. Vous êtes libre d'utiliser, de modifier et de distribuer ce programme à des fins personnelles ou commerciales. Veuillez consulter le fichier LICENSE pour plus de détails.

Remerciements

Un grand merci à l'auteur de timeshift.js pour sa contribution à ce projet. Des parties de leur code ont été utilisées dans la mise en œuvre du module solveur.util.