# tinker_cookbook.utils.warn_deprecated

### [**tinker_cookbook.utils.warn_deprecated**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/utils/deprecation.py#L87)(*name*, *removal_version*, *message*, *stacklevel*)

Emit a DeprecationWarning for a deprecated feature.

If the current package version is at or past *removal_version*, raises a `RuntimeError` instead so that stale deprecated code paths are not silently used after their intended removal date.

**Parameters:**

- [**name**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/utils/deprecation.py#L88) (*str*) – Short identifier for the deprecated feature (e.g. function name, parameter name).
- [**removal_version**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/utils/deprecation.py#L90) (*str | None*) – The version in which this feature will be removed. When the running version reaches this value the warning becomes a hard error. Pass `None` to warn without a scheduled removal.
- [**message**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/utils/deprecation.py#L91) (*str*) – Additional guidance, typically a migration path such as "Use X instead."
- [**stacklevel**](https://github.com/thinking-machines-lab/tinker-cookbook/blob/main/tinker_cookbook/utils/deprecation.py#L92) (*int*) – Passed through to `warnings.warn`. The default of 2 points at the caller of the function that calls [`warn_deprecated`](https://tinker-docs.thinkingmachines.ai/cookbook/api-reference/utils/warn_deprecated/index.md).

**Returns:** *None*