feat!: migrate workspace to Rust edition 2024

BREAKING CHANGE: MSRV raised from 1.83 to 1.85; workspace version
bumped from 3.1.0-develop to 4.0.0-develop.

Edition migration
-----------------
- Set `edition = "2024"` workspace-wide.
- Raise `rust-version` to 1.85.
- Promote `rust-2024-compatibility` lint group from `warn` to `deny`.
- Remove `#[allow(if_let_rescope)]` in torrent handlers (native in
  edition 2024).
- Relax `located-error` doctest assertion from `"lib.rs"` to `".rs"`
  to accommodate edition 2024 merged-doctest bundling.
- Apply `cargo fmt` import reordering (edition 2024 style) across
  ~55 files.

Dependency upgrades
-------------------
- `jsonwebtoken`: 9.3 → 10 (with `rust_crypto` feature).
- `rand`: 0.9 → 0.10; rename `use rand::Rng` to `use rand::RngExt`
  in 5 files.

Cargo.lock pins still required for MSRV 1.85
---------------------------------------------
- `simple_asn1` 0.6.3 (0.6.4 requires `time ^0.3.47`)
- `time` 0.3.45, `time-core` 0.1.7, `time-macros` 0.2.25, `num-conv`
  0.1.0 (0.3.47+ requires Rust 1.88)
- `psm` 0.1.24 (0.1.30 pulls `ar_archive_writer` with unstable
  `let` expressions)

See ADR-T-004 for full rationale and pin-maintenance instructions.

Author: da2ce7

Cargo.lock

@@ -23,14 +23,14 @@ authors = ["Nautilus Cyberneering <info@nautilus-cyberneering.de>, Mick van Dijk
 categories = ["network-programming", "web-programming"]
 description = "A BitTorrent Index"
 documentation = "https://docs.rs/crate/torrust-tracker/"
-edition = "2021"
+edition = "2024"
 homepage = "https://torrust.com/"
 keywords = ["bittorrent", "file-sharing", "index", "peer-to-peer", "torrent"]
 license = "AGPL-3.0-only"
 publish = true
 repository = "https://github.com/torrust/torrust-tracker"
-rust-version = "1.83"
-version = "3.1.0-develop"
+rust-version = "1.85"
+version = "4.0.0-develop"
 
 [features]
 default = []
@@ -63,7 +63,7 @@ http-body = "1"
 hyper = "1"
 hyper-util = { version = "0", features = ["http1", "http2", "tokio"] }
 indexmap = "2"
-jsonwebtoken = "9.3"
+jsonwebtoken = { version = "10", features = ["rust_crypto"] }
 lettre = { version = "0", features = [
     "builder",
     "file-transport-envelope",
@@ -76,7 +76,7 @@ log = "0"
 mockall = "0"
 pbkdf2 = { version = "0", features = ["simple"] }
 pin-project-lite = "0"
-rand = "0.9"
+rand = "0.10"
 regex = "1"
 reqwest = { version = "0", features = ["json", "multipart", "query"] }
 serde = { version = "1", features = ["derive", "rc"] }
@@ -118,7 +118,7 @@ nonstandard-style = { level = "deny", priority = -1 }
 rust-2018-compatibility = { level = "deny", priority = -1 }
 rust-2018-idioms = { level = "deny", priority = -1 }
 rust-2021-compatibility = { level = "deny", priority = -1 }
-rust-2024-compatibility = { level = "warn", priority = -1 }
+rust-2024-compatibility = { level = "deny", priority = -1 }
 unsafe-code = "warn"
 unused = { level = "deny", priority = -2 }
 warnings = { level = "deny", priority = -1 }

Cargo.toml

@@ -124,6 +124,8 @@ The following services are provided by the default configuration:
 - [ADR-T-001: Lowercase Infohashes](adr/001-lowercase-infohashes.md) — All infohashes are normalized to lowercase throughout the codebase, database, and API.
 - [ADR-T-002: Ignore Non-Standard Fields in Info Dictionary](adr/002-ignore-non-standard-info-fields.md) — Non-standard fields in the torrent info dictionary are ignored to prevent info-hash mismatches.
 - [ADR-T-003: Preparing for Rust Edition 2024](adr/003-edition-2024-preparation.md) — Pin dependencies to avoid edition-2024-only crates while the workspace remains on edition 2021; raise MSRV to 1.83.
+- [ADR-T-004: Remove `located-error` Package](adr/004-remove-located-error.md) — Replace the `torrust-index-located-error` wrapper with `tracing` for error context.
+- [ADR-T-005: Migrate to Rust Edition 2024](adr/005-edition-2024.md) — Migrate the entire workspace to `edition = "2024"` and raise the MSRV to 1.85.
 
 ## Contributing
 

README.md

@@ -0,0 +1,90 @@
+# ADR-T-005: Migrate to Rust Edition 2024
+
+**Status:** Decided
+**Date:** 2026-03-23
+**Supersedes:** [ADR-T-003](./003-edition-2024-preparation.md)
+(preparation / dependency pinning)
+
+## Context
+
+ADR-T-003 raised the MSRV to 1.83 and pinned several transitive
+dependencies to avoid edition-2024-only releases while the workspace
+remained on edition 2021. That was explicitly described as a
+temporary measure — the intention was always to complete the
+migration in a follow-up.
+
+Rust edition 2024 was stabilised in rustc 1.85. `cargo fix --edition`
+reported only one automatic fix (an `if_let_rescope` rewrite in
+`handlers.rs`), confirming that the codebase was already
+well-prepared by the 2024-compatibility lint group enabled in
+ADR-T-003.
+
+## Decision
+
+**Migrate the entire workspace to `edition = "2024"` and raise
+the MSRV to 1.85.**
+
+### Changes
+
+| Setting / File                                 | From            | To              | Reason                                                                 |
+| ---------------------------------------------- | --------------- | --------------- | ---------------------------------------------------------------------- |
+| `workspace.package.version`                    | `3.1.0-develop` | `4.0.0-develop` | Major bump for edition change                                          |
+| `workspace.package.edition`                    | `"2021"`        | `"2024"`        | Edition migration                                                      |
+| `workspace.package.rust-version`               | `1.83`          | `1.85`          | Minimum compiler for edition 2024                                      |
+| `workspace.lints.rust.rust-2024-compatibility` | `warn`          | `deny`          | Now the active edition; violations must not land                       |
+| `handlers.rs` — `#[allow(if_let_rescope)]`     | present         | removed         | Lint no longer needed; behaviour is native to edition 2024             |
+| `rand` direct dependency                       | `"0.9"`         | `"0.10"`        | ADR-T-003 pin no longer needed; edition 2024 satisfies `rand 0.10`     |
+| `use rand::Rng` (5 files)                      | `Rng`           | `RngExt`        | Trait renamed in `rand 0.10`                                           |
+| `jsonwebtoken` direct dependency               | `"9.3"`         | `"10"`          | ADR-T-003 pin no longer needed; v10 works with pinned `simple_asn1`    |
+
+### Dependency-pin status
+
+Most of the transitive-dependency pins from ADR-T-003 were lifted by
+a routine `cargo update` after the edition migration. The MSRV-aware
+resolver (active by default in edition 2024) automatically selects
+the latest MSRV-compatible version for most crates.
+
+#### Pins lifted (now at latest compatible versions)
+
+`clap`, `clap_builder`, `clap_derive`, `clap_lex`, `globset`,
+`ignore`, `image`, `png`, `quickcheck`, `env_logger`, `uuid`,
+`base64ct`, `psm`, `tera`, `deranged`, `home`.
+
+#### Pins still required
+
+The `time` family still requires manual pinning because
+`simple_asn1 ≥ 0.6.4` demands `time ^0.3.47`, which requires
+Rust 1.88. The MSRV-aware resolver cannot satisfy both the
+`simple_asn1` version constraint and the MSRV floor, so it falls
+back and pulls in the incompatible version.
+
+| Crate          | Pinned to | Latest  | Reason                                  |
+| -------------- | --------- | ------- | --------------------------------------- |
+| `simple_asn1`  | 0.6.3     | 0.6.4   | 0.6.4 requires `time ^0.3.47`          |
+| `time`         | 0.3.45    | 0.3.47  | 0.3.47 requires Rust 1.88              |
+| `time-core`    | 0.1.7     | 0.1.8   | 0.1.8 requires Rust 1.88               |
+| `time-macros`  | 0.2.25    | 0.2.27  | 0.2.27 requires Rust 1.88              |
+| `num-conv`     | 0.1.0     | 0.2.0   | pulled by `time`                        |
+| `psm`          | 0.1.24    | 0.1.30  | 0.1.30 adds `ar_archive_writer` (unstable `let` exprs) |
+
+After `cargo update`, re-pin with:
+
+```sh
+cargo update simple_asn1@0.6.4 --precise 0.6.3
+cargo update time@0.3.47 --precise 0.3.45
+cargo update psm@0.1.30 --precise 0.1.24
+```
+
+These pins can be dropped once `time` publishes a Rust-1.85-compatible
+release above 0.3.47, or when the workspace MSRV is raised to 1.88+.
+
+## Consequences
+
+- The workspace compiles and passes all tests (`--all-features`,
+  `--no-default-features`, `--release`, `--doc`) on rustc 1.85+.
+- Contributors must use rustc ≥ 1.85.
+- Edition-2024 language features (e.g. `gen` keyword reservation,
+  `unsafe_op_in_unsafe_fn` default, tail-expression temporaries)
+  are now available throughout the codebase.
+- The `rust-2024-compatibility` lint group is promoted to `deny`,
+  preventing future regressions.

adr/005-edition-2024.md

@@ -1,6 +1,6 @@
 use std::fs;
 
-use torrust_index_render_text_as_image::{render_text_to_png, RenderParams, Rgba};
+use torrust_index_render_text_as_image::{RenderParams, Rgba, render_text_to_png};
 
 fn main() {
     let params = RenderParams {

packages/render-text-as-image/examples/test_render.rs

@@ -7,7 +7,7 @@ use crate::blend::blend_source_over;
 use crate::encode::encode_rgba_png;
 use crate::font::embedded_font;
 use crate::layout::measure_text;
-use crate::types::{RenderError, RenderParams, MAX_TEXT_BYTES};
+use crate::types::{MAX_TEXT_BYTES, RenderError, RenderParams};
 
 /// Saturating cast from `f32` to `u32`, clamped to `[0, u32::MAX]`.
 fn f32_to_u32_sat(v: f32) -> u32 {

packages/render-text-as-image/src/render.rs

@@ -1,7 +1,7 @@
 //! Crate-level tests for the public API.
 
 use crate::types::MAX_TEXT_BYTES;
-use crate::{render_text_to_png, RenderError, RenderParams, Rgba};
+use crate::{RenderError, RenderParams, Rgba, render_text_to_png};
 
 // --- Rendering tests ---
 

packages/render-text-as-image/src/tests/mod.rs

@@ -7,8 +7,8 @@ use tracing::info;
 use crate::bootstrap::logging;
 use crate::cache::image::manager::ImageCacheService;
 use crate::common::AppData;
-use crate::config::validator::Validator;
 use crate::config::Configuration;
+use crate::config::validator::Validator;
 use crate::databases::database;
 use crate::services::authentication::{DbUserAuthenticationRepository, JsonWebToken, Service};
 use crate::services::authorization::{CasbinConfiguration, CasbinEnforcer};
@@ -21,9 +21,9 @@ use crate::services::torrent::{
 use crate::services::user::{self, DbBannedUserList, DbUserProfileRepository, DbUserRepository, Repository};
 use crate::services::{about, authorization, proxy, settings, torrent};
 use crate::tracker::statistics_importer::StatisticsImporter;
+use crate::web::api::Version;
 use crate::web::api::server::signals::Halted;
 use crate::web::api::server::v1::auth::Authentication;
-use crate::web::api::Version;
 use crate::{console, mailer, tracker, web};
 
 pub struct Running {

src/app.rs

@@ -13,7 +13,9 @@ fn main() -> io::Result<()> {
     let args: Vec<String> = env::args().collect();
     if args.len() != 2 {
         eprintln!("Usage:   cargo run --bin parse_torrent <PATH_TO_TORRENT_FILE>");
-        eprintln!("Example: cargo run --bin parse_torrent ./tests/fixtures/torrents/MC_GRID.zip-3cd18ff2d3eec881207dcc5ca5a2c3a2a3afe462.torrent");
+        eprintln!(
+            "Example: cargo run --bin parse_torrent ./tests/fixtures/torrents/MC_GRID.zip-3cd18ff2d3eec881207dcc5ca5a2c3a2a3afe462.torrent"
+        );
         std::process::exit(1);
     }
 

src/bin/parse_torrent.rs

@@ -7,10 +7,10 @@ use std::sync::Arc;
 
 use camino::Utf8PathBuf;
 use derive_more::Display;
-use figment::providers::{Env, Format, Serialized, Toml};
 use figment::Figment;
+use figment::providers::{Env, Format, Serialized, Toml};
 use serde::{Deserialize, Serialize};
-use serde_with::{serde_as, NoneAsEmptyString};
+use serde_with::{NoneAsEmptyString, serde_as};
 use thiserror::Error;
 use tokio::sync::RwLock;