basicsudoku 0.1.2

创建数独板

创建一个空数独板

>>> board = basicsudoku.SudokuBoard()

预填充符号的板

>>> board = basicsudoku.SudokuBoard(symbols='2...8.3...6..7..84.3.5..2.9...1.54.8.........4.27.6...3.1..7.4.72..4..6...4.1...3')

禁用严格模式（严格模式会在你将无效符号放在棋盘上时引发异常。）

>>> board = basicsudoku.SudokuBoard(strict=False)

或者

>>> board = basicsudoku.SudokuBoard()
>>> board.strict = False

设置和获取符号

您可以将1到9的整数或字符串分配给一个xy元组索引

>>> board = basicsudoku.SudokuBoard()
>>> board[0, 0] = '1'
>>> board[0, 0]
'1'
>>> board[1, 0] = 2
>>> board[1, 0]
'2'

您可以使用 symbols 属性一次性获取或设置所有符号

>>> board = basicsudoku.SudokuBoard()
>>> board.symbols = '4.....8.5.3..........7......2.....6.....8.4......1.......6.3.7.5..2.....1.4......'
>>> print(board)
4 . . | . . . | 8 . 5
. 3 . | . . . | . . .
. . . | 7 . . | . . .
------+-------+------
. 2 . | . . . | . 6 .
. . . | . 8 . | 4 . .
. . . | . 1 . | . . .
------+-------+------
. . . | 6 . 3 | . 7 .
5 . . | 2 . . | . . .
1 . 4 | . . . | . . .

您还可以使用这些方法从行、列或方块中获取一个单元（9个符号）

>>> board = basicsudoku.SudokuBoard(symbols='4.....8.5.3..........7......2.....6.....8.4......1.......6.3.7.5..2.....1.4......')
>>> print(board)
4 . . | . . . | 8 . 5
. 3 . | . . . | . . .
. . . | 7 . . | . . .
------+-------+------
. 2 . | . . . | . 6 .
. . . | . 8 . | 4 . .
. . . | . 1 . | . . .
------+-------+------
. . . | 6 . 3 | . 7 .
5 . . | 2 . . | . . .
1 . 4 | . . . | . . .
>>> board.get_row(0)
['4', '.', '.', '.', '.', '.', '8', '.', '5']
>>> board.get_row(1)
['.', '3', '.', '.', '.', '.', '.', '.', '.']
>>> board.get_column(0)
['4', '.', '.', '.', '.', '.', '.', '5', '1']
>>> board.get_box(0, 0)
['4', '.', '.', '.', '3', '.', '.', '.', '.']
>>> board.get_box(1, 0)
['.', '.', '.', '.', '.', '.', '7', '.', '.']

验证检查

默认情况下，SudokuBoard 对象处于 严格模式，这意味着任何使棋盘 无效（即在相同的行、列或方块中有重复符号）的符号都会引发 SudokuBoardException。您可以在构造方法调用中设置关键字参数 strict=False 来禁用此功能。还有几个验证检查方法

• is_valid_symbol(self, symbol) - 如果符号是介于1和9之间的str或为EMPTY_SPACE，则返回True。

• is_complete_unit(self, unit) - 如果单元是所有9个符号的str且没有重复，则返回True。

• is_valid_unit(self, unit) - 如果单元是9个符号的str，可以包含EMPTY_SPACE但没有重复符号，则返回True。

• is_valid_board(self) - 如果棋盘处于有效状态（即使不完整），则返回True；否则，如果棋盘的行、列或方块中有重复符号，则返回False。

• is_full(self) - 如果棋盘上没有空格，则返回True。

• is_solved(self) - 如果棋盘当前已解决，则返回True。

迭代器

您可以从左上角开始迭代棋盘上的符号，然后向右，然后向下。例如

>>> board = basicsudoku.SudokuBoard(symbols='4.....8.5.3..........7......2.....6.....8.4......1.......6.3.7.5..2.....1.4......')
>>> for symbol in board:
...     print(symbol, end=' ')
...
4 . . . . . 8 . 5 . 3 . . . . . . . . . . 7 . . . . . . 2 . . . . . 6 . . . . . 8 . 4 . . . . . . 1 . . . . . . . 6 . 3 . 7 . 5 . . 2 . . . . . 1 . 4 . . . . . .

解决数独谜题

BasicSolver 类被传递一个 SudokuBoard 对象并立即解决它。

>>> board = SudokuBoard(symbols='4.....8.5.3..........7......2.....6.....8.4......1.......6.3.7.5..2.....1.4......')
>>> print(board)
4 . . | . . . | 8 . 5
. 3 . | . . . | . . .
. . . | 7 . . | . . .
------+-------+------
. 2 . | . . . | . 6 .
. . . | . 8 . | 4 . .
. . . | . 1 . | . . .
------+-------+------
. . . | 6 . 3 | . 7 .
5 . . | 2 . . | . . .
1 . 4 | . . . | . . .
>>> solver = BasicSolver(board)
>>> print(board)
4 1 7 | 3 6 9 | 8 2 5
6 3 2 | 1 5 8 | 9 4 7
9 5 8 | 7 2 4 | 3 1 6
------+-------+------
8 2 5 | 4 3 7 | 1 6 9
7 9 1 | 5 8 6 | 4 3 2
3 4 6 | 9 1 2 | 7 5 8
------+-------+------
2 8 9 | 6 4 3 | 5 7 1
5 7 3 | 2 9 1 | 6 8 4
1 6 4 | 8 7 5 | 2 9 3