Add NatsBroker.new_inbox()

[maxalbert]

Fixes #1542

Type of change

Please delete options that are not relevant.

• Documentation (typos, code examples, or any documentation updates)
• New feature (a non-breaking change that adds functionality)

Checklist

• My code adheres to the style guidelines of this project (scripts/lint.sh shows no errors)
• I have conducted a self-review of my own code
• I have made the necessary changes to the documentation
• My changes do not generate any new warnings
• I have added tests to validate the effectiveness of my fix or the functionality of my new feature
• Both new and existing unit tests pass successfully on my local environment by running scripts/test-cov.sh
• I have ensured that static analysis tests are passing by running scripts/static-analysis.sh

(Note: regarding the last item, running mypy produced 24 errors but they are all related to the confluent broker and not to my changes.)

[Lancetnik]

You should add assert here to check, that the broker is already connected (and ignore this asset by noseq)

[maxalbert]

Thanks for the hint. I only saw this comment after I added a check which raises a RuntimeError. Please let me know if you'd like me to use a regular assert statement instead.

[Lancetnik]

Please, use assert in this case. I prefer to use switchable checks for development.

[maxalbert]

Gotcha, done. Out of curiosity, what do you mean by using "switchable checks for development"?

[maxalbert]

FYI, I added one more line to the docstring (to mention NatsBroker's inbox_prefix argument) and merged the latest changes from main to bring the branch up to date.