sudoku-smt-solvers 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

sudoku_smt_solvers/__init__.py

@@ -1,4 +1,19 @@
-from .benchmarks import BenchmarkRunner, SudokuGenerator
-from .solvers import CVC5Solver, DPLLSolver, Z3Solver
+"""Sudoku SMT Solvers - A package for solving and benchmarking large-scale Sudoku puzzles.
 
-__version__ = "0.1.0"
+This package provides various SAT and SMT-based solvers optimized for 25x25 Sudoku puzzles,
+along with tools for puzzle generation and solver benchmarking.
+
+Key Components:
+- Multiple solver implementations (DPLL, DPLL(T), Z3, CVC5)
+- Sudoku puzzle generator with difficulty settings
+- Benchmarking suite for comparing solver performance
+"""
+
+from .solvers.dpll_solver import DPLLSolver
+from .solvers.dpllt_solver import DPLLTSolver
+from .solvers.z3_solver import Z3Solver
+from .solvers.cvc5_solver import CVC5Solver
+from .benchmarks.benchmark_runner import BenchmarkRunner
+from .benchmarks.sudoku_generator.sudoku_generator import SudokuGenerator
+
+__version__ = "0.2.0"

sudoku_smt_solvers/solvers/cvc5_solver.py

@@ -1,7 +1,7 @@
 from typing import List, Optional
 import atexit
 from cvc5 import Kind, Solver
-from .sudoku_error import SudokuError
+from .utils.sudoku_error import SudokuError
 
 
 class CVC5Solver:

sudoku_smt_solvers/solvers/dpll_solver.py

@@ -1,7 +1,7 @@
 from typing import List, Optional
 from pysat.solvers import Solver
 from pysat.formula import CNF
-from .sudoku_error import SudokuError
+from .utils.sudoku_error import SudokuError
 
 
 class DPLLSolver:

sudoku_smt_solvers/solvers/dpllt_solver.py

@@ -1,7 +1,7 @@
 from typing import List, Optional
 from pysat.solvers import Solver
 from pysat.formula import CNF
-from .sudoku_error import SudokuError
+from .utils.sudoku_error import SudokuError
 
 
 class DPLLTSolver:

sudoku_smt_solvers/solvers/z3_solver.py

@@ -1,5 +1,5 @@
 from z3 import Solver, Int, Distinct, sat
-from sudoku_smt_solvers.solvers.sudoku_error import SudokuError
+from .utils.sudoku_error import SudokuError
 
 
 class Z3Solver:

{sudoku_smt_solvers-0.1.0.dist-info → sudoku_smt_solvers-0.2.0.dist-info}/METADATA

@@ -1,31 +1,41 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: sudoku_smt_solvers
-Version: 0.1.0
+Version: 0.2.0
 Summary: A collection of SAT and SMT solvers for solving Sudoku puzzles
 Home-page: https://liamjdavis.github.io/sudoku-smt-solvers
-Author: Liam Davis
-Author-email: ljdavis27@amherst.edu
+Author: Liam Davis, Tairan 'Ryan' Ji
+Author-email: ljdavis27@amherst.edu, tji26@amherst.edu
 License: MIT
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: cvc5
-Requires-Dist: pysat
+Requires-Dist: python-sat
 Requires-Dist: z3-solver
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # Sudoku-SMT-Solvers
 
 [![Pytest + CI/CD](https://github.com/liamjdavis/Sudoku-SMT-Solvers/actions/workflows/test.yml/badge.svg)](ttps://github.com/liamjdavis/Sudoku-SMT-Solvers/actions/workflows/test.yml)
 [![Coverage Status](https://coveralls.io/repos/github/liamjdavis/Sudoku-SMT-Solvers/badge.svg)](https://coveralls.io/github/liamjdavis/Sudoku-SMT-Solvers)
 [![Docs Build Deployment](https://github.com/liamjdavis/Sudoku-SMT-Solvers/actions/workflows/docs.yml/badge.svg)](https://github.com/liamjdavis/Sudoku-SMT-Solvers/actions/workflows/docs.yml)
-[![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://liamjdavis.github.io/sudoku-smt-solvers)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://liamjdavis.github.io/Sudoku-SMT-Solvers)
 
 
 ## About
-This repository contains the code for the study "Evaluating SMT-Based Solvers on Sudoku". Created by Liam Davis (@liamjdavis) and Ryan Ji (@TairanJ) as their for COSC-241 Artificial Intelligence at Amherst College, it evaluates the efficacy of SMT-Based Solvers by benchmarking three modern SMT solvers (DPLL(T), Z3, and CVC5) against the DPLL algorithm on a collection of 100 25x25 Sudoku puzzles of varying difficulty.
+This repository contains the code for the study "Evaluating SMT-Based Solvers on Sudoku". Created by Liam Davis (@liamjdavis) and Tairan "Ryan" Ji (@TairanJ) as their for COSC-241 Artificial Intelligence at Amherst College, it evaluates the efficacy of SMT-Based Solvers by benchmarking three modern SMT solvers (DPLL(T), Z3, and CVC5) against the DPLL algorithm on a collection of 100 25x25 Sudoku puzzles of varying difficulty.
 
 Along with the study, we also published `sudoku-smt-solvers`, a Python package that provides the various SMT-based Sudoku solvers and benchmarking tools we built for this study. The package features DPLL(T), Z3, and CVC5 solvers optimized for 25x25 Sudoku puzzles, a puzzle generator for creating test cases, and a comprehensive benchmarking suite. Available through pip, it offers a simple API for solving Sudoku puzzles using state-of-the-art SMT solvers while facilitating performance comparisons between different solving approaches.
 

sudoku_smt_solvers-0.2.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+sudoku_smt_solvers/__init__.py,sha256=9LqjXOhMICYiSF1Ja22tDh3gopxsj2fg4yYXaENqu3M,763
+sudoku_smt_solvers/benchmarks/__init__.py,sha256=lMrK_yj_otywN4dMvvVFtTzyTdamS_4nUgjm-k07obU,271
+sudoku_smt_solvers/benchmarks/benchmark_runner.py,sha256=Mc87ul-6VkWMomtlmOMc9GXmC4AwfQUwIWKDjeFvSVA,7712
+sudoku_smt_solvers/solvers/__init__.py,sha256=5qFfWzKN2WPDoFLN5ye6Ly5BqEaUdk2ks_jPP3c53l8,142
+sudoku_smt_solvers/solvers/cvc5_solver.py,sha256=igN27LHxUADmYw3farmEeGtjJEsrdSQEk0X0X_EItyQ,6855
+sudoku_smt_solvers/solvers/dpll_solver.py,sha256=itLEx8QdomSS9nA7CrhSlU7wN-e8vDInAWiwhXX-7Ug,6144
+sudoku_smt_solvers/solvers/dpllt_solver.py,sha256=8HJWOGU6Oj4hNpgkK96sI51bdiTfRLSlf5yhic7WeF0,7992
+sudoku_smt_solvers/solvers/z3_solver.py,sha256=e6WPwPdN8uUipjxNm7KRYlbsNNwGyxH3s4wy5wC8PPc,4902
+sudoku_smt_solvers-0.2.0.dist-info/LICENSE,sha256=PbuZlvluV1l4HMMfPAVe5yjVvFGBK9DFp20JNhoJ8bI,1067
+sudoku_smt_solvers-0.2.0.dist-info/METADATA,sha256=fLlazpd0XnC3xb5Ix3ZF1nzcc8xI_pBDrk-dp0FmEZY,6680
+sudoku_smt_solvers-0.2.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+sudoku_smt_solvers-0.2.0.dist-info/top_level.txt,sha256=Ww9vs8KC4aujzfGfddMl_X8Qzh-Cywn9aBTLQgemi5A,19
+sudoku_smt_solvers-0.2.0.dist-info/RECORD,,

{sudoku_smt_solvers-0.1.0.dist-info → sudoku_smt_solvers-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.7.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

sudoku_smt_solvers/solvers/sudoku_error.py

@@ -1,8 +0,0 @@
-class SudokuError(Exception):
-    """An exception class for errors in the sudoku solver"""
-
-    def __init__(self, message):
-        self.message = message
-
-    def __str__(self):
-        return self.message

sudoku_smt_solvers-0.1.0.dist-info/RECORD

@@ -1,14 +0,0 @@
-sudoku_smt_solvers/__init__.py,sha256=vTwJLa8Yp7q-OdzA44zhFIK-LhK2o8aDt-4qOJJ1M7M,134
-sudoku_smt_solvers/benchmarks/__init__.py,sha256=lMrK_yj_otywN4dMvvVFtTzyTdamS_4nUgjm-k07obU,271
-sudoku_smt_solvers/benchmarks/benchmark_runner.py,sha256=Mc87ul-6VkWMomtlmOMc9GXmC4AwfQUwIWKDjeFvSVA,7712
-sudoku_smt_solvers/solvers/__init__.py,sha256=5qFfWzKN2WPDoFLN5ye6Ly5BqEaUdk2ks_jPP3c53l8,142
-sudoku_smt_solvers/solvers/cvc5_solver.py,sha256=DfLlgzhhgSaI3tV_4mzy3vdpxY5tISSFhs0xhRWcMYk,6849
-sudoku_smt_solvers/solvers/dpll_solver.py,sha256=ThLT1v87oNnzDMpYmoPcmTeeXijVIgk6A6qULWVID28,6138
-sudoku_smt_solvers/solvers/dpllt_solver.py,sha256=4UXcod7EnJGlD7OlakmPHOuIyWga5yN9rMtKMvuEAc8,7986
-sudoku_smt_solvers/solvers/sudoku_error.py,sha256=iUcv1QCgQ7anov0b-AtIB1fbfZ3yWfci4eTp_8RuUJg,208
-sudoku_smt_solvers/solvers/z3_solver.py,sha256=awQ3tzEMIy2woFmATMiwQsC2YtktxfJlx55MudB1SN0,4922
-sudoku_smt_solvers-0.1.0.dist-info/LICENSE,sha256=PbuZlvluV1l4HMMfPAVe5yjVvFGBK9DFp20JNhoJ8bI,1067
-sudoku_smt_solvers-0.1.0.dist-info/METADATA,sha256=lbOf7Pgg4nsMlchZ54WHWcJoGa98BvgCMHCMieULSrw,6414
-sudoku_smt_solvers-0.1.0.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
-sudoku_smt_solvers-0.1.0.dist-info/top_level.txt,sha256=Ww9vs8KC4aujzfGfddMl_X8Qzh-Cywn9aBTLQgemi5A,19
-sudoku_smt_solvers-0.1.0.dist-info/RECORD,,