Sudoku Validation

Comprehensive Sudoku Puzzle Validation Package

Sudoku Validation is a lightweight Python package for validating 9×9 Sudoku puzzles. It verifies rows, columns, 3×3 sub-grids, and entire boards according to standard Sudoku rules.

Installation

Install from PyPI

pip install sudoku_validation

Install development version

git clone https://github.com/your-org/sudoku_validation.git
cd sudoku_validation
pip install -e ".[dev]"

Quick Start

from sudoku_validation import combined_validation

board = [
    [5, 3, 4, 6, 7, 8, 9, 1, 2],
    [6, 7, 2, 1, 9, 5, 3, 4, 8],
    [1, 9, 8, 3, 4, 2, 5, 6, 7],
    [8, 5, 9, 7, 6, 1, 4, 2, 3],
    [4, 2, 6, 8, 5, 3, 7, 9, 1],
    [7, 1, 3, 9, 2, 4, 8, 5, 6],
    [9, 6, 1, 5, 3, 7, 2, 8, 4],
    [2, 8, 7, 4, 1, 9, 6, 3, 5],
    [3, 4, 5, 2, 8, 6, 1, 7, 9]
]

combined_validation(board)

Output:

True

Examples

Validate a Single Row

from sudoku_validation import array_validation

array_validation([5, 3, 4, 6, 7, 8, 9, 1, 2])

Output:

True

Validate Rows, Columns, and 3×3 Squares

from sudoku_validation import row_validation, column_validation, square_validation

row_validation(board)
column_validation(board)
square_validation(board)

Developer Guide

Build documentation locally

quarto render

Preview documentation

quarto preview

Run tests

pytest

API Reference

See full API documentation with function signatures and examples: API Reference