queens_reasoner.utils

Functions

create_logger(name)	Create and configure a logger with a standard format.
print_queens_solution(mat, mask)	Print a formatted Queens puzzle solution to the terminal.
mark_ndarray(x[, marker, anti_marker])	Format an integer value with optional terminal coloring.

Module Contents

queens_reasoner.utils.create_logger(name)

Create and configure a logger with a standard format.

Parameters:

name (str) – Logger name, typically in "package::module" format.

Returns:

Configured logger instance.

Return type:

logging.Logger

queens_reasoner.utils.print_queens_solution(mat, mask)

Print a formatted Queens puzzle solution to the terminal.

The board layout is displayed as a colored NumPy array where queen positions are highlighted using terminal color formatting.

Internally, queen cells are represented as negative values to allow conditional coloring during NumPy array formatting.

Parameters:

• mat (np.ndarray) – Sparse matrix of the puzzle layout. Each entry contains the integer color ID of a cell.

• mask (np.ndarray) – Dense matrix indicating queen placements. 1 is a queen, 0 is a non-queen, -1 is unknown.

Returns:

None

Return type:

None

queens_reasoner.utils.mark_ndarray(x, marker='*', anti_marker='x')

Format an integer value with optional terminal coloring.

Negative values are highlighted using designated markers. Positive values are printed normally.

Parameters:

• x (int) – Integer value to format.

• marker (str) – Character used as the queen marker.

• anti_marker (str) – Character used as the non-queen marker.

Returns:

Formatted string.

Return type:

str

Example

>>> mark_ndarray(-3)
'3*'
>>> mark_ndarray(5)
'5x'
>>> mark_ndarray(10007)
' '