Add native delayed delivery API to kombu

[thedrow]

This PR adds the native delayed delivery API to kombu so that it can be used without Celery if required.
The PR includes an example on how to do so.

[Nusnus]

1. Add official documentation.
2. Make sure the CI passes.
3. Make sure you're rebased on main.

Also, I'm not sure about kombu.native_delayed_delivery. Shouldn't it be in the RabbitMQ transport layer?

This feature is relevant only for RabbitMQ so it should be in the matching place in the code IMHO.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 80.50%. Comparing base (96a497e) to head (9a8f525).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2128      +/-   ##
==========================================
+ Coverage   80.33%   80.50%   +0.17%     
==========================================
  Files          75       76       +1     
  Lines        9125     9179      +54     
  Branches     1350     1125     -225     
==========================================
+ Hits         7331     7390      +59     
- Misses       1600     1601       +1     
+ Partials      194      188       -6     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[thedrow]

I thought about it and I prefer to keep the API in a separate module.
I included the example in our list of examples and added a short description which is enough documentation for most users.

The pre-commit check is failing for unrelated reasons.

[Nusnus]

I thought about it and I prefer to keep the API in a separate module.
I included the example in our list of examples and added a short description which is enough documentation for most users.

The pre-commit check is failing for unrelated reasons.

There's no problem leaving it in a separate module, but correct me if I'm wrong, this is a transport layer feature, so it should be in the transport.

This is a cosmetic change.

Apart from that, please add the version string to the docs with v5.5 (Current 5.4.2).

We don't expect any patch release soon so the next minor release will include your new feature.

Besides LGTM, thank you!

[auvipy]

yes, Native Delayed Delivery API is to Transport layer, so logically, this should be inside the transport

Addressed code review

[Nusnus]

Thank you for explaining @thedrow , but next time please just ping me here so I’ll review the fixes and approve the PR instead.
I need to confirm my review comments are resolved, or it loses its entire point 🤷‍♂️

Please pay attention next time, thank you.