uefi-services: prepare v0.26.0 release to accelerate migration/deprecation

phip1611 · phip1611 · commit 00372ca68f5e · 2025-06-24T09:08:38.000+02:00
Apparently, still a lot of people are using uefi-services, probably mostly due to
auto-upgrades. This seems to cause upgrades when people keep upgrading `uefi`
while still using an outdated version of `uefi-services`.

This update will cause everyone using auto-updates to either rethink to pin
their crate versions or to finally migrate.
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -5,6 +5,7 @@ members = [
     "uefi",
     "uefi-macros",
     "uefi-raw",
+    "uefi-services",
     "uefi-std-example",
     "uefi-test-runner",
     "xtask",
@@ -29,6 +30,7 @@ uguid = "2.2.1"
 uefi = { path = "uefi" }
 uefi-macros = { path = "uefi-macros" }
 uefi-raw = { path = "uefi-raw" }
+uefi-services = { path = "uefi-services" }
 
 # Enable optimization for xtask itself, not for its dependencies. This speeds up
 # OVMF prebuilt decompression without much increase in compilation time.
diff --git a/uefi-services/CHANGELOG.md b/uefi-services/CHANGELOG.md
@@ -0,0 +1,5 @@
+# uefi-services - 0.26 (2025-06-23)
+
+## Changed
+- The deprecation warning was replaced with a `compile_error!` call to alert
+  users to upgrade. `v0.25.0` can cause problems when used with `uefi` `>v0.25`.
diff --git a/uefi-services/Cargo.toml b/uefi-services/Cargo.toml
@@ -0,0 +1,24 @@
+[package]
+name = "uefi-services"
+version = "0.26.0"
+readme = "README.md"
+description = "Deprecated. Please migrate to `uefi::helpers`."
+
+authors.workspace = true
+categories.workspace = true
+edition.workspace = true
+keywords.workspace = true
+license.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+
+[dependencies]
+
+[badges.maintenance]
+status = "deprecated"
+
+[features]
+default = []
+qemu = []
+panic_handler = []
+logger = []
diff --git a/uefi-services/build.rs b/uefi-services/build.rs
@@ -0,0 +1,5 @@
+fn main() {
+    println!(
+        "cargo:warning=`uefi-services` is deprecated. Functionality was moved to `uefi::helpers::init`."
+    );
+}
diff --git a/uefi-services/src/lib.rs b/uefi-services/src/lib.rs
@@ -0,0 +1,6 @@
+//! WARNING: `uefi-services` is deprecated. Functionality was moved to `uefi::helpers::init`.
+#![no_std]
+
+compile_error!(
+    "uefi-services is deprecated since v0.25 (April 2024). Please migrate to `uefi` >0.26. See CHANGELOG for migration guidance!"
+);
diff --git a/xtask/src/main.rs b/xtask/src/main.rs
@@ -367,6 +367,7 @@ fn format_file_headers(fmt_opt: &FmtOpt) -> Result<()> {
         // This directory contains short code snippets used in `trybuild` tests,
         // no license needed.
         "uefi-macros/tests/ui/",
+        "uefi-services",
     ];
 
     // Recursively get Rust files
