zalando / zalando/postgres-operator

UI: Migrate from backoff to backon - drop-in replacement, archived upstream

Open Beginner friendly
#3,132 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

dependencies good first issue ui
Dominant language
Go
Stars
5.2k
Forks
1.1k
Avg merge
2d 16h
Merged PRs (30d)
3

Description

Type of issue: Feature request

Which image of the operator are you using? Not applicable (UI component issue).

Describe the problem:

The backoff library (litl/backoff) was archived in August 2025 and is no longer maintained. It is also incompatible with Python 3.14+ due to the removal of the deprecated asyncio.iscoroutinefunction() API.

The Postgres Operator UI currently depends on backoff==2.2.1 (pinned in ui/requirements.txt) and uses it in ui/operator_ui/main.py:

from backoff import expo, on_exception

@on_exception(expo, RequestException)
def get_target_namespace():
    ...

Describe the solution:

Migrate to backon — a modern, actively maintained evolution of backoff. It is a drop-in replacement: change only the import statement.

-from backoff import expo, on_exception
+from backon import expo, on_exception

-@on_exception(expo, RequestException)
+@on_exception(expo, RequestException)

The dependency change in ui/requirements.txt:

-backoff==2.2.1
+backon>=4.3.0

Why backon?

  • Zero dependencies (pure Python, stdlib only)
  • Same public API as backoff — on_exception, on_predicate, expo, fibo, constant, runtime
  • Full type hints
  • Python 3.10+ compatible (including 3.14+)
  • Additional features if ever needed: circuit breaker, hedging, testing utilities, global toggle
  • I am the author and happy to submit a PR

Additional context:

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with ui/requirements.txt and ui/operator_ui/main.py, where the current backoff dependency and retry decorator are named. Review the existing import and dependency constraint, then verify the UI still installs and the retry behavior remains compatible with Python 3.14+. Done means backoff is replaced by backon in both locations without changing the decorator behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
frontend
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.