qsu: Change log

⚠️ indicates a breaking change.

[Unreleased]

Details

Added

Changed

Removed

[0.10.1] - 2026-03-22

Details

Changed

Use a larger unit for elapsed time logging.

[0.10.0] - 2026-03-08

Details

Added

ArgParser::setup_cmd() can be used to perform immediate configuration of the argument parser's internal root Command object.
The init_command!() macro can be used to initialize the argument parser's Command with some metadata from the crate's Cargo.toml.

Changed

⚠️ Use windows-registry instead of winreg/registry.

[0.9.1] - 2026-03-07

Details

Changed

Skip timestamp for production log when running in service mode. (It is assumed that the system's logging facilities will implicitly add a timestamp).
Bump MSRV.

[0.9.0] - 2026-03-06

Details

Added

Log init(), run() and shutdown() runtimes to the production log (at debug level).
Log total service uptime to production log (at info level).

Changed

⚠️ Pass a mutable reference to RunCtx in ArgProc::build_apprt().

[0.8.2] - 2026-03-05

Details

Changed

Bugfix: Fixed missing argument parser initialization.

[0.8.1] - 2026-03-05 (yanked)

Details

Changed

Add missing Sync bounds. This is really a breaking change, but 0.8.0 was yanked, so don't bump version.

[0.8.0] - 2026-03-05 (yanked)

Details

Added

Derive Debug, PartialEq and Eq for argp::Cmd.
It's now possile to pass buffers to initialization/termination handlers without needing to store them in the service application's context.
- Init/Term data can be added when constructing a RunCtx.
- Init data can be extracted in the init handler using InitCtx::take().
- Term data can be extracted in the term handler using TermCtx::take().
- The InitCtx can also add more data for the term handler using InitCtx::term_passthrough().
There's a new function that can be called on the argument parser which will register a closure to be called just before the service is run. The closure will receive the RunCtx, and must return it as well.
Support configuring production logging filtering using LOG_FILTER (or LogFilter when running as a Windows service).

Changed

Use Edition 2024. Bump MSRV to 1.85.
⚠️ The service handlers' init()/term() now gets passed a mutable reference to InitCtx and TermCtx, rather than pass ownership. (The runtime wants to access the (possibly modified) data in the InitCtx).
When init() returns, a report will be sent to the service subsystem stating that initialization is done.
When term() returns, a report will be sent to the service subsystem stating that termination is done.
⚠️ Remove the run-service argp subcommand. Instead use the -S/--as-service option. The service name can be specified using -N SVCNAME/--service-name SVCNAME.

Removed

⚠️ Removed argp's aadd_subcommands().

[0.7.0] - 2024-10-17

Details

Changed

Fix bug in winsvc rt implementation that caused error to get lost.
⚠️ Add std::fmt::Debug bounds to application errors at certain locations to assist in debugging.

[0.6.2] - 2024-10-17

Details

Added

After the qsu runtime as been launched rt::runas() can be used to probe whether the runtime was run as a foreground application or as a service subsystem application.

Changed

Make display_name and description options for register-service generally available on all platforms, but document which platforms they are used on."

[0.6.1] - 2024-10-05

Details

Changed

Rephrase register-service command line parser docs.

[0.6.0] - 2024-09-13

Details

Added

The reload service event has been implmented.
- It is not supported on Windows. (The Windows service subsystem offers no "reload" event).
- On unixy systems it is triggered through the SIGHUP signal.
- When using this feature on systemd, the server type should be set to notify-reload, and qsu will automatically report RELOADING, MONOTONIC_USEC or READY to systemd as needed.
Translate SIGUSR1/SIGUSR2 signals to SvcEvt's on unixy platforms.

Changed

⚠️ Rename instances of "trace level" to "trace filter".
⚠️ SvcEvt::Shutdown and SvcEvt::Terminate have been merged into the variant SvcEvt::Shutdown(Demise), where Demise can be used to determine if the service application is terminating via interruption/Ctrl+C, service shutdown request or if the service application reached reached its end without any external termination requests.
⚠️ Introduce CbErr<ApEr> to carry application-specific error type, and use Error to only store library errors.
Installer:
- Allow display name and description to be set on unsupported platforms, to allow application code to avoid platform gates.
- On Windows, implicitly add Tcpip as a service dependency for services marked as a netservice.

Removed

⚠️ The SvcEvtReader channel end-point has been removed. Previously this was passed to the service handlers' run() method. Now, instead, the application passes a service event handler closure when creating the runtime. To simulate the old behavior, an application can pass a closure that forwards all incoming SvcEvt events to a channel, which has its receiving end-point stored in the service handler.

[0.5.0] - 2024-05-20

Details

Added

TRACE_FILTER environment variable used to configure tracing to output.
TraceFilter registry key on Windows used to configure tracing output.

Changed

⚠️ Instead of specifying a "trace level" (similar to "log level"), specify a "trace filter", allowing fine-grained control of modules to include in traces.

Removed

TRACE_LEVEL environment variable no longer used.
TraceLevel registry key on Windows no longer used.

[0.4.1] - 2024-05-19

Details

Added

Re-export log and tracing.

Changed

windows-service 0.6.0 → 0.7.0

[0.4.0] - 2024-03-22

Details

Added

Add a rt::RunEnv type that is passed to application handler callbacks, allowing the application to be information about whether they are being run as foreground processes or as services.

Changed

Replace StartState and StopState with InitCtx and TermCtx, each of which also contain a RunEnv.

[0.3.0] - 2024-01-30

Details

Changed

Updated dependencies. env_logger updated to 0.11.

[0.2.1]

Details

Added

Re-export apperr

[0.2.0]

Details

Changed

Use apperr 0.2.0, which introduces trait bounds to the AppErr::new(E) to make it more difficult to pass the wrong type to it.

[0.1.0] - 2024-01-10

Details

Changed

Use apperr crate for AppErr instead of using a custom in-tree implementation.

[0.0.7] - 2023-12-09

Details

Changed

Use rocket 0.5.0 for Rocket server application runtime types
Updated dependencies.

[0.0.6] - 2023-11-10

Details

Changed

Bugfix: Attempted to use rocket without rocket feature.

[0.0.5] - 2023-11-03

Details

Changed

Use rocket 0.5.0-rc.4 for Rocket server application runtime types

[0.0.4] - 2023-10-29

Details

Added

Add the remaining ArgsProc callbacks in ArgParser.

Changed

Rather than pass a creation closure to the ArgParser::proc() for the run case, add a ArgsProc::build_apprt() that'll be invoked to create the runtime instead.
More consistently use AppErr for callbacks.

Removed

Removed err::CbOrigin.

[0.0.3] - 2023-10-23

Details

Added

Introduce an AppErr type that can wrap application-specific errors that the service runtime callbacks return for the Err() case.
Make the Error::App() take two values: An CbOrigin that is used to identify which callback returned an error, and an AppErr containing the application-specific error.

Changed

Make it possible to intsruct LumberJack not to initialize logging/tracing (because otherwise tests that initialize the qsu runtime will panic).
Major refactoring. Moved runtime to its own rt submodule, and put it behind a (default) rt feature.
Put the tokio server application runtime behind a tokio feature. Note: qsu still depends on tokio without tokio runtime support (albeit only with the sync feature for channels).

Removed

leak_default_service_name() was removed because it no longer serves a purpose.
The signals module is no longer public. (It still exists, but is considered an implementation detail).

[0.0.2] - 2023-10-19

Details

Added

Added some optional clap integration convenience functionality, that can be enabled using the 'clap' feature.
Added SvcEvt::Terminate.
Argument parser allows setting default service logging/tracing settings when registering service.
High-level argument parser that wraps service registration, deregistration, and running has been integrated into the qsu core library.

Changed

SIGTERM/Ctrl+Break/Close sends SvcEvt::Terminate rather than SvcEvt::Shutdown.
eventlog errors are mapped to Error::LumberJack (instead of Error::SubSystem).

[0.0.1] - 2023-10-15

Initial release.