Merge pull request #47 from SmilingWayne/basic-dev

v0.3.2 update

Author: SmilingWayne

README.CN.md

@@ -23,6 +23,7 @@ nav:
       - cave: puzzles/cave.md
       - clueless_1_sudoku: puzzles/clueless_1_sudoku.md
       - clueless_2_sudoku: puzzles/clueless_2_sudoku.md
+      - cojun: puzzles/cojun.md
       - country_road: puzzles/country_road.md
       - creek: puzzles/creek.md
       - detour: puzzles/detour.md
@@ -37,6 +38,7 @@ nav:
       - fuzuli: puzzles/fuzuli.md
       - gappy: puzzles/gappy.md
       - gattai_8_sudoku: puzzles/gattai_8_sudoku.md
+      - geradeweg: puzzles/geradeweg.md
       - grand_tour: puzzles/grand_tour.md
       - hakoiri: puzzles/hakoiri.md
       - hakyuu: puzzles/hakyuu.md
@@ -66,24 +68,30 @@ nav:
       - moon_sun: puzzles/moon_sun.md
       - mosaic: puzzles/mosaic.md
       - munraito: puzzles/munraito.md
+      - nanro: puzzles/nanro.md
       - nawabari: puzzles/nawabari.md
       - nondango: puzzles/nondango.md
       - nonogram: puzzles/nonogram.md
       - norinori: puzzles/norinori.md
       - number_cross: puzzles/number_cross.md
+      - nurikabe: puzzles/nurikabe.md
       - nurimisaki: puzzles/nurimisaki.md
       - one_to_x: puzzles/one_to_x.md
       - paint_area: puzzles/paint_area.md
       - patchwork: puzzles/patchwork.md
       - pfeilzahlen: puzzles/pfeilzahlen.md
       - pills: puzzles/pills.md
+      - pipes: puzzles/pipes.md
       - putteria: puzzles/putteria.md
       - regional_yajilin: puzzles/regional_yajilin.md
       - renban: puzzles/renban.md
       - samurai_sudoku: puzzles/samurai_sudoku.md
       - shikaku: puzzles/shikaku.md
+      - shimaguni: puzzles/shimaguni.md
       - shingoki: puzzles/shingoki.md
+      - shirokuro: puzzles/shirokuro.md
       - shogun_sudoku: puzzles/shogun_sudoku.md
+      - shugaku: puzzles/shugaku.md
       - simple_loop: puzzles/simple_loop.md
       - skyscraper: puzzles/skyscraper.md
       - slitherlink: puzzles/slitherlink.md
@@ -97,12 +105,14 @@ nav:
       - sudoku: puzzles/sudoku.md
       - suguru: puzzles/suguru.md
       - sumo_sudoku: puzzles/sumo_sudoku.md
+      - tatamibari: puzzles/tatamibari.md
       - tenner_grid: puzzles/tenner_grid.md
       - tent: puzzles/tent.md
       - terra_x: puzzles/terra_x.md
       - thermometer: puzzles/thermometer.md
       - tile_paint: puzzles/tile_paint.md
       - trinairo: puzzles/trinairo.md
+      - usoone: puzzles/usoone.md
       - windmill_sudoku: puzzles/windmill_sudoku.md
       - yajikabe: puzzles/yajikabe.md
       - yajilin: puzzles/yajilin.md
@@ -134,7 +144,6 @@ theme:
     - navigation.top
     - navigation.indexes
 
-
 markdown_extensions:
   - admonition
   - meta
@@ -166,5 +175,4 @@ markdown_extensions:
   - pymdownx.snippets
   - pymdownx.emoji:
       emoji_index: !!python/name:material.extensions.emoji.twemoji
-      emoji_generator:
-        !!python/name:material.extensions.emoji.to_svg
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg

README.md

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "puzzlekit"
-version = "0.3.1"
-description = "A comprehensive logic puzzle solver (90+) based on Google OR-Tools. e.g., solvers for Nonogram, Slitherlink, Akari, Yajilin, Hitori and Sudoku-variants."
+version = "0.3.2"
+description = "A comprehensive logic puzzle solver (100+) based on Google OR-Tools. e.g., solvers for Nonogram, Slitherlink, Akari, Yajilin, Hitori and Sudoku-variants."
 readme = "README.md"
 requires-python = ">=3.10"
 authors = [{name = "SmilingWayne", email = "xiaoxiaowayne@gmail.com"}]

mkdocs.yml

@@ -133,12 +133,19 @@ def parse_args():
     group.add_argument("-p", "--puzzle", type=str, 
                        help="Specific puzzle name to benchmark (e.g. 'Akari', 'slitherlink'). Case-insensitive.")
 
+    parser.add_argument("--skip", type=str, default="",
+                        help="Comma-separated list of puzzle names to skip (e.g., 'Nurikabe,Fillomino').")
     return parser.parse_args()
 
 def main():
     import time 
     tic = time.perf_counter()
     args = parse_args()
+    # Support skip func
+    skip_set = set()
+    if args.skip:
+        skip_set = {name.strip() for name in args.skip.split(',') if name.strip()}
+        print(f"NOTE: Will skip the following puzzles: {', '.join(skip_set)}")
 
     # Default behavior: run all if no arguments specified
     target_puzzle = args.puzzle
@@ -216,7 +223,17 @@ def main():
         # Check solver availability
         solver_status = "❌"
         has_solver_impl = False
-        if puzzle_type:
+        # if puzzle_type:
+        #     try:
+        #         get_solver_class(puzzle_type)
+        #         has_solver_impl = True
+        #         solver_status = "✅"
+        #     except (ValueError, AttributeError):
+        #         pass
+        if folder_name in skip_set:
+            print(f"[{idx}/{len(sorted_assets)}] Skipping {folder_name} (Requested by user --skip)")
+
+        elif puzzle_type:
             try:
                 get_solver_class(puzzle_type)
                 has_solver_impl = True

pyproject.toml

@@ -4,11 +4,21 @@
 # Raw input data
 start_time = time.time()
 problem_str = """
-10 10\n- - - - - 3sx - - - -\n- - - o - - - 3so - -\n- x - - - - - - - -\n- - - - 2eo - - - o -\n1nx - - - - - 1wo - - -\n- - - 1so - - - - - 2nx\n- x - - - 1sx - - - -\n- - - - - - - - o -\n- - 3nx - - - x - - -\n- - - - 2ex - - - - -
+10 10
+- - - - - b - - - -
+- b - - w - - b - -
+w - - - - - - - - -
+- - - - - - - - w -
+- - - - - b b - b -
+- w - w w - - - - -
+- w - - - - - - - -
+- - - - - - - - - b
+- - b - - b - - w -
+- - - - w - - - - -
 """
 
 # Solve
-res = puzzlekit.solve(problem_str, puzzle_type="castle_wall")
+res = puzzlekit.solve(problem_str, puzzle_type="masyu")
 
 # Print solution grid
 print(res.solution_data.get('solution_grid', []))
@@ -17,4 +27,4 @@
 end_time = time.time()
 print(f"Time taken: {end_time - start_time} seconds")
 # Visualize (optional)
-res.show()
+res.show()

scripts/benchmark.py

@@ -72,4 +72,4 @@ def solver(puzzle_type: str, data: Dict[str, Any] = None, **kwargs) -> Any:
     return SolverClass(**init_params)
 
 __all__ = ["solve", "solver"]
-__version__ = '0.3.1'
+__version__ = '0.3.2'

scripts/quick_start.py

@@ -209,7 +209,6 @@ def solve(self) -> dict:
             # If _check_and_add_cuts returns True, it means the current solution does not satisfy the connectivity constraint,
             # and new constraints have been added. We need to continue solving.
             cuts_added = self._check_and_add_cuts()
-            
             if not cuts_added:
                 # No new cuts added -> All constraints satisfied -> Found final solution.
                 final_status_str = "Optimal" if status == pywraplp.Solver.OPTIMAL else "Feasible"

src/puzzlekit/__init__.py

@@ -118,6 +118,16 @@
     "nurimisaki": standard_grid_parser,
     "aqre": standard_region_grid_parser,
     "canal_view": standard_grid_parser,
+    "nurikabe": standard_grid_parser,
+    "cojun": standard_region_grid_parser,
+    "shugaku": standard_grid_parser,
+    "geradeweg": standard_grid_parser,
+    "nanro": standard_region_grid_parser,
+    "shimaguni": standard_region_grid_parser,
+    "usoone": standard_region_grid_parser,
+    "tatamibari": standard_grid_parser,
+    "shirokuro": standard_grid_parser,
+    "pipes": standard_grid_parser,
 }
 
 

src/puzzlekit/core/solver.py

@@ -97,6 +97,16 @@
     from .nurimisaki import NurimisakiSolver
     from .aqre import AqreSolver
     from .canal_view import CanalViewSolver
+    from .nurikabe import NurikabeSolver
+    from .cojun import CojunSolver
+    from .shugaku import ShugakuSolver
+    from .geradeweg import GeradewegSolver
+    from .nanro import NanroSolver
+    from .shimaguni import ShimaguniSolver
+    from .usoone import UsooneSolver
+    from .tatamibari import TatamibariSolver
+    from .shirokuro import ShirokuroSolver
+    from .pipes import PipesSolver
 # ==========================================
 # Core: Mapping of puzzle type to solver class
 # ==========================================
@@ -202,6 +212,18 @@
     "nurimisaki": ("nurimisaki", "NurimisakiSolver"),
     "aqre": ("aqre", "AqreSolver"),
     "canal_view": ("canal_view", "CanalViewSolver"),
+    "nurikabe": ("nurikabe", "NurikabeSolver"),
+    "cojun": ("cojun", "CojunSolver"),
+    "shugaku": ("shugaku", "ShugakuSolver"),
+    "geradeweg": ("geradeweg", "GeradewegSolver"),
+    "nanro": ("nanro", "NanroSolver"),
+    "shimaguni": ("shimaguni", "ShimaguniSolver"),
+    "usoone": ("usoone", "UsooneSolver"),
+    "tatamibari": ("tatamibari", "TatamibariSolver"),
+    "shirokuro": ("shirokuro", "ShirokuroSolver"),
+    "pipes": ("pipes", "PipesSolver"),
+
+
 }
 # ==========================================