big¶
A big workspace: a crate map with layers checked edge by edge, size limits with expiring exceptions, strict conformity.
Extends medium: everything below is on top of it.
Use it with extends = "big" in spirit_level.toml.
Lints enabled (with what it extends)¶
| Code | Lint | Level | Reason | Set in |
|---|---|---|---|---|
| A0010 | stop-gap-comments | deny |
no stop-gaps: a TODO or a 'for now' names its tracker id or goes | big |
| A0011 | fixme-before-land | deny |
a FIXME is a note for the branch; a candidate while it is in work, refused when it lands | big |
| C0001 | pub-surface | warn |
in a big workspace pub is the easy way across crates; a library that is all surface keeps nothing apart | big |
| C0002 | allow-without-reason | deny |
an exception to a lint says why, or it outlives its reason | big |
| C0003 | cli-subprocess | deny |
components call each other as libraries, not through their CLIs | medium |
| C0004 | float-determinism | deny |
crates the map marks deterministic compute the same bits on every platform | big |
| C0005 | panic-in-library | warn |
a library returns errors for what can fail and says why where it panics; warn until tpm_cli, wire_weaver and embedded_bedrock are under 50 findings each, then deny | medium |
| C0006 | print-in-library | warn |
printing is the binary's choice | small |
| C0007 | random-state-hash | deny |
crates the map marks deterministic iterate in the same order every run | big |
| C0008 | todo-macros | deny |
no stop-gaps: a todo!() is a panic waiting in shipped code | big |
| C0009 | dead-pub | warn |
rustc can't see pub items no other crate uses; in a big workspace they pile up (candidates, never fail) | big |
| C0010 | error-enum-growth | warn |
a flat error enum grows a variant per failure and loses the source errors; wrap them by layer | medium |
| C0011 | module-graph-scc | warn |
a module cycle holding most of a crate can't be split into crates; cut it while it is small | medium |
| C0012 | waiver-invalid | deny |
a waiver without a reason, for an unknown lint, or expired hides a finding without saying why | small |
| C0013 | waiver-unused | deny |
every waiver allows something, or it goes | big |
| C0014 | build-info-env | warn |
build info compiled into libraries recompiles them on every commit; the binary sets it once | medium |
| C0015 | test-support-gated | warn |
fakes and test helpers never ship: cfg(test), a test-support feature from dev-dependencies, or a test crate | medium |
| C0016 | orphan-source-file | deny |
a file no mod reaches is never compiled or tested, yet reads like live code | big |
| C0017 | sized-ints-in-contracts | deny |
a contract is read on every party; usize is 32 bits on some of them | big |
| C0019 | unbounded-read | warn |
input from outside sets the memory a read to the end takes; candidates only, a place to look | big |
| C0020 | cli-help-examples | warn |
a reader learns a command from its examples first; most existing CLIs lack them on many leaves | small |
| C0021 | cli-help-text | warn |
-h is the map of a tool; an entry without a line leaves the reader guessing | small |
| C0022 | cli-help-clean | deny |
rustdoc source in help is a plain defect, fixed in a line | medium |
| C0023 | cli-completion | warn |
completion makes a tool discoverable at the prompt; older CLIs add it when touched | small |
| C0024 | cli-plain-when-piped | deny |
colour escapes in a pipe break grep, diffs and scripts | medium |
| C0025 | cli-color-flag | warn |
--color settles what automatic colour guesses wrong, the same way in every tool; older CLIs add it when touched | small |
| C0026 | cli-usage-error | deny |
a caller tells a wrong call from a failure by exit code 2; clap gives it for free | medium |
| C0027 | cli-version-line | warn |
the SHA and commit time say which build runs; older CLIs print other formats | small |
| C0029 | cli-standard-flags | warn |
short flags are habits across tools; a different meaning turns a habit into a mistake | small |
| C0030 | compound-assert | warn |
assert!(a && b) is two assertions: a failure does not say which condition broke | big |
| C0031 | assert-message | warn |
a failed assertion says in words what broke, not only the expression | big |
| C0032 | float-partial-cmp-unwrap | warn |
partial_cmp(..).unwrap() panics on the first NaN; total_cmp orders every float | small |
| C0033 | exact-units-quantity | warn |
a unit in a name is checked by no one; in the type the compiler checks every use. Names only, so a warning | small |
| C0035 | exact-units-bounds | warn |
a range the code enforces belongs in the type, where every value is checked when it is made | small |
| C0037 | cli-secret-flags | warn |
a candidate: a flag's name is a guess at its purpose, so a human reads each hit; the shell history and the process list both see a value passed on the command line | small |
| C0038 | cli-no-abbreviations | deny |
clap defaults to exact subcommand names for free; turning inference on is a choice, not an accident | medium |
| C0039 | command-registry | warn |
an estimate: past a handful of commands, one central list is the line every new command edits and every parallel branch conflicts on | small |
| C0040 | build-script-clock | warn |
a clock read makes the build unreproducible; a hardcoded .git path breaks in a worktree checkout | small |
| D0001 | prose-run-words | warn |
a long stretch of prose with no heading, figure, table or code block is skimmed, not read | small |
| D0002 | page-reading-time | warn |
a guide longer than one sitting is left half read | small |
| D0003 | heading-words | warn |
headings are scanned to find a section; a sentence is read slowly | small |
| D0004 | page-headings | warn |
a long page without sections gives the reader no map | small |
| D0005 | code-wall | warn |
code without prose leaves the reader to guess what it shows | small |
| D0006 | image-alt | warn |
an image without alternative text tells a screen reader, a search engine and a broken link nothing | small |
| D0007 | code-block-language | warn |
the language selects the highlighting and tells the reader what the block is | small |
| D0008 | nav-entries | deny |
a navigation entry that names no page renders as a link that leads nowhere, and the build does not fail | small |
| D0009 | orphan-pages | warn |
a page nobody reaches is published, unread and left to go stale | small |
| D0010 | page-title | warn |
a page without a title is shown under its file name | small |
| D0011 | admonition-syntax | deny |
an unknown type loses its colour and a body indented less than four spaces renders outside the box | small |
| D0012 | abbreviation-first-use | warn |
a reader arrives on any page and cannot look up an abbreviation the page never spells out | small |
| D0013 | term-before-definition | warn |
a term used before its definition is guessed at, and a wrong guess is read into every sentence until then | small |
| D0014 | term-synonyms | warn |
a reader takes two names for two things and looks for a difference that is not there | small |
| D0015 | passive-voice | warn |
a passive sentence hides who acts; a page of them reads as things that happen on their own | small |
| D0016 | reading-ease | warn |
long sentences of long words are read slowly and understood less | small |
| D0017 | book-build-stamp | warn |
without a version, commit and age in the footer, a reader cannot tell which build they are looking at | small |
| D0018 | readme-index-clash | deny |
Zensical does not say which of README.md and index.md it builds when a folder holds both | small |
| D0019 | theme-feature-conflicts | deny |
Zensical does not support the conflicting features together, and builds neither error nor warn about it | small |
| D0020 | zensical-keys | deny |
Zensical ignores a key it does not know, silently; a typo in zensical.toml never fails the build | small |
| D0021 | page-links | deny |
a link to a page that moved or never existed, or to the built site, leads a reader nowhere | small |
| D0022 | book-deploy | warn |
a book published by hand falls behind main, and a broken page goes live; one workflow builds it strict and deploys it | small |
| G0001 | core-crate-deps | deny |
a _core crate holds shared types and drags nothing in | big |
| G0002 | core-crate-types | deny |
_core crates hold only types: no I/O, threads or runtimes | big |
| G0003 | crate-cycles | deny |
crates in a cycle cannot be built or tested apart | medium |
| G0004 | crate-table | deny |
the crate table is generated from the manifests and the map, never written by hand | big |
| G0005 | external-form | deny |
outside projects come by git on a branch, listed once, used where their role allows | big |
| G0006 | forbidden-closure | deny |
some crates must never end up in a binary, however far away they arrive | big |
| G0007 | layer-edges | deny |
layers are declared and checked edge by edge; move a crate, never reorder layers | big |
| G0008 | map-complete | deny |
the crate map is the source of truth: every crate in it, nothing gone | big |
| G0009 | third-party-placement | deny |
heavy dependencies sit in one crate each | big |
| G0010 | unsafe-allow-list | deny |
unsafe is forbidden except in the crates the map lists | big |
| G0011 | crate-folder-layer | deny |
the map decides the path: crates/ |
big |
| G0012 | map-licence | deny |
the map decides each layer's licence; a manifest that drifts ships under terms nobody chose | big |
| M0001 | default-features-off | deny |
feature creep in a big graph costs every build | big |
| M0002 | duplicate-versions | deny |
two versions of a crate double its build time and split its types | big |
| M0003 | git-dependency-pins | deny |
git dependencies follow a branch; a pin hides a break until it is old | medium |
| M0004 | no-sys-crates | deny |
pure-Rust crates only: no bundled C, no -sys bindings without a written reason | small |
| M0005 | path-outside-workspace | deny |
a path into a sibling checkout builds differently on every PC | small |
| M0006 | crate-docs | deny |
rustdoc's front page of the crate is its crate-level docs | big |
| M0007 | edition-latest | warn |
new code starts on the current edition | small |
| M0008 | feature-docs | warn |
a feature without a comment cannot be chosen by a reader | big |
| M0009 | package-description | deny |
the generated crate table and READMEs are made from it | big |
| M0010 | package-license | warn |
a crate without a licence cannot be reused or published | small |
| M0011 | publish-false | warn |
internal crates are a build unit, not an API; only listed crates are published | medium |
| M0012 | readme-per-crate | deny |
every crate of a workspace says what it is and what it may depend on | small-workspace |
| M0013 | rust-version-set | deny |
the MSRV is declared so it can be checked | big |
| M0014 | changelog-unreleased | warn |
work lands under [Unreleased]; the release step turns it into a version section | small |
| M0015 | justfile-recipes | warn |
every repo answers to the same recipes: default, test, lint, install, deploy | small |
| M0016 | justfile-simple | warn |
recipes call programs; logic lives in Rust where it is tested | big |
| M0017 | profile-defaults | warn |
split debug info and an incremental deploy profile: measured large build-time wins | small |
| M0018 | repo-files | warn |
every work repo carries README, AGENTS, CLAUDE, FEATURES and CHANGELOG | small |
| M0019 | toolchain-pinned | deny |
every PC and the gate build with the same compiler | big |
| M0020 | crate-dir-name | warn |
flat crates/ |
small-workspace |
| M0021 | macro-crate-suffix | warn |
_macros and _derive mean proc macros and nothing else | small-workspace |
| M0022 | workspace-dependencies | deny |
one version per dependency per workspace, written once in [workspace.dependencies] | medium |
| M0023 | workspace-inheritance | deny |
edition, rust-version, licence and repository are declared once in [workspace.package] | small-workspace |
| M0024 | workspace-lints | deny |
every crate inherits [workspace.lints], so one table is the policy | small-workspace |
| M0025 | tier-clippy-set | deny |
the Clippy set is the lint policy of every crate; a gap in it is a gap in the policy | medium |
| M0026 | profile-no-lto | warn |
LTO in the loop's profiles turns a link of a second into minutes; it belongs in a release profile | small |
| M0027 | patch-outside-workspace | deny |
a committed patch into a sibling checkout builds differently on every machine; it lives in an ignored .cargo/config.toml | small |
| M0028 | test-binaries | warn |
each integration-test binary links the library again; one tests/it binary links it once | medium |
| M0029 | macro-compile-fail | warn |
a proc macro must refuse bad input with a clear error, and only compile-fail cases show that | medium |
| M0030 | contract-snapshot | deny |
every party of a contract knows its version and what that version looks like; a released snapshot never changes | big |
| M0031 | fuzz-corpus-test | warn |
a fuzz target's interesting inputs are a regression suite only once they are in git and replayed on every ordinary test run | medium |
| M0032 | ci-workflow | warn |
checks that only run on one PC get skipped; CI runs the repo's own checks on every push and pull request | small-workspace |
| M0033 | manifest-homepage | warn |
crates.io and docs.rs link to repository and homepage; when there is a book, it is the homepage a reader wants | small |
| M0034 | readme-badges | warn |
the top of the README tells a visitor whether the project passes and where its book, crate and API docs are | small |
| P0001 | agent-file-lines | warn |
agents read AGENTS.md whole every session; a long one is skimmed, not followed | small |
| P0003 | agent-rules-match-lints | warn |
limits AGENTS.md states are the limits the lints check | big |
| P0007 | commit-subject-length | warn |
the subject is what one-line logs and reviews show | medium |
| P0009 | changelog-entry-length | warn |
a CHANGELOG is a list: one short line per change | small |
| P0017 | fixes-tag | warn |
a Fixes: trailer that points nowhere is worse than none; it fires only where one is written | medium |
| P0018 | fix-without-test | warn |
a bug is fixed when a test fails without the fix; a warning, since a fix is judged from its subject | big |
| S0001 | crate-lines | warn |
split a crate before it passes ~20,000 lines: one crate is one serial compile step | medium |
| S0002 | function-complexity | warn |
more paths than can be tested or held in one's head | small |
| S0003 | function-lines | warn |
a function longer than a screen is changed without being read whole | small |
| S0004 | module-lines | warn |
a file of thousands of lines holds several subjects and collects every edit | medium |
| S0005 | test-lines | warn |
test code builds and links too | big |
| S0006 | crate-folder-size | deny |
a flat crates/ past a few dozen crates groups by layer; a layer of about 100 crates by discipline | big |
| T0001 | lock-held-across | deny |
a guard across .await or I/O stalls every other caller for as long as the slowest peer | big |
| T0002 | lock-unwrap | warn |
the count of lock().unwrap() per crate shows where shared state concentrates | medium |
| T0003 | nested-locks | warn |
two locks at once need one lock order everywhere | small-workspace |
| T0004 | static-interior-mutability | deny |
every piece of mutable state has one owner; a global lock says why on the item | big |
| T0005 | static-mut | deny |
global mutable state with no synchronisation; there is always a better owner | small |
| T0006 | thread-local-state | warn |
thread-local state is a hidden side channel between functions | small-workspace |
| X0005 | cargo-doc | deny |
the docs of internal crates are the map of the code; they build without a warning | medium |
| X0006 | cargo-msrv | deny |
the declared rust-version is built, so it stays true | big |
| X0007 | cargo-no-std | deny |
a crate the map marks no_std is built for a target without std, or the promise breaks unseen | big |
| X0008 | cargo-wasm | deny |
a crate the map marks wasm is built for wasm32, or the promise breaks unseen | big |
| X0019 | deny-advisories | deny |
a vulnerable dependency is updated, or its advisory ignored with a reason in deny.toml | medium |
| X0020 | deny-bans | deny |
banned crates (OpenSSL, a second runtime) and duplicate versions stay out of a big graph | big |
| X0021 | deny-licenses | deny |
every linked licence is one the project accepts, listed once in deny.toml | big |
| X0022 | deny-sources | deny |
crates come only from the registries and git hosts deny.toml trusts | big |
| X0024 | hakari-generate | warn |
a workspace-hack builds each shared dependency once; warn, as not every workspace wants one | big |
| X0025 | hakari-manage-deps | warn |
the workspace-hack helps only the members that depend on it; warn, as adding one is each workspace's choice | big |
| X0026 | machete-unused-deps | deny |
an unused dependency in a big graph costs every build; false positives are listed in the manifest | big |
| X0028 | semver-checks-breaking | deny |
a crate the map marks stable changes its API only with the version bump it needs | big |
| X0031 | taplo-fmt | deny |
manifests are edited by people and by tools; one TOML formatting keeps their diffs about the change | big |
| X0032 | typos-misspelling | deny |
names are searched across hundreds of crates; a misspelling hides from every search | big |
| X0034 | tool-version | deny |
an external tool outside its tested range may print a shape the adapter misreads: its results cannot be trusted | small |
Clippy set (with what it extends)¶
The project turns these on in its own [workspace.lints.clippy] (allow rows are accepted opt-outs, pasted with their reason); tier-clippy-set checks it.
| Clippy lint | Level | Reason | Set in |
|---|---|---|---|
cargo |
warn |
manifest hygiene: feature names, wildcard versions | medium |
pedantic |
warn |
the stricter idioms; the opt-outs below are the ones that are noise for most code | medium |
allow_attributes |
warn |
#[expect] fails once the lint stops firing, so an exception cannot outlive its cause | medium |
as_ptr_cast_mut |
warn |
as_ptr() as *mut writes through a shared borrow: undefined behaviour |
small |
cognitive_complexity |
warn |
a function too tangled to follow in one read; complements spl's cyclomatic function-complexity | medium |
dbg_macro |
warn |
debugging output left behind | small |
debug_assert_with_mut_call |
warn |
a debug_assert! that calls a &mut method makes debug and release builds behave differently | small |
exit |
warn |
process::exit skips every destructor; main returns instead | small |
fallible_impl_from |
warn |
a From that can panic is a TryFrom | small |
float_cmp_const |
warn |
comparing a float to a constant exactly is almost always a bug | big |
get_unwrap |
warn |
.get(i).unwrap() is indexing with a worse message: index, or handle the None |
small |
ignore_without_reason |
warn |
an ignored test says why, or nobody knows when it may run again | small |
imprecise_flops |
warn |
hypot, ln_1p and friends are more precise than the formula written out | big |
iter_over_hash_type |
warn |
iteration over a hash map changes order from run to run; random-state-hash reports the type | big |
let_underscore_must_use |
warn |
let _ = on a must_use value drops an error unseen |
small |
lossy_float_literal |
warn |
a float literal that does not fit its type silently becomes another number | big |
map_err_ignore |
warn |
map_err(\|_\| ...) throws the cause away; wrap it as the source |
small |
mem_forget |
warn |
forget leaks the value and skips Drop; ManuallyDrop says it on purpose | small |
missing_panics_doc |
warn |
a public function that can panic says when in a # Panics section; the docs keep up with the asserts | medium |
print_stderr |
warn |
printing is the binary's choice, written in one place | medium |
print_stdout |
warn |
printing is the binary's choice, written in one place | medium |
self_named_module_files |
warn |
one module layout, mod.rs, across the workspace | medium |
str_to_string |
warn |
to_owned says what happens: a copy of a borrowed str | medium |
todo |
warn |
no stop-gaps: a todo!() is a panic waiting in shipped code | small |
too_long_first_doc_paragraph |
warn |
the first doc paragraph is the summary rustdoc lists; one short sentence | medium |
undocumented_unsafe_blocks |
warn |
every unsafe block says in a SAFETY: comment why it is sound | small |
unimplemented |
warn |
no stop-gaps: an unimplemented!() is a panic waiting in shipped code | small |
unnecessary_safety_doc |
warn |
a # Safety section on a safe function sends readers looking for a contract that is not there | small |
unwrap_used |
warn |
a panic says what failed (expect with a message), or the error is returned | small |
use_self |
warn |
Self follows a rename | medium |
assigning_clones |
allow |
clone_into reads backwards | medium |
cargo_common_metadata |
allow |
keywords and categories matter only for published crates; package-description covers the rest | medium |
cast_lossless |
allow |
a widening as cast loses nothing, and From is longer for no gain |
medium |
cast_possible_truncation |
allow |
too noisy: most casts are of values known to fit | medium |
cast_precision_loss |
allow |
too noisy: integer to float for display and statistics is the common case | medium |
cast_sign_loss |
allow |
too noisy: most casts are of values known to be non-negative | medium |
default_trait_access |
allow |
Default::default() is clear where the type is written beside it | medium |
float_cmp |
allow |
exact float comparisons are usually intended; float_cmp_const stays on in big | medium |
implicit_hasher |
allow |
a BuildHasher type parameter on public functions is not worth it | medium |
inline_always |
allow |
#[inline(always)] is written where it was measured | medium |
items_after_statements |
allow |
a helper item next to its only use reads better | medium |
many_single_char_names |
allow |
r, g, b and x, y, z are fine | medium |
map_unwrap_or |
allow |
.map(f).unwrap_or(x) often reads better than map_or |
medium |
missing_errors_doc |
allow |
the error type documents its cases | medium |
multiple_crate_versions |
allow |
spl's duplicate-versions checks this, with a reasoned allow list | medium |
must_use_candidate |
allow |
thousands of hits; must_use goes where ignoring the value is a bug | medium |
needless_raw_string_hashes |
allow |
r#"..."# keeps a string editable when a quote is added | medium |
redundant_closure_for_method_calls |
allow |
a closure is often clearer than a path to a method | medium |
return_self_not_must_use |
allow |
thousands of hits on builders | medium |
similar_names |
allow |
too many false positives: encoder and encoded are different things | medium |
struct_excessive_bools |
allow |
a struct of flags is often just that | medium |
struct_field_names |
allow |
a field named after its struct is often the clearest name | medium |
too_many_lines |
allow |
spl's function-lines measures function length, with a limit per crate and expiring exceptions | medium |
trivially_copy_pass_by_ref |
allow |
passing small Copy types by reference is harmless | medium |
unnecessary_debug_formatting |
allow |
paths printed with {:?} quote themselves, which helps with spaces | medium |
unreadable_literal |
allow |
addresses and magic numbers are written as their sources write them | medium |
used_underscore_binding |
allow |
an underscore binding used in one cfg is common | medium |
clippy.toml (an integer is a limit the project may lower):
| Setting | Value | Reason | Set in |
|---|---|---|---|
allow-print-in-tests |
true |
a test may print what it saw | medium |
allow-unwrap-in-tests |
true |
a test that unwraps fails at the unwrap, which is what a test should do | small |
cognitive-complexity-threshold |
20 |
set on samples: 17 read fine, 21 and 25 were too long; spl's function-complexity (cyclomatic, 15) counts paths | medium |
max-fn-params-bools |
1 |
two bool parameters are a call site nobody can read; an enum or a struct says what each means | medium |
The file¶
# Tier 4: a big workspace (rerun, zed, bevy, intent): layers declared and checked, sizes watched, everything strict.
extends = "medium"
[tier]
description = "A big workspace: a crate map with layers checked edge by edge, size limits with expiring exceptions, strict conformity"
[lints.waiver-unused]
level = "deny"
reason = "every waiver allows something, or it goes"
[lints.package-description]
level = "deny"
reason = "the generated crate table and READMEs are made from it"
[lints.crate-docs]
level = "deny"
reason = "rustdoc's front page of the crate is its crate-level docs"
[lints.default-features-off]
level = "deny"
reason = "feature creep in a big graph costs every build"
[lints.duplicate-versions]
level = "deny"
reason = "two versions of a crate double its build time and split its types"
[lints.rust-version-set]
level = "deny"
reason = "the MSRV is declared so it can be checked"
[lints.toolchain-pinned]
level = "deny"
reason = "every PC and the gate build with the same compiler"
[lints.feature-docs]
level = "warn"
reason = "a feature without a comment cannot be chosen by a reader"
[lints.justfile-simple]
level = "warn"
reason = "recipes call programs; logic lives in Rust where it is tested"
[lints.test-lines]
level = "warn"
reason = "test code builds and links too"
[lints.static-interior-mutability]
level = "deny"
reason = "every piece of mutable state has one owner; a global lock says why on the item"
[lints.lock-held-across]
level = "deny"
reason = "a guard across .await or I/O stalls every other caller for as long as the slowest peer"
[lints.map-complete]
level = "deny"
reason = "the crate map is the source of truth: every crate in it, nothing gone"
[lints.layer-edges]
level = "deny"
reason = "layers are declared and checked edge by edge; move a crate, never reorder layers"
[lints.crate-folder-size]
level = "deny"
reason = "a flat crates/ past a few dozen crates groups by layer; a layer of about 100 crates by discipline"
[lints.crate-folder-layer]
level = "deny"
reason = "the map decides the path: crates/<layer>/<crate>, a large layer by discipline, never deeper"
[lints.forbidden-closure]
level = "deny"
reason = "some crates must never end up in a binary, however far away they arrive"
[lints.external-form]
level = "deny"
reason = "outside projects come by git on a branch, listed once, used where their role allows"
[lints.third-party-placement]
level = "deny"
reason = "heavy dependencies sit in one crate each"
[lints.core-crate-deps]
level = "deny"
reason = "a _core crate holds shared types and drags nothing in"
[lints.core-crate-types]
level = "deny"
reason = "_core crates hold only types: no I/O, threads or runtimes"
[lints.crate-table]
level = "deny"
reason = "the crate table is generated from the manifests and the map, never written by hand"
[lints.unsafe-allow-list]
level = "deny"
reason = "unsafe is forbidden except in the crates the map lists"
[lints.map-licence]
level = "deny"
reason = "the map decides each layer's licence; a manifest that drifts ships under terms nobody chose"
[lints.todo-macros]
level = "deny"
reason = "no stop-gaps: a todo!() is a panic waiting in shipped code"
[lints.allow-without-reason]
level = "deny"
reason = "an exception to a lint says why, or it outlives its reason"
[lints.float-determinism]
level = "deny"
reason = "crates the map marks deterministic compute the same bits on every platform"
[lints.random-state-hash]
level = "deny"
reason = "crates the map marks deterministic iterate in the same order every run"
[lints.stop-gap-comments]
level = "deny"
reason = "no stop-gaps: a TODO or a 'for now' names its tracker id or goes"
[lints.orphan-source-file]
level = "deny"
reason = "a file no mod reaches is never compiled or tested, yet reads like live code"
[lints.sized-ints-in-contracts]
level = "deny"
reason = "a contract is read on every party; usize is 32 bits on some of them"
[lints.contract-snapshot]
level = "deny"
reason = "every party of a contract knows its version and what that version looks like; a released snapshot never changes"
[lints.unbounded-read]
level = "warn"
reason = "input from outside sets the memory a read to the end takes; candidates only, a place to look"
[lints.fixme-before-land]
level = "deny"
reason = "a FIXME is a note for the branch; a candidate while it is in work, refused when it lands"
[lints.fix-without-test]
level = "warn"
reason = "a bug is fixed when a test fails without the fix; a warning, since a fix is judged from its subject"
[lints.agent-rules-match-lints]
level = "warn"
reason = "limits AGENTS.md states are the limits the lints check"
[lints.dead-pub]
level = "warn"
reason = "rustc can't see pub items no other crate uses; in a big workspace they pile up (candidates, never fail)"
[lints.pub-surface]
level = "warn"
reason = "in a big workspace pub is the easy way across crates; a library that is all surface keeps nothing apart"
[lints.deny-bans]
level = "deny"
reason = "banned crates (OpenSSL, a second runtime) and duplicate versions stay out of a big graph"
[lints.deny-licenses]
level = "deny"
reason = "every linked licence is one the project accepts, listed once in deny.toml"
[lints.deny-sources]
level = "deny"
reason = "crates come only from the registries and git hosts deny.toml trusts"
[lints.machete-unused-deps]
level = "deny"
reason = "an unused dependency in a big graph costs every build; false positives are listed in the manifest"
[lints.typos-misspelling]
level = "deny"
reason = "names are searched across hundreds of crates; a misspelling hides from every search"
[lints.taplo-fmt]
level = "deny"
reason = "manifests are edited by people and by tools; one TOML formatting keeps their diffs about the change"
[lints.cargo-msrv]
level = "deny"
reason = "the declared rust-version is built, so it stays true"
[lints.cargo-no-std]
level = "deny"
reason = "a crate the map marks no_std is built for a target without std, or the promise breaks unseen"
[lints.cargo-wasm]
level = "deny"
reason = "a crate the map marks wasm is built for wasm32, or the promise breaks unseen"
[lints.semver-checks-breaking]
level = "deny"
reason = "a crate the map marks stable changes its API only with the version bump it needs"
[lints.hakari-generate]
level = "warn"
reason = "a workspace-hack builds each shared dependency once; warn, as not every workspace wants one"
[lints.hakari-manage-deps]
level = "warn"
reason = "the workspace-hack helps only the members that depend on it; warn, as adding one is each workspace's choice"
[lints.compound-assert]
level = "warn"
reason = "assert!(a && b) is two assertions: a failure does not say which condition broke"
[lints.assert-message]
level = "warn"
reason = "a failed assertion says in words what broke, not only the expression"
# On top of medium's Clippy set: the restriction and nursery lints a big codebase wants.
[clippy.lints]
iter_over_hash_type = { level = "warn", reason = "iteration over a hash map changes order from run to run; random-state-hash reports the type" }
float_cmp_const = { level = "warn", reason = "comparing a float to a constant exactly is almost always a bug" }
lossy_float_literal = { level = "warn", reason = "a float literal that does not fit its type silently becomes another number" }
imprecise_flops = { level = "warn", reason = "hypot, ln_1p and friends are more precise than the formula written out" }