Skip to content

Improve missing backend error - #1115

Merged
agronholm merged 8 commits into
agronholm:masterfrom
EmmanuelNiyonshuti:improve-missing-backend-error
Apr 13, 2026
Merged

Improve missing backend error#1115
agronholm merged 8 commits into
agronholm:masterfrom
EmmanuelNiyonshuti:improve-missing-backend-error

Conversation

@EmmanuelNiyonshuti

Copy link
Copy Markdown
Collaborator

NOTE Erasing or replacing the contents of this template will result in your pull
request being summarily closed without consideration!

Changes

Fixes #.

Right now when you have a backend like trio in BACKENDS but it is not installed, the error says:

LookupError: No such backend: trio

This is a bit confusing because trio is a valid backend, it is just not installed. I changed it to tell the user what to do instead:

LookupError: Backend 'trio' is not available. Install it with: pip install anyio[trio]

The fix uses the already existing BACKENDS constant to check if the backend is known but just not installed, and gives a different message for that case.

Checklist

If this is a user-facing code change, like a bugfix or a new feature, please ensure that
you've fulfilled the following conditions (where applicable):

  • You've added tests (in tests/) which would fail without your patch
  • You've updated the documentation (in docs/), in case of behavior changes or new
    features
  • You've added a new changelog entry (in docs/versionhistory.rst).

If this is a trivial change, like a typo fix or a code reformatting, then you can ignore
these instructions.

Updating the changelog

If there are no entries after the last release, use **UNRELEASED** as the version.
If, say, your patch fixes issue #123, the entry should look like this:

- Fix big bad boo-boo in task groups
  (`#123 <https://github.com/agronholm/anyio/issues/123>`_; PR by @yourgithubaccount)

If there's no issue linked, just link to your pull request instead by updating the
changelog after you've created the PR.

Comment thread docs/versionhistory.rst Outdated
Comment thread src/anyio/_core/_eventloop.py

@agronholm agronholm left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. I just need a number of minor changes first.

Comment thread tests/test_eventloop.py Outdated
Comment thread tests/test_eventloop.py Outdated

@agronholm agronholm left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM now. Thanks!

@agronholm
agronholm merged commit c86975e into agronholm:master Apr 13, 2026
18 checks passed
@EmmanuelNiyonshuti
EmmanuelNiyonshuti deleted the improve-missing-backend-error branch May 1, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants