Engin

Changed

- `Provide` & `Supply` will now raise an error if overriding an existing provider from the
same package. This is to prevent accidental overrides. Users can explicitly allow
overrides by specifying the `override` parameter when defining the provider
`Provide(..., override=True)` or `provide(override=True)`.
- Lifecycle startup tasks will now timeout after 15 seconds and raise an error.
- Assembler's `get` method has been renamed to `build`.
- Supply's `type_hint` parameter has been renamed to `as_type`.

Fixed

- `Assembler` would occasionally fail to call all multiproviders due to inconsistent
ordering.

Added

- `LifecycleHook` class to help build simple lifecycles with a start and stop call.

Changed

- `engin-graph` has been replaced by `engin graph`.
- Engin now uses `typer` for an improved cli experience. Note the package now has an extra `cli` which must be installed to use the cli.
- `Assembler.add(...)` does not error when adding already registered providers.
- Use a more performant algorithm for inspecting frame stack.

Fixed

- `ASGIEngin` now properly surfaces startup errors.
- `Engin.run()` doing a double shutdown.

Changed

- `Provide` now supports union types.

Added

- `Assembler` has a new method `add(provider: Provide) -> None` which allows adding a
provider to the Assembler post initialisation.

Changed

- `Provide` now raises a `ValueError` if the factory function is circular, i.e. one of its
parameters is the same as its return type as the behaviour of this is undefined.
- The ASGI utility method `engin_to_lifespan` has been improved so that it works "out of
the box" for more use cases now.

Added

- Dependency types now have two new attributes `source_module` & `source_package`.

Changed

- `engin-graph` now highlights external dependencies.

Added

- A utility function for ASGI extension `engin_to_lifespan` enabling users to easily
integrate Engin into an existing ASGI application.
- Further documentation work, including a FastAPI guide.

Fixed

- The warning for missing multiproviders is only logged once for each given type now.