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:
Newer release available (1.5.17)

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.16.tar.gz (312.6 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.16-cp38-abi3-win_amd64.whl (2.7 MB view details)

Uploaded CPython 3.8+Windows x86-64

ms_toollib-1.5.16-cp38-abi3-win32.whl (2.2 MB view details)

Uploaded CPython 3.8+Windows x86

ms_toollib-1.5.16-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.16-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.16-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.16-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.16-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.16-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.16-cp38-abi3-macosx_11_0_arm64.whl (2.6 MB view details)

Uploaded CPython 3.8+macOS 11.0+ ARM64

ms_toollib-1.5.16-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.16.tar.gz.

File metadata

  • Download URL: ms_toollib-1.5.16.tar.gz
  • Upload date:
  • Size: 312.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16.tar.gz
Algorithm Hash digest
SHA256 10de0372e6739fa5983e8c78b485046d5d8e1bad8456bb03a86357490fab014c
MD5 1a25a351e9a39476f10da3709a31c1b6
BLAKE2b-256 1724fad1464ef17b8b7a91d33546c8b42fee2640df16e3e23a66436cb29f3df8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 72edc09f1a331ff855083b4f2fa194b79a501b7d620bbd3294f189b14e0c6aee
MD5 010d8d9073352c6dec96ff9c3f1c4478
BLAKE2b-256 29255826bd4a6e9b9ab2b509ad39a0990768ca8233c3fcc0b99e2034af694a89

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-cp38-abi3-win32.whl
  • Upload date:
  • Size: 2.2 MB
  • Tags: CPython 3.8+, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-win32.whl
Algorithm Hash digest
SHA256 5dffa88e3c5f2f28a263d32e143143dd488eafeea57afedbfe86780abe99726e
MD5 de583c408ada877a9f3eb3d418f91582
BLAKE2b-256 001f82c4ee9673de6fe3bc18b5af2ad7cab91c31b769542f08387e710a211483

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 34ecc447447b21b444c28425e6bdfbed4a84eadb8cfbb11c4dd3007d0c23fd76
MD5 8981a85164c17b2dcba338d350ff7c57
BLAKE2b-256 ef75c570ea8ffad72859a375356f88d4f6159aae8188c52fbf48d50142c8c7cc

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-musllinux_1_2_i686.whl
Algorithm Hash digest
SHA256 26f390a935495d784b1d1b25f3604cee6b744b591d1e72c8a3e92f16ba865836
MD5 91a2ac654a68599d59fd55bbf661d897
BLAKE2b-256 94d6c972de2a7bfad8c1e033176d7be0e1debef016eb91d30e5d2713fc910c81

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 57ddec1096a5a2bb07a3d34a36bc7f017b1d3c1a2e878281914bda5cc8069d91
MD5 e4034aa9879f50ba884e43850c4b1a8f
BLAKE2b-256 460fc63ff9ac89a78a1064bbfa158c60295775487a04f1dbf729d7af004e51f5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 df75686a67c21b2ed8a0f2eacea94b792d55ac2d1d395765a963a9a6a4d4ba67
MD5 cfd4b4b6d1f676a92f130c91d36b9bfb
BLAKE2b-256 4fb1dbb18e5934a582556ee3b3b4d4ebd42a5915349abb50a2ddae00643377b9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 92a4e4655cea9923f2002e8af60063abf18d36e53ffdb771b1e54d852fad24be
MD5 4d59d0ea6e9f5ec8a25046c43c74bccd
BLAKE2b-256 9a52b500e07a0b1d7260c265fbb914e788fe83b303338327651d83927352cba1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-manylinux_2_12_i686.manylinux2010_i686.whl
Algorithm Hash digest
SHA256 44e760f07ee1a5d318c77115862fc710b3b59db5285497b69b8efbf050b82b7e
MD5 64648207353d35c7e5b69b5e620b32d1
BLAKE2b-256 4e0e9a6fd952a1ae8a532a9fe03490e778cde6165c30ab9f5cfbc157984be4ff

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 91db773046720af34d571b8a5ddf204868a1f44bbeff559b4e1e1680e93406b0
MD5 eb70ffc76e715cda7ca34275631768bd
BLAKE2b-256 6a1d147ac6bbcf1fe4b989d69d404b91bda23d21aa29d8b36f4ffc2db59403f9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ms_toollib-1.5.16-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.11.29 {"installer":{"name":"uv","version":"0.11.29","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.16-cp38-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 949218697531ad417a2b775f3b0b73c4e4bc524577e113235db79f845924e3dd
MD5 63d4c47157109edbee15e633e9fae549
BLAKE2b-256 5f11bdc8e5721ce46fbb27056ba136899ad2dc378b210360f9bec6df73c941fd

See more details on using hashes here.

Release history Release notifications | RSS feed

1.5.17

11 files

This release

1.5.16 This release

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