fermut 0.6.0__tar.gz → 0.7.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {fermut-0.6.0 → fermut-0.7.0}/Cargo.lock +56 -119
- {fermut-0.6.0 → fermut-0.7.0}/Cargo.toml +14 -7
- {fermut-0.6.0 → fermut-0.7.0}/PKG-INFO +26 -24
- {fermut-0.6.0 → fermut-0.7.0}/README.md +25 -23
- fermut-0.7.0/plugins/fermut/skills/fermut-mutation-testing/SKILL.md +235 -0
- {fermut-0.6.0 → fermut-0.7.0}/pyproject.toml +5 -0
- {fermut-0.6.0 → fermut-0.7.0}/python/pytest_fermut/_fermut_reporter.py +78 -6
- fermut-0.7.0/python/pytest_fermut/_fermut_schema.py +976 -0
- {fermut-0.6.0 → fermut-0.7.0}/python/pytest_fermut/plugin.py +184 -25
- {fermut-0.6.0 → fermut-0.7.0}/src/ast_hash.rs +26 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cache.rs +79 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/build_config.rs +435 -24
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/merge.rs +366 -13
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/mod.rs +71 -5
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/autofix.rs +310 -37
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/baseline.rs +4 -3
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/coverage.rs +112 -31
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/doctor.rs +249 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/explain.rs +54 -30
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/hom.rs +13 -33
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/init.rs +42 -21
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/mcp.rs +61 -4
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/next.rs +1 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/show.rs +41 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/subsume.rs +4 -2
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/suggest.rs +215 -112
- {fermut-0.6.0 → fermut-0.7.0}/src/config/file.rs +40 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/config/mod.rs +65 -8
- {fermut-0.6.0 → fermut-0.7.0}/src/engine.rs +662 -36
- {fermut-0.6.0 → fermut-0.7.0}/src/equiv/bytecode.rs +0 -4
- fermut-0.7.0/src/equiv/llm.rs +505 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/equiv/mod.rs +3 -59
- {fermut-0.6.0 → fermut-0.7.0}/src/equiv/patterns.rs +0 -4
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/coverage/mod.rs +46 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/coverage/parse.rs +54 -13
- fermut-0.7.0/src/filter/coverage/select.rs +402 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/diff.rs +81 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/mod.rs +24 -2
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/profile.rs +4 -4
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/ruff.rs +85 -9
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/sample.rs +1 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/tce.rs +4 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/ty.rs +171 -3
- {fermut-0.6.0 → fermut-0.7.0}/src/history/analytics.rs +55 -9
- {fermut-0.6.0 → fermut-0.7.0}/src/history/entry.rs +1 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/history/hash.rs +95 -6
- {fermut-0.6.0 → fermut-0.7.0}/src/history/mod.rs +1 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/lib.rs +12 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/llm/client.rs +6 -1
- fermut-0.7.0/src/llm/mod.rs +138 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/llm/prompt.rs +28 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/llm/prompt_equiv.rs +75 -13
- {fermut-0.6.0 → fermut-0.7.0}/src/main.rs +10 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/mod.rs +1 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/operators.rs +19 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/visitor.rs +81 -3
- {fermut-0.6.0 → fermut-0.7.0}/src/report/annotations.rs +28 -4
- {fermut-0.6.0 → fermut-0.7.0}/src/report/fold.rs +1 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/report/mod.rs +155 -9
- {fermut-0.6.0 → fermut-0.7.0}/src/report/writers/html.rs +3 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/report/writers/markdown.rs +5 -1
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/exit.rs +191 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/kill_sets.rs +9 -9
- fermut-0.7.0/src/runner/memory.rs +521 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/mod.rs +720 -49
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/process_group.rs +19 -10
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/pytest.rs +655 -119
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/pytest_result.rs +123 -18
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/python.rs +127 -0
- fermut-0.7.0/src/runner/schema.rs +1498 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/runner/unittest.rs +136 -47
- {fermut-0.6.0 → fermut-0.7.0}/src/subsume/mod.rs +2 -3
- {fermut-0.6.0 → fermut-0.7.0}/src/test_tree.rs +14 -2
- fermut-0.7.0/src/util/mod.rs +84 -0
- fermut-0.6.0/plugins/fermut/skills/fermut-mutation-testing/SKILL.md +0 -404
- fermut-0.6.0/src/equiv/llm.rs +0 -332
- fermut-0.6.0/src/equiv/probe.rs +0 -400
- fermut-0.6.0/src/equiv/script_probe.py +0 -246
- fermut-0.6.0/src/llm/mod.rs +0 -45
- fermut-0.6.0/src/util/mod.rs +0 -3
- {fermut-0.6.0 → fermut-0.7.0}/LICENSE-APACHE +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/LICENSE-MIT +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/examples/github-actions/pr-gate.yml +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/python/fermut/__init__.py +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/python/pytest_fermut/__init__.py +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/clean.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/completions.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/dashboard.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/install_skills.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/list.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/migrate.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/mod.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/pr_comment.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/run.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/score.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/cli/subcmd/trend.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/config/loader.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/emit.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/equiv/script.py +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/coverage/order.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/experimental.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/operator.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/parity.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/shard.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/filter/ty_embedded.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/history/io.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/history/paths.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/history/render.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/kill_order.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/llm/cache.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/llm/redact.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/encoding.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/ignore.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/lexeme.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/loader.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/region.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/mutator/text_range_serde.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/report/diff.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/report/writers/json.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/report/writers/junit.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/report/writers/mod.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/sync.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/util/search.rs +0 -0
- {fermut-0.6.0 → fermut-0.7.0}/src/watch.rs +0 -0
|
@@ -523,9 +523,9 @@ dependencies = [
|
|
|
523
523
|
|
|
524
524
|
[[package]]
|
|
525
525
|
name = "ctutils"
|
|
526
|
-
version = "0.4.
|
|
526
|
+
version = "0.4.3"
|
|
527
527
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
528
|
-
checksum = "
|
|
528
|
+
checksum = "03bb0e1cc970d482d121d9a1744999169b69a07470b3d644a7894e53fcaf4574"
|
|
529
529
|
dependencies = [
|
|
530
530
|
"cmov",
|
|
531
531
|
]
|
|
@@ -679,7 +679,7 @@ checksum = "da7c62ceae207dd37ea5b845da6a0696c799f85e97da1ab5b7910be3c1c80223"
|
|
|
679
679
|
|
|
680
680
|
[[package]]
|
|
681
681
|
name = "fermut"
|
|
682
|
-
version = "0.
|
|
682
|
+
version = "0.7.0"
|
|
683
683
|
dependencies = [
|
|
684
684
|
"anyhow",
|
|
685
685
|
"assert_cmd",
|
|
@@ -779,15 +779,6 @@ version = "1.3.0"
|
|
|
779
779
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
780
780
|
checksum = "42703706b716c37f96a77aea830392ad231f44c9e9a67872fa5548707e11b11c"
|
|
781
781
|
|
|
782
|
-
[[package]]
|
|
783
|
-
name = "fsevent-sys"
|
|
784
|
-
version = "4.1.0"
|
|
785
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
786
|
-
checksum = "76ee7a02da4d231650c7cea31349b889be2f45ddb3ef3032d2ec8185f6313fd2"
|
|
787
|
-
dependencies = [
|
|
788
|
-
"libc",
|
|
789
|
-
]
|
|
790
|
-
|
|
791
782
|
[[package]]
|
|
792
783
|
name = "funty"
|
|
793
784
|
version = "2.0.0"
|
|
@@ -875,9 +866,9 @@ checksum = "e4eba85ea1d0a966a983acd07deee566e67395d2d96b6fb39e62b5a833f1eb0b"
|
|
|
875
866
|
|
|
876
867
|
[[package]]
|
|
877
868
|
name = "globset"
|
|
878
|
-
version = "0.4.
|
|
869
|
+
version = "0.4.21"
|
|
879
870
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
880
|
-
checksum = "
|
|
871
|
+
checksum = "f98b0d85522dc0a824cfebbc9594ff4a9b289c568bea0370319dfbdf20ccdd2d"
|
|
881
872
|
dependencies = [
|
|
882
873
|
"aho-corasick",
|
|
883
874
|
"bstr",
|
|
@@ -1073,9 +1064,9 @@ dependencies = [
|
|
|
1073
1064
|
|
|
1074
1065
|
[[package]]
|
|
1075
1066
|
name = "ignore"
|
|
1076
|
-
version = "0.4.
|
|
1067
|
+
version = "0.4.34"
|
|
1077
1068
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
1078
|
-
checksum = "
|
|
1069
|
+
checksum = "484be5657551d7868d67587df967fb4fcbe9d266a761cc855aaa148fda0b3cc7"
|
|
1079
1070
|
dependencies = [
|
|
1080
1071
|
"crossbeam-deque",
|
|
1081
1072
|
"globset",
|
|
@@ -1250,9 +1241,9 @@ dependencies = [
|
|
|
1250
1241
|
|
|
1251
1242
|
[[package]]
|
|
1252
1243
|
name = "libsqlite3-sys"
|
|
1253
|
-
version = "0.
|
|
1244
|
+
version = "0.39.1"
|
|
1254
1245
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
1255
|
-
checksum = "
|
|
1246
|
+
checksum = "14a5f01b87b92705d07b433c06f96cbc764637d81a0bffb5734ce17cf0f9a2b3"
|
|
1256
1247
|
dependencies = [
|
|
1257
1248
|
"cc",
|
|
1258
1249
|
"pkg-config",
|
|
@@ -1356,20 +1347,21 @@ checksum = "61807f77802ff30975e01f4f071c8ba10c022052f98b3294119f3e615d13e5be"
|
|
|
1356
1347
|
|
|
1357
1348
|
[[package]]
|
|
1358
1349
|
name = "notify"
|
|
1359
|
-
version = "8.2.
|
|
1350
|
+
version = "8.2.1"
|
|
1360
1351
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
1361
|
-
checksum = "
|
|
1352
|
+
checksum = "82f812702fbc75d35416d3f884e04925be7e9498f4eceea2e24ba34559284674"
|
|
1362
1353
|
dependencies = [
|
|
1363
1354
|
"bitflags",
|
|
1364
|
-
"fsevent-sys",
|
|
1365
1355
|
"inotify",
|
|
1366
1356
|
"kqueue",
|
|
1367
1357
|
"libc",
|
|
1368
1358
|
"log",
|
|
1369
1359
|
"mio",
|
|
1370
1360
|
"notify-types",
|
|
1361
|
+
"objc2-core-foundation",
|
|
1362
|
+
"objc2-core-services",
|
|
1371
1363
|
"walkdir",
|
|
1372
|
-
"windows-sys 0.
|
|
1364
|
+
"windows-sys 0.61.2",
|
|
1373
1365
|
]
|
|
1374
1366
|
|
|
1375
1367
|
[[package]]
|
|
@@ -1405,6 +1397,25 @@ dependencies = [
|
|
|
1405
1397
|
"autocfg",
|
|
1406
1398
|
]
|
|
1407
1399
|
|
|
1400
|
+
[[package]]
|
|
1401
|
+
name = "objc2-core-foundation"
|
|
1402
|
+
version = "0.3.2"
|
|
1403
|
+
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
1404
|
+
checksum = "2a180dd8642fa45cdb7dd721cd4c11b1cadd4929ce112ebd8b9f5803cc79d536"
|
|
1405
|
+
dependencies = [
|
|
1406
|
+
"bitflags",
|
|
1407
|
+
]
|
|
1408
|
+
|
|
1409
|
+
[[package]]
|
|
1410
|
+
name = "objc2-core-services"
|
|
1411
|
+
version = "0.3.2"
|
|
1412
|
+
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
1413
|
+
checksum = "583300ad934cba24ff5292aee751ecc070f7ca6b39a574cc21b7b5e588e06a0b"
|
|
1414
|
+
dependencies = [
|
|
1415
|
+
"libc",
|
|
1416
|
+
"objc2-core-foundation",
|
|
1417
|
+
]
|
|
1418
|
+
|
|
1408
1419
|
[[package]]
|
|
1409
1420
|
name = "object"
|
|
1410
1421
|
version = "0.39.1"
|
|
@@ -2109,9 +2120,9 @@ dependencies = [
|
|
|
2109
2120
|
|
|
2110
2121
|
[[package]]
|
|
2111
2122
|
name = "rusqlite"
|
|
2112
|
-
version = "0.
|
|
2123
|
+
version = "0.41.1"
|
|
2113
2124
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
2114
|
-
checksum = "
|
|
2125
|
+
checksum = "da9bba6f3506135e120a6586df05be18b48d18896600646a4bec8f993d91a594"
|
|
2115
2126
|
dependencies = [
|
|
2116
2127
|
"bitflags",
|
|
2117
2128
|
"fallible-iterator",
|
|
@@ -2168,9 +2179,9 @@ dependencies = [
|
|
|
2168
2179
|
|
|
2169
2180
|
[[package]]
|
|
2170
2181
|
name = "rustls-webpki"
|
|
2171
|
-
version = "0.103.
|
|
2182
|
+
version = "0.103.16"
|
|
2172
2183
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
2173
|
-
checksum = "
|
|
2184
|
+
checksum = "4443b1b6d39d7c663139942cc4558262562d2c84123bb6282ef177009ca8b281"
|
|
2174
2185
|
dependencies = [
|
|
2175
2186
|
"aws-lc-rs",
|
|
2176
2187
|
"ring",
|
|
@@ -2344,9 +2355,9 @@ checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
|
|
|
2344
2355
|
|
|
2345
2356
|
[[package]]
|
|
2346
2357
|
name = "similar"
|
|
2347
|
-
version = "3.2.
|
|
2358
|
+
version = "3.2.1"
|
|
2348
2359
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
2349
|
-
checksum = "
|
|
2360
|
+
checksum = "d2f8bec09ae8fae0f4f265a4559a9334be3929d8504e9b536df0a41302bd1733"
|
|
2350
2361
|
dependencies = [
|
|
2351
2362
|
"bstr",
|
|
2352
2363
|
]
|
|
@@ -2956,9 +2967,9 @@ checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
|
|
|
2956
2967
|
|
|
2957
2968
|
[[package]]
|
|
2958
2969
|
name = "ureq"
|
|
2959
|
-
version = "3.
|
|
2970
|
+
version = "3.5.0"
|
|
2960
2971
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
2961
|
-
checksum = "
|
|
2972
|
+
checksum = "cde93ff05758a36a851a398a772b0b79a82fbe3c186a46f2696baaeaf84c966b"
|
|
2962
2973
|
dependencies = [
|
|
2963
2974
|
"base64",
|
|
2964
2975
|
"cookie_store",
|
|
@@ -2975,9 +2986,9 @@ dependencies = [
|
|
|
2975
2986
|
|
|
2976
2987
|
[[package]]
|
|
2977
2988
|
name = "ureq-proto"
|
|
2978
|
-
version = "0.6.
|
|
2989
|
+
version = "0.6.5"
|
|
2979
2990
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
2980
|
-
checksum = "
|
|
2991
|
+
checksum = "841583fc36089d7d59419568ae157f43a5a03a2e5a81ba87c77d1596ef46e922"
|
|
2981
2992
|
dependencies = [
|
|
2982
2993
|
"base64",
|
|
2983
2994
|
"http",
|
|
@@ -3134,9 +3145,9 @@ dependencies = [
|
|
|
3134
3145
|
|
|
3135
3146
|
[[package]]
|
|
3136
3147
|
name = "webpki-roots"
|
|
3137
|
-
version = "1.0.
|
|
3148
|
+
version = "1.0.10"
|
|
3138
3149
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3139
|
-
checksum = "
|
|
3150
|
+
checksum = "1c1c8e20c8a38fc7d65abfe74eb7280e4aa667e8eec8bc84996d2874810748d9"
|
|
3140
3151
|
dependencies = [
|
|
3141
3152
|
"rustls-pki-types",
|
|
3142
3153
|
]
|
|
@@ -3288,16 +3299,7 @@ version = "0.52.0"
|
|
|
3288
3299
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3289
3300
|
checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
|
|
3290
3301
|
dependencies = [
|
|
3291
|
-
"windows-targets
|
|
3292
|
-
]
|
|
3293
|
-
|
|
3294
|
-
[[package]]
|
|
3295
|
-
name = "windows-sys"
|
|
3296
|
-
version = "0.60.2"
|
|
3297
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3298
|
-
checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb"
|
|
3299
|
-
dependencies = [
|
|
3300
|
-
"windows-targets 0.53.5",
|
|
3302
|
+
"windows-targets",
|
|
3301
3303
|
]
|
|
3302
3304
|
|
|
3303
3305
|
[[package]]
|
|
@@ -3315,31 +3317,14 @@ version = "0.52.6"
|
|
|
3315
3317
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3316
3318
|
checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
|
|
3317
3319
|
dependencies = [
|
|
3318
|
-
"windows_aarch64_gnullvm
|
|
3319
|
-
"windows_aarch64_msvc
|
|
3320
|
-
"windows_i686_gnu
|
|
3321
|
-
"windows_i686_gnullvm
|
|
3322
|
-
"windows_i686_msvc
|
|
3323
|
-
"windows_x86_64_gnu
|
|
3324
|
-
"windows_x86_64_gnullvm
|
|
3325
|
-
"windows_x86_64_msvc
|
|
3326
|
-
]
|
|
3327
|
-
|
|
3328
|
-
[[package]]
|
|
3329
|
-
name = "windows-targets"
|
|
3330
|
-
version = "0.53.5"
|
|
3331
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3332
|
-
checksum = "4945f9f551b88e0d65f3db0bc25c33b8acea4d9e41163edf90dcd0b19f9069f3"
|
|
3333
|
-
dependencies = [
|
|
3334
|
-
"windows-link",
|
|
3335
|
-
"windows_aarch64_gnullvm 0.53.1",
|
|
3336
|
-
"windows_aarch64_msvc 0.53.1",
|
|
3337
|
-
"windows_i686_gnu 0.53.1",
|
|
3338
|
-
"windows_i686_gnullvm 0.53.1",
|
|
3339
|
-
"windows_i686_msvc 0.53.1",
|
|
3340
|
-
"windows_x86_64_gnu 0.53.1",
|
|
3341
|
-
"windows_x86_64_gnullvm 0.53.1",
|
|
3342
|
-
"windows_x86_64_msvc 0.53.1",
|
|
3320
|
+
"windows_aarch64_gnullvm",
|
|
3321
|
+
"windows_aarch64_msvc",
|
|
3322
|
+
"windows_i686_gnu",
|
|
3323
|
+
"windows_i686_gnullvm",
|
|
3324
|
+
"windows_i686_msvc",
|
|
3325
|
+
"windows_x86_64_gnu",
|
|
3326
|
+
"windows_x86_64_gnullvm",
|
|
3327
|
+
"windows_x86_64_msvc",
|
|
3343
3328
|
]
|
|
3344
3329
|
|
|
3345
3330
|
[[package]]
|
|
@@ -3357,96 +3342,48 @@ version = "0.52.6"
|
|
|
3357
3342
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3358
3343
|
checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
|
|
3359
3344
|
|
|
3360
|
-
[[package]]
|
|
3361
|
-
name = "windows_aarch64_gnullvm"
|
|
3362
|
-
version = "0.53.1"
|
|
3363
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3364
|
-
checksum = "a9d8416fa8b42f5c947f8482c43e7d89e73a173cead56d044f6a56104a6d1b53"
|
|
3365
|
-
|
|
3366
3345
|
[[package]]
|
|
3367
3346
|
name = "windows_aarch64_msvc"
|
|
3368
3347
|
version = "0.52.6"
|
|
3369
3348
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3370
3349
|
checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
|
|
3371
3350
|
|
|
3372
|
-
[[package]]
|
|
3373
|
-
name = "windows_aarch64_msvc"
|
|
3374
|
-
version = "0.53.1"
|
|
3375
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3376
|
-
checksum = "b9d782e804c2f632e395708e99a94275910eb9100b2114651e04744e9b125006"
|
|
3377
|
-
|
|
3378
3351
|
[[package]]
|
|
3379
3352
|
name = "windows_i686_gnu"
|
|
3380
3353
|
version = "0.52.6"
|
|
3381
3354
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3382
3355
|
checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
|
|
3383
3356
|
|
|
3384
|
-
[[package]]
|
|
3385
|
-
name = "windows_i686_gnu"
|
|
3386
|
-
version = "0.53.1"
|
|
3387
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3388
|
-
checksum = "960e6da069d81e09becb0ca57a65220ddff016ff2d6af6a223cf372a506593a3"
|
|
3389
|
-
|
|
3390
3357
|
[[package]]
|
|
3391
3358
|
name = "windows_i686_gnullvm"
|
|
3392
3359
|
version = "0.52.6"
|
|
3393
3360
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3394
3361
|
checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
|
|
3395
3362
|
|
|
3396
|
-
[[package]]
|
|
3397
|
-
name = "windows_i686_gnullvm"
|
|
3398
|
-
version = "0.53.1"
|
|
3399
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3400
|
-
checksum = "fa7359d10048f68ab8b09fa71c3daccfb0e9b559aed648a8f95469c27057180c"
|
|
3401
|
-
|
|
3402
3363
|
[[package]]
|
|
3403
3364
|
name = "windows_i686_msvc"
|
|
3404
3365
|
version = "0.52.6"
|
|
3405
3366
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3406
3367
|
checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
|
|
3407
3368
|
|
|
3408
|
-
[[package]]
|
|
3409
|
-
name = "windows_i686_msvc"
|
|
3410
|
-
version = "0.53.1"
|
|
3411
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3412
|
-
checksum = "1e7ac75179f18232fe9c285163565a57ef8d3c89254a30685b57d83a38d326c2"
|
|
3413
|
-
|
|
3414
3369
|
[[package]]
|
|
3415
3370
|
name = "windows_x86_64_gnu"
|
|
3416
3371
|
version = "0.52.6"
|
|
3417
3372
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3418
3373
|
checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
|
|
3419
3374
|
|
|
3420
|
-
[[package]]
|
|
3421
|
-
name = "windows_x86_64_gnu"
|
|
3422
|
-
version = "0.53.1"
|
|
3423
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3424
|
-
checksum = "9c3842cdd74a865a8066ab39c8a7a473c0778a3f29370b5fd6b4b9aa7df4a499"
|
|
3425
|
-
|
|
3426
3375
|
[[package]]
|
|
3427
3376
|
name = "windows_x86_64_gnullvm"
|
|
3428
3377
|
version = "0.52.6"
|
|
3429
3378
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3430
3379
|
checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
|
|
3431
3380
|
|
|
3432
|
-
[[package]]
|
|
3433
|
-
name = "windows_x86_64_gnullvm"
|
|
3434
|
-
version = "0.53.1"
|
|
3435
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3436
|
-
checksum = "0ffa179e2d07eee8ad8f57493436566c7cc30ac536a3379fdf008f47f6bb7ae1"
|
|
3437
|
-
|
|
3438
3381
|
[[package]]
|
|
3439
3382
|
name = "windows_x86_64_msvc"
|
|
3440
3383
|
version = "0.52.6"
|
|
3441
3384
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3442
3385
|
checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
|
|
3443
3386
|
|
|
3444
|
-
[[package]]
|
|
3445
|
-
name = "windows_x86_64_msvc"
|
|
3446
|
-
version = "0.53.1"
|
|
3447
|
-
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3448
|
-
checksum = "d6bbff5f0aada427a1e5a6da5f1f98158182f26556f345ac9e04d36d0ebed650"
|
|
3449
|
-
|
|
3450
3387
|
[[package]]
|
|
3451
3388
|
name = "winnow"
|
|
3452
3389
|
version = "1.0.4"
|
|
@@ -3590,9 +3527,9 @@ dependencies = [
|
|
|
3590
3527
|
|
|
3591
3528
|
[[package]]
|
|
3592
3529
|
name = "zstd-sys"
|
|
3593
|
-
version = "2.1.
|
|
3530
|
+
version = "2.1.2+zstd.1.5.7"
|
|
3594
3531
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
|
3595
|
-
checksum = "
|
|
3532
|
+
checksum = "481ada9c543b2323cbb7bbdbb5249177fbf0188ed959ed2c15e4b22421c84ed3"
|
|
3596
3533
|
dependencies = [
|
|
3597
3534
|
"cc",
|
|
3598
3535
|
"pkg-config",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[package]
|
|
2
2
|
name = "fermut"
|
|
3
|
-
version = "0.
|
|
3
|
+
version = "0.7.0"
|
|
4
4
|
edition = "2021"
|
|
5
5
|
rust-version = "1.83"
|
|
6
6
|
authors = ["Kovant AB"]
|
|
@@ -34,7 +34,7 @@ path = "src/lib.rs"
|
|
|
34
34
|
|
|
35
35
|
[dependencies]
|
|
36
36
|
anyhow = "1"
|
|
37
|
-
clap = { version = "4", features = ["derive"] }
|
|
37
|
+
clap = { version = "4", features = ["derive", "env"] }
|
|
38
38
|
clap_complete = "4"
|
|
39
39
|
fs2 = "0.4"
|
|
40
40
|
globset = "0.4"
|
|
@@ -67,7 +67,7 @@ which = "8"
|
|
|
67
67
|
# The tests/deps_hygiene.rs guard fails if this set drifts back to defaults.
|
|
68
68
|
ureq = { version = "3", default-features = false, features = ["rustls", "json"] }
|
|
69
69
|
regex = "1"
|
|
70
|
-
rusqlite = { version = "0.
|
|
70
|
+
rusqlite = { version = "0.41", features = ["bundled"] }
|
|
71
71
|
|
|
72
72
|
# Astral parser + AST + text-range crates. Pinned to a ruff release tag.
|
|
73
73
|
# Bump the tag together to keep API consistency. Verify the tag exists at
|
|
@@ -97,7 +97,13 @@ embedded-ty = ["dep:ruff_db", "dep:ruff_notebook", "dep:ty_project", "dep:ty_pyt
|
|
|
97
97
|
libc = "0.2"
|
|
98
98
|
|
|
99
99
|
[target.'cfg(windows)'.dependencies]
|
|
100
|
-
windows-sys = { version = "0.61", features = [
|
|
100
|
+
windows-sys = { version = "0.61", features = [
|
|
101
|
+
"Win32_System_Console",
|
|
102
|
+
"Win32_Foundation",
|
|
103
|
+
"Win32_System_JobObjects",
|
|
104
|
+
"Win32_System_Threading",
|
|
105
|
+
"Win32_Security",
|
|
106
|
+
] }
|
|
101
107
|
|
|
102
108
|
[dev-dependencies]
|
|
103
109
|
assert_cmd = "2"
|
|
@@ -115,9 +121,10 @@ rustls = "0.23"
|
|
|
115
121
|
# rather than blanket `clippy::pedantic`, which currently fires ~40 lints
|
|
116
122
|
# (mostly `cast_possible_truncation`) — tighten toward pedantic incrementally.
|
|
117
123
|
[lints.rust]
|
|
118
|
-
# No new `unsafe` without an explicit, reviewed opt-in.
|
|
119
|
-
# (process
|
|
120
|
-
#
|
|
124
|
+
# No new `unsafe` without an explicit, reviewed opt-in. Each FFI site
|
|
125
|
+
# (process groups in `runner/process_group.rs`, memory caps in
|
|
126
|
+
# `runner/memory.rs`, the MCP stdout guard in `cli/subcmd/mcp.rs`) carries a
|
|
127
|
+
# scoped `#[allow(unsafe_code)]` with a SAFETY note.
|
|
121
128
|
unsafe_code = "deny"
|
|
122
129
|
|
|
123
130
|
[lints.clippy]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: fermut
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.7.0
|
|
4
4
|
Classifier: Development Status :: 3 - Alpha
|
|
5
5
|
Classifier: Intended Audience :: Developers
|
|
6
6
|
Classifier: Operating System :: POSIX :: Linux
|
|
@@ -38,6 +38,7 @@ _Line coverage tells you which lines run. fermut tells you which lines your test
|
|
|
38
38
|
|
|
39
39
|
[](https://github.com/KovantAI/fermut/actions/workflows/ci.yml)
|
|
40
40
|
[](https://codecov.io/gh/KovantAI/fermut)
|
|
41
|
+
[](https://github.com/KovantAI/fermut/actions/workflows/mutation.yml)
|
|
41
42
|
[](https://scorecard.dev/viewer/?uri=github.com/KovantAI/fermut)
|
|
42
43
|
[](https://pypi.org/project/fermut/)
|
|
43
44
|
[](https://pepy.tech/project/fermut)
|
|
@@ -51,8 +52,8 @@ _Line coverage tells you which lines run. fermut tells you which lines your test
|
|
|
51
52
|
```text
|
|
52
53
|
$ fermut run src/ --tests tests/
|
|
53
54
|
|
|
54
|
-
SURVIVED src/auth.py:42 [boundary-shift] `age >= 18` → `age > 18`
|
|
55
|
-
TIMEOUT src/slow.py:88 [arith-op-swap]
|
|
55
|
+
SURVIVED src/auth.py:42@1187 [boundary-shift] `age >= 18` → `age > 18`
|
|
56
|
+
TIMEOUT src/slow.py:88@2304 [arith-op-swap] `n * 2` → `n / 2`
|
|
56
57
|
|
|
57
58
|
152 mutants — killed: 140, survived: 8, timeout: 1, skipped: 3 (coverage 3), equivalent: 0, errored: 0 | score: 94.6%
|
|
58
59
|
```
|
|
@@ -64,11 +65,14 @@ slipped through. In short — it answers **"are my tests any good?"**
|
|
|
64
65
|
|
|
65
66
|
- ⚡ **Fast** — native-Rust hot loop, `ty` pre-filter drops type-invalid
|
|
66
67
|
mutants before they ever reach pytest, per-test coverage selection runs
|
|
67
|
-
only the tests that touch each mutant
|
|
68
|
+
only the tests that touch each mutant, and mutants run in forks of one
|
|
69
|
+
pytest that already imported your suite (schemata).
|
|
68
70
|
- 🤖 **Agent-first** — machine-readable JSON reports, deterministic mutant
|
|
69
71
|
IDs, `next`/`explain`/`score` subcommands built for a coding agent in the loop.
|
|
70
|
-
- 🔁 **Incremental** —
|
|
71
|
-
|
|
72
|
+
- 🔁 **Incremental** — an unchanged re-run is answered from the cache
|
|
73
|
+
(pyjwt: ~38s cold, ~0.3s warm, measured together after the
|
|
74
|
+
[benchmark table](https://fermut.readthedocs.io/reference/benchmarks/#warm-and-loop-runs-the-incremental-story)), and `--diff-only` scopes mutation to
|
|
75
|
+
lines changed vs `main`.
|
|
72
76
|
- 🚦 **CI-ready** — non-zero exit when any mutant survives (or, with
|
|
73
77
|
`--fail-under`, when the score drops below a threshold), wire it straight
|
|
74
78
|
into a pull-request gate.
|
|
@@ -85,15 +89,12 @@ type-awareness. Humans welcome too.
|
|
|
85
89
|
uv tool install fermut # prebuilt wheel from PyPI, no Rust needed
|
|
86
90
|
cargo install --git https://github.com/KovantAI/fermut --locked # from source: needs Rust + ~2 min first compile
|
|
87
91
|
|
|
88
|
-
# in your project (needs pytest, coverage, pytest-cov
|
|
92
|
+
# in your project (needs pytest, coverage, pytest-cov on the same PATH; ty is embedded — see Installation)
|
|
89
93
|
fermut init # detect source/tests/runner, write fermut.toml
|
|
90
|
-
|
|
91
|
-
#
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
# (or, manually: coverage json -o coverage.json --show-contexts, then --coverage coverage.json)
|
|
95
|
-
|
|
96
|
-
fermut run src/ --tests tests/ # first mutation report (add -q to silence progress logs)
|
|
94
|
+
fermut baseline # where you stand: checks the env, builds .coverage,
|
|
95
|
+
# line coverage vs a sampled mutation score + worst files
|
|
96
|
+
fermut run src/ --tests tests/ # full mutation report (add -q to silence progress logs)
|
|
97
|
+
fermut next # the survivor worth a test first
|
|
97
98
|
```
|
|
98
99
|
|
|
99
100
|
For a CI gate, generate the opinionated profile instead — diff-only +
|
|
@@ -116,18 +117,19 @@ checkout with that base available — see
|
|
|
116
117
|
|
|
117
118
|
## Why fermut
|
|
118
119
|
|
|
119
|
-
On **typer** (
|
|
120
|
+
On **typer** (cold run, same machine, 2026-11-03):
|
|
120
121
|
|
|
121
122
|
| Tool | Time | Mutation score |
|
|
122
123
|
|--------|-------|----------------|
|
|
123
|
-
| fermut |
|
|
124
|
-
| mutmut |
|
|
125
|
-
|
|
126
|
-
fermut is **faster
|
|
127
|
-
and
|
|
128
|
-
rigor. The win is suite-shaped: on
|
|
129
|
-
|
|
130
|
-
wins
|
|
124
|
+
| fermut | 211s | 69.2% |
|
|
125
|
+
| mutmut | 289s | 70.4% |
|
|
126
|
+
|
|
127
|
+
fermut is **faster at a similar score** here: per-test coverage selection
|
|
128
|
+
and a fork server that collects the suite once (schemata) cut wall-clock
|
|
129
|
+
without dropping rigor. The win is suite-shaped: on more-itertools the two
|
|
130
|
+
tie (~123s vs ~119s), and on a tiny suite like markupsafe mutmut's simpler
|
|
131
|
+
model still wins (~9s vs ~15s). On the larger suites fermut finishes
|
|
132
|
+
werkzeug (41k generated mutants, 8k run) in under 3 minutes. Full numbers and methodology:
|
|
131
133
|
**[benchmarks](docs/reference/benchmarks.md)**.
|
|
132
134
|
|
|
133
135
|
## Documentation
|
|
@@ -146,7 +148,7 @@ Start here:
|
|
|
146
148
|
then `fermut run`, first report in under five minutes.
|
|
147
149
|
- **[Installation](docs/getting-started/installation.md)** — prerequisites
|
|
148
150
|
and build paths.
|
|
149
|
-
- **[
|
|
151
|
+
- **[Rolling out to a team](docs/guides/projects.md)** — gradual rollout,
|
|
150
152
|
profile choice, CI integration.
|
|
151
153
|
- **[CLI reference](docs/reference/cli/index.md)** — every subcommand,
|
|
152
154
|
every flag.
|
|
@@ -8,6 +8,7 @@ _Line coverage tells you which lines run. fermut tells you which lines your test
|
|
|
8
8
|
|
|
9
9
|
[](https://github.com/KovantAI/fermut/actions/workflows/ci.yml)
|
|
10
10
|
[](https://codecov.io/gh/KovantAI/fermut)
|
|
11
|
+
[](https://github.com/KovantAI/fermut/actions/workflows/mutation.yml)
|
|
11
12
|
[](https://scorecard.dev/viewer/?uri=github.com/KovantAI/fermut)
|
|
12
13
|
[](https://pypi.org/project/fermut/)
|
|
13
14
|
[](https://pepy.tech/project/fermut)
|
|
@@ -21,8 +22,8 @@ _Line coverage tells you which lines run. fermut tells you which lines your test
|
|
|
21
22
|
```text
|
|
22
23
|
$ fermut run src/ --tests tests/
|
|
23
24
|
|
|
24
|
-
SURVIVED src/auth.py:42 [boundary-shift] `age >= 18` → `age > 18`
|
|
25
|
-
TIMEOUT src/slow.py:88 [arith-op-swap]
|
|
25
|
+
SURVIVED src/auth.py:42@1187 [boundary-shift] `age >= 18` → `age > 18`
|
|
26
|
+
TIMEOUT src/slow.py:88@2304 [arith-op-swap] `n * 2` → `n / 2`
|
|
26
27
|
|
|
27
28
|
152 mutants — killed: 140, survived: 8, timeout: 1, skipped: 3 (coverage 3), equivalent: 0, errored: 0 | score: 94.6%
|
|
28
29
|
```
|
|
@@ -34,11 +35,14 @@ slipped through. In short — it answers **"are my tests any good?"**
|
|
|
34
35
|
|
|
35
36
|
- ⚡ **Fast** — native-Rust hot loop, `ty` pre-filter drops type-invalid
|
|
36
37
|
mutants before they ever reach pytest, per-test coverage selection runs
|
|
37
|
-
only the tests that touch each mutant
|
|
38
|
+
only the tests that touch each mutant, and mutants run in forks of one
|
|
39
|
+
pytest that already imported your suite (schemata).
|
|
38
40
|
- 🤖 **Agent-first** — machine-readable JSON reports, deterministic mutant
|
|
39
41
|
IDs, `next`/`explain`/`score` subcommands built for a coding agent in the loop.
|
|
40
|
-
- 🔁 **Incremental** —
|
|
41
|
-
|
|
42
|
+
- 🔁 **Incremental** — an unchanged re-run is answered from the cache
|
|
43
|
+
(pyjwt: ~38s cold, ~0.3s warm, measured together after the
|
|
44
|
+
[benchmark table](https://fermut.readthedocs.io/reference/benchmarks/#warm-and-loop-runs-the-incremental-story)), and `--diff-only` scopes mutation to
|
|
45
|
+
lines changed vs `main`.
|
|
42
46
|
- 🚦 **CI-ready** — non-zero exit when any mutant survives (or, with
|
|
43
47
|
`--fail-under`, when the score drops below a threshold), wire it straight
|
|
44
48
|
into a pull-request gate.
|
|
@@ -55,15 +59,12 @@ type-awareness. Humans welcome too.
|
|
|
55
59
|
uv tool install fermut # prebuilt wheel from PyPI, no Rust needed
|
|
56
60
|
cargo install --git https://github.com/KovantAI/fermut --locked # from source: needs Rust + ~2 min first compile
|
|
57
61
|
|
|
58
|
-
# in your project (needs pytest, coverage, pytest-cov
|
|
62
|
+
# in your project (needs pytest, coverage, pytest-cov on the same PATH; ty is embedded — see Installation)
|
|
59
63
|
fermut init # detect source/tests/runner, write fermut.toml
|
|
60
|
-
|
|
61
|
-
#
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
# (or, manually: coverage json -o coverage.json --show-contexts, then --coverage coverage.json)
|
|
65
|
-
|
|
66
|
-
fermut run src/ --tests tests/ # first mutation report (add -q to silence progress logs)
|
|
64
|
+
fermut baseline # where you stand: checks the env, builds .coverage,
|
|
65
|
+
# line coverage vs a sampled mutation score + worst files
|
|
66
|
+
fermut run src/ --tests tests/ # full mutation report (add -q to silence progress logs)
|
|
67
|
+
fermut next # the survivor worth a test first
|
|
67
68
|
```
|
|
68
69
|
|
|
69
70
|
For a CI gate, generate the opinionated profile instead — diff-only +
|
|
@@ -86,18 +87,19 @@ checkout with that base available — see
|
|
|
86
87
|
|
|
87
88
|
## Why fermut
|
|
88
89
|
|
|
89
|
-
On **typer** (
|
|
90
|
+
On **typer** (cold run, same machine, 2026-11-03):
|
|
90
91
|
|
|
91
92
|
| Tool | Time | Mutation score |
|
|
92
93
|
|--------|-------|----------------|
|
|
93
|
-
| fermut |
|
|
94
|
-
| mutmut |
|
|
95
|
-
|
|
96
|
-
fermut is **faster
|
|
97
|
-
and
|
|
98
|
-
rigor. The win is suite-shaped: on
|
|
99
|
-
|
|
100
|
-
wins
|
|
94
|
+
| fermut | 211s | 69.2% |
|
|
95
|
+
| mutmut | 289s | 70.4% |
|
|
96
|
+
|
|
97
|
+
fermut is **faster at a similar score** here: per-test coverage selection
|
|
98
|
+
and a fork server that collects the suite once (schemata) cut wall-clock
|
|
99
|
+
without dropping rigor. The win is suite-shaped: on more-itertools the two
|
|
100
|
+
tie (~123s vs ~119s), and on a tiny suite like markupsafe mutmut's simpler
|
|
101
|
+
model still wins (~9s vs ~15s). On the larger suites fermut finishes
|
|
102
|
+
werkzeug (41k generated mutants, 8k run) in under 3 minutes. Full numbers and methodology:
|
|
101
103
|
**[benchmarks](docs/reference/benchmarks.md)**.
|
|
102
104
|
|
|
103
105
|
## Documentation
|
|
@@ -116,7 +118,7 @@ Start here:
|
|
|
116
118
|
then `fermut run`, first report in under five minutes.
|
|
117
119
|
- **[Installation](docs/getting-started/installation.md)** — prerequisites
|
|
118
120
|
and build paths.
|
|
119
|
-
- **[
|
|
121
|
+
- **[Rolling out to a team](docs/guides/projects.md)** — gradual rollout,
|
|
120
122
|
profile choice, CI integration.
|
|
121
123
|
- **[CLI reference](docs/reference/cli/index.md)** — every subcommand,
|
|
122
124
|
every flag.
|