Skip to content

Soniq deprecations and removal plan

This page lists every deprecated Soniq feature, the version that removes it, and the replacement.

Policy

  • A deprecated feature keeps working for at least one minor version.
  • A deprecated feature is removed only in a later minor version.
  • Every deprecation and every removal appears in the changelog.
  • The replacement is named in the warning and in the table below.

What you see

Soniq emits a SoniqDeprecationWarning. It is a subclass of DeprecationWarning. Python hides DeprecationWarning by default outside __main__. For this reason, Soniq also writes each message once to the soniq logger at WARNING level.

Set the SONIQ_DEPRECATIONS environment variable to change this behavior:

Value Effect
error Raise SoniqDeprecationWarning. Use in tests.
ignore Do not warn and do not log.
unset Warn and log once.

Deprecated features

Name Deprecated in Removed in Use instead
Job names derived from the module path (@soniq.job() with no name=) 0.2.0 1.0 @soniq.job(name="..."), set to the name Soniq derived so queued jobs still match. See Storage format.