Digits Solver is a Python program that solves a digits puzzle game by finding mathematical operations that can be applied to a set of starting digits to obtain a target digit.

• Usage
• Examples
• Alternative Usage
• Contributing
• License

To run the Digits Solver program, execute the following command:

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

• <starting_digits>: A space-separated list of integers representing the starting digits.
• <target_digit>: The target digit that needs to be obtained.
• -os or --onesolution (optional): If specified, the program will find only one solution. Otherwise, it will find all possible solutions.
• -h or --help (optional): If used, the help menu would be shown.

1. Find all solutions for the digits puzzle:

   python solver 3 12 15 20 23 25 439

2. Find only one solution for the digits puzzle:

   python solver 3 12 15 20 23 25 439 -os

The program will output the number of solutions found and display each solution in the following format:

solution found:
15 + 3 = 18
23 × 18 = 414
414 + 25 = 439

we found 1 solution(s)

The Digits Solver can also be imported as a Python module and used programmatically. Here's an example:

from solver.solver import DigitSolver
solver = DigitSolver([3, 12, 15, 20, 23, 25], 439)
solution_count = solver.solve(False)
print(f"we found {solution_count} solution(s)")

I have also included a few additional Python programs that complement the solver program. You can find detailed instructions on how to use each of these programs below:

• How to Use prettySolve.py: Provides a visually enhanced version of the solver program.
• How to Use solveDaily.py: Demonstrates how to solve the puzzle using daily challenge inputs.
• How to Use solveMany.py: Shows how to solve multiple puzzles in a batch.

Feel free to explore these files and utilize them for specific use cases or scenarios.

Contributions to the Digits Solver program are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.

When contributing, please ensure that you follow best practices, maintain code quality, and provide clear descriptions of your changes.

The Digits Solver program is licensed under the MIT License. You are free to use, modify, and distribute this program for personal or commercial purposes. Please see the LICENSE file for more details.

Special thanks to the author of timeshift.js for their contribution to this project. Portions of their code have been utilized in the implementation of the speedrun.py