fix: message where missing dependency name doesn't match install extra

[horo-fox]

PR adds a 3rd argument, extra: str | None = None to MissingDependencyException to handle case where Litestar's install extra is not named the same as the required package that the extra will install.

[peterschutt]

Looking at this test:

litestar/tests/unit/test_exceptions.py

Lines 148 to 156 in cf25db6

	def test_missing_dependency_exception_differing_package_name() -> None:
	exc = MissingDependencyException("some_package", "install_via_this")
	expected = (
	"Package 'some_package' is not installed but required. You can install it by running 'pip install "
	"litestar[install_via_this]' to install litestar with the required extra or 'pip install install_via_this' to "
	"install the package separately"
	)
	assert str(exc) == expected

... it appears that adding the additional extra=... argument doesn't offer any more than is already available to us (even if the naming of the install_package isn't totally obvious).

So I think this PR can simply be a 1-liner:

raise MissingDependencyException("jinja2", "jinja")

[horo-fox]

Well, pip install jinja isn't the same as pip install jinja2, but the extra is named jinja. So the extra name doesn't match the install name, though I assume normally it does match. I guess an alternative to adding an extra=... would be to add a new jinja2 extra?

[peterschutt]

Well, pip install jinja isn't the same as pip install jinja2, but the extra is named jinja. So the extra name doesn't match the install name, though I assume normally it does match. I guess an alternative to adding an extra=... would be to add a new jinja2 extra?

I agree with the problem you have identified. I don't agree that we need to add the extra key - this seems to be exactly what install_package is intended for.

[peterschutt]

Sorry - I see it now, b/c it also uses install_package in the pip install ... section - sorry you are correct.

[horo-fox]

Sorry about the delay! This should address everything.

[github-actions]

Documentation preview will be available shortly at https://litestar-org.github.io/litestar-docs-preview/2921

[peterschutt]

Thanks!

[peterschutt]

@all-contributors add @horo-fox for bug

[allcontributors]

@peterschutt

I've put up a pull request to add @horo-fox! 🎉