ms_toollib

pypi MIT docs

A cross-platform minesweeper algorithm toolbox with a native Rust core.

Supports Python 3.7–3.13 on Windows, Linux, and macOS.

Installation

pip install ms_toollib

No additional dependencies required.

Features

Category Description
Mine Laying Random mine placement (first-click safe, Win7-style), no-guess mine generation (filter & adjustment methods)
Board Metrics 3BV, 3BV/s, openings (Op), islands (Isl), ZiNi (Greedy/Human/Random)
Probabilities Per-cell mine probability with block decomposition and enumeration
Deduction Solver 3-tier solver: direct subset, subtract-and-compare, full enumeration (≤55 cells)
Solvability Check Determine if a board is no-guess, find unsolvable structures
Game State Machine MinesweeperBoard / SafeMinesweeperBoard that accepts mouse clicks and tracks full game state
Replay Parsing Read AVF, EVF, MVF, RMV formats; save/write EVF (v0–v4) and EVFS containers
Optical Recognition Recognize board state from an RGBA image via ONNX neural network (Sobel, Hough, DP)

Quick Start

import ms_toollib as ms

# Generate a no-guess Beginner board
board = ms.laymine_solvable(9, 9, 10)
print(ms.cal_bbbv(board))          # 3BV
print(ms.cal_zini(board, 1))       # Greedy ZiNi

# Per-cell mine probability
prob = ms.cal_probability_onboard(board, 10)

# Parse a replay
video = ms.AvfVideo("replay.avf")
video.parse()
video.analyse()
print(video.bbbv)

See the full documentation for detailed API references.

Public API

Functions (30+): cal_all_solution, cal_bbbv, cal_board_numbers, cal_hzini, cal_op, cal_probability, cal_probability_onboard, cal_rzini, cal_zini, get_all_not_and_is_mine_on_board, is_able_to_solve, is_guess_while_needless, is_solvable, laymine, laymine_op, laymine_solvable, laymine_solvable_adjust, laymine_solvable_thread, mark_board, obr_board, refresh_board, refresh_matrix, refresh_matrixs, refresh_matrixses, sample_bbbvs_exp, solve_direct, solve_enumerate, solve_minus, unsolvable_structure, valid_time_period

Classes (15): AvfVideo, BaseVideo, Board, EvfVideo, Evfs, EvfsCell, GameBoard, KeyDynamicParams, MinesweeperBoard, MvfVideo, RmvVideo, SafeBoard, SafeBoardRow, SafeMinesweeperBoard, VideoActionStateRecorder

Supported Platforms

OS Architectures
Windows x86, x64
Linux x86, x86_64, aarch64, armv7, ppc64le, s390x
macOS x86_64, aarch64

Source & Issues

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for wangjianing from gravatar.com wangjianing

Credits

Author: Wang Jianing

Maintainer: Wang Jianing

Requires

Python >=3.7

Tags

minesweeper metasweeper probability solver 3BV

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ms_toollib-1.5.17.tar.gz (313.0 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ms_toollib-1.5.17-cp38-abi3-win_amd64.whl (2.7 MB view details)

Uploaded CPython 3.8+Windows x86-64

ms_toollib-1.5.17-cp38-abi3-win32.whl (2.3 MB view details)

Uploaded CPython 3.8+Windows x86

ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.8+musllinux: musl 1.2+ x86-64

ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_i686.whl (2.9 MB view details)

Uploaded CPython 3.8+musllinux: musl 1.2+ i686

ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_aarch64.whl (3.3 MB view details)

Uploaded CPython 3.8+musllinux: musl 1.2+ ARM64

ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.2 MB view details)

Uploaded CPython 3.8+manylinux: glibc 2.17+ x86-64

ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.2 MB view details)

Uploaded CPython 3.8+manylinux: glibc 2.17+ ARM64

ms_toollib-1.5.17-cp38-abi3-manylinux_2_12_i686.manylinux2010_i686.whl (2.9 MB view details)

Uploaded CPython 3.8+manylinux: glibc 2.12+ i686

ms_toollib-1.5.17-cp38-abi3-macosx_11_0_arm64.whl (2.6 MB view details)

Uploaded CPython 3.8+macOS 11.0+ ARM64

ms_toollib-1.5.17-cp38-abi3-macosx_10_12_x86_64.whl (2.7 MB view details)

Uploaded CPython 3.8+macOS 10.12+ x86-64

File details

Details for the file ms_toollib-1.5.17.tar.gz.

File metadata

  • Download URL: ms_toollib-1.5.17.tar.gz
  • Upload date:
  • Size: 313.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17.tar.gz
Algorithm Hash digest
SHA256 e6239cbf9ddb5d7c210a0f78fe744e76cf11c35d3771cb163b44ebf79d3fa9c8
MD5 d695aebe2d09d6ccc750ac9eb165f240
BLAKE2b-256 d81169e6270de16ad90709ccc71197c0d8a00f4fe8bdfcad4c5fc17f46675d34

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-win_amd64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-win_amd64.whl
  • Upload date:
  • Size: 2.7 MB
  • Tags: CPython 3.8+, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 419f8922d04cfb408da1674bcdcc1f48ebe9379a63d049ee9263954ad670d1c7
MD5 e3a651f45a0f956a25ba8f147382ef4c
BLAKE2b-256 88231c1ab47561d263d25341112038fdec85f2c698a80e1f9dd4ef81ec6db86b

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-win32.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-win32.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: CPython 3.8+, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-win32.whl
Algorithm Hash digest
SHA256 ba9a07f015d4bfa13101f2fc12941b9b59349d378bbd6b51a6e6fd6e2458c74f
MD5 f06d707ddd424d042985537050d6b286
BLAKE2b-256 805fa1b590db3f64036afe902d3ee9807435a2622aa96d1ec37070b1e2d29f32

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_x86_64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_x86_64.whl
  • Upload date:
  • Size: 3.4 MB
  • Tags: CPython 3.8+, musllinux: musl 1.2+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 a69311a416b026c303099b8018abf6d2626aed98ae04f1011390b0493352c06e
MD5 22cb9e260df462eae0f6abdd4df9e80b
BLAKE2b-256 d8aa5e40950896590bd0b4e75c89e5311a7059f4e7a22ec19bcd40d0c57e13a9

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_i686.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_i686.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: CPython 3.8+, musllinux: musl 1.2+ i686
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_i686.whl
Algorithm Hash digest
SHA256 857c2723b692ed39ba844dfefcb91cd3ec4f7c89c2563e77644cf4ecd928acbe
MD5 46f8c8ebfb7e527531e3fbbab677e9da
BLAKE2b-256 8441be1d92c6fdbe8029b14c4e784144399182f1dce3c39dc6af910b038caf57

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_aarch64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_aarch64.whl
  • Upload date:
  • Size: 3.3 MB
  • Tags: CPython 3.8+, musllinux: musl 1.2+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 82ea7b82a787bb63bb5d310bef13a40cf97c1a51a5e609f0ab224faa359f762b
MD5 595d303ba78b10754fded058db74023e
BLAKE2b-256 8158a3a3920265828784e09b762f11b252464019cb830d2b077a5104260bb147

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
  • Upload date:
  • Size: 3.2 MB
  • Tags: CPython 3.8+, manylinux: glibc 2.17+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 57b573e7e040719dad28c7c2b1d767fc9e394c8170839fd3d891077380146fd3
MD5 163faf4e084c3de8b7e8fa9861351b36
BLAKE2b-256 3947c15a17616e56ea4171321bcbab0d7cb8f3cfebe36523748dfd70de776784

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
  • Upload date:
  • Size: 3.2 MB
  • Tags: CPython 3.8+, manylinux: glibc 2.17+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 95763c072c1739546612eda936292ddf28fd5549f1861186bfb75280d5671838
MD5 821ac2f551b147bb624e26500a108f75
BLAKE2b-256 ef28ecd30fc4c57f1d187f4a532f31b572244bba49be0981790576b9e880dd6c

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-manylinux_2_12_i686.manylinux2010_i686.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-manylinux_2_12_i686.manylinux2010_i686.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: CPython 3.8+, manylinux: glibc 2.12+ i686
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-manylinux_2_12_i686.manylinux2010_i686.whl
Algorithm Hash digest
SHA256 a58831e3046062f0427e8ba86e40b6621dff64f2e1c79368045e38a302c26aa4
MD5 ee1acad24dcf791fd9a8dbb7d389b309
BLAKE2b-256 20766e0f453bafcca736002e70ed176e620d2c16e639e7379f8e017a0f7efe33

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 2.6 MB
  • Tags: CPython 3.8+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8f14b61d64c5bde1ff6351e65e43695cf4115e0513e069907d2ff93bccdb13d0
MD5 75f25442aab76646e8d4d40fb816b230
BLAKE2b-256 f37b5d8f1a94d3f71e1679981be3571d281bc3c6bcc9800b36a6f5b8fac0ba98

See more details on using hashes here.

File details

Details for the file ms_toollib-1.5.17-cp38-abi3-macosx_10_12_x86_64.whl.

File metadata

  • Download URL: ms_toollib-1.5.17-cp38-abi3-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 2.7 MB
  • Tags: CPython 3.8+, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ms_toollib-1.5.17-cp38-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 2f23a869f34befb976e50099f6b6a994d12672b89a2995592554b8a911d4dcb4
MD5 e7acf25a00fb3584c1e239093fa2c8d0
BLAKE2b-256 1437503062172fb84f82df78cd64bf94da8509efc547e40d825a52c9f375591b

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.5.17 This release

11 files

1.5.16

11 files

1.5.15

11 files

1.5.14

11 files

1.5.13

11 files

1.5.12

11 files

1.5.11

11 files

1.5.10

21 files

1.5.9

21 files

1.5.8

21 files

1.5.7

21 files

1.5.6

21 files

1.5.5

21 files

1.5.4

21 files

1.5.3

21 files

1.5.2

21 files

1.5.1

14 files

1.5.0

14 files

1.4.19

14 files

1.4.18

14 files

1.4.17

14 files

1.4.15

15 files

1.4.14

11 files

1.4.13

11 files

1.4.12

11 files

1.4.11

11 files

1.4.10

11 files

1.4.9

11 files

1.4.8

11 files

1.4.7

1 file

1.4.6

2 files

1.4.5

1 file

1.4.4

2 files

1.4.3

2 files

1.4.1

2 files

1.4.0

2 files

1.3.13

2 files

1.3.11

1 file

1.3.10

2 files

1.3.9

2 files

1.3.8

2 files

1.3.7

2 files

1.3.6

3 files

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.12

2 files

1.2.11

2 files

1.2.10

2 files

1.2.9

2 files

Pre-release

1.2.8_beta

1 file

1.2.7

1 file

1.2.2

1 file

1.2.1

1 file

1.2.0

1 file

1.1.1

1 file

1.1.0

1 file

1.0.9

1 file

1.0.6

1 file

1.0.5

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page