# sudoku-cli --- ## About * A command-line tool for solving sudoku puzzles. * Install by running: `cargo install sudoku-cli` * If your input is a file path, `sudoku-cli` will read from the file. Otherwise it treats the string as input. * `sudoku-cli` reads the first 81 non-whitespace characters from the input and fills each row from left to right, starting with the top row. * `sudoku-cli` can output results to a file. The directory must already exist. --- ## Commands `sudoku-cli` has 5 sub-commands each with their own configurable options: * `sudoku-cli find-one` * `-i= | --input=` * `-t= | --threads=` * `-o= | --output=` * `-c | --compact` * `sudoku-cli find-all` * `-i= | --input=` * `-t= | --threads=` * `-o= | --output=` * `-c | --compact` * `sudoku-cli watch-one` * `-i= | --input=` * `-m= | --ms-per-frame=` * `sudoku-cli watch-all` * `-i= | --input=` * `-m= | --ms-per-frame=` * `sudoku-cli count-all` * `-i= | --input=` * `-t= | --threads=` --- ## Examples --- ### Find One Finds one possible solution to a sudoku puzzle. `sudoku-cli find-one --input=".75.....4.1...5.....8.7.........7.......6...1...8.2...3...9.7...5.3.4.........31."`

--- ### Find All Finds all possible solutions to a sudoku puzzle. `sudoku-cli find-all --input=path/to/puzzle --threads=8 --output=solutions.txt --compact`

--- ### Watch One Watch the solver find one solution to a sudoku puzzle. `sudoku-cli watch-one --input=path/to/puzzle`

--- ### Watch All Watch the solver find all possible solutions to a sudoku puzzle. `sudoku-cli watch-all --input=path/to/puzzle --ms-per-frame=15`

--- ### Count All Count the number of possible solutions without writing them to an output. `sudoku-cli count-all --input=path/to/puzzle --threads=8`