Skip to content

Upgrading Extensions

Nameko 3 is backwards-compatible so that extensions written for Nameko 2 should not require any modification in order to work with Nameko 3.

In particular:

  • The container_factory and runner_factory fixtures still accept config, even as a deprecated argument.
  • The ServiceContainer.config attribute still returns a reference to the config object. This is also deprecated and will raise a warning.

Before Nameko 2 is sunsetted, extensions should make the neccessary adjustments to read from the global config object.

Test Upgrades

Although extensions will be backwards-compatible when used in services running Nameko 3, some changes may be required to their tests. These are the same changes that apply when reading config inside tests for service code.