amqp-client-python 0.2.0__tar.gz → 0.2.1.dev1__tar.gz

amqp_client_python-0.2.1.dev1/.env.example

@@ -0,0 +1,22 @@
+RABBITMQ_SSL=FALSE
+
+# RABBITMQ_CERT_PATH:       RabbitMQ Certificate
+#                           default value: .certs/analytics/cert.pem
+#
+#                           To generate self-signed certificates,
+#                           use the ./create-self-signed-certs.sh script.
+RABBITMQ_CERT_PATH=.certs/analytics/rabbitmq_cert.pem
+
+# RABBITMQ_KEY_PATH:        RabbitMQ Key
+#                           default value: .certs/analytics/key.pem
+#
+#                           To generate self-signed certificates,
+#                           use the ./create-self-signed-certs.sh script.
+RABBITMQ_KEY_PATH=.certs/analytics/rabbitmq_key.pem
+
+# RABBITMQ_CA_PATH:         RabbitMQ Certificate of the Authentication entity (CA)
+#                           default value: .certs/analytics/ca.pem
+#
+#                           To generate self-signed certificates,
+#                           use the ./create-self-signed-certs.sh script.
+RABBITMQ_CA_PATH=.certs/analytics/ca.pem

amqp_client_python-0.2.1.dev1/.flake8

@@ -0,0 +1,6 @@
+[flake8]
+ignore = E722, W503, E402
+max-line-length = 120
+per-file-ignores =
+    conftest.py
+    __init__.py: F401

amqp_client_python-0.2.1.dev1/.github/workflows/lint.yml

@@ -0,0 +1,33 @@
+# This workflow will install Python dependencies, run tests and lint with a single version of Python
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Lint
+
+on:
+  push:
+    branches: [ "master", "develop" ]
+  pull_request:
+    branches: [ "master", "develop" ]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python 3.8
+      uses: actions/setup-python@v3
+      with:
+        python-version: "3.8"
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 amqp_client_python/ --ignore=E722,W503,E402 --count --max-line-length=127 --statistics

amqp_client_python-0.2.1.dev1/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - name: Install Poetry
+      uses: snok/install-poetry@v1
+    - name: Build and publish
+      env:
+        PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+      run: |
+        poetry config pypi-token.pypi $PYPI_TOKEN
+        poetry build
+        poetry publish

amqp_client_python-0.2.1.dev1/.github/workflows/test.yml

@@ -0,0 +1,64 @@
+# This workflow will install Python dependencies, run tests and lint with a single version of Python
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Tests
+
+on:
+  push:
+    branches: [ "master", "develop" ]
+  pull_request:
+    branches: [ "master", "develop" ]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+    - name: Generate self-signed certificates
+      run: |
+        # Make the script executable and run it
+        chmod +x ./create-self-signed-certs.sh
+        ./create-self-signed-certs.sh
+
+    - name: Start RabbitMQ container manually
+      run: |
+        # We start the container manually as a step to ensure that the certificate
+        # and config files exist on the host before we try to mount them.
+        docker run -d --name rabbitmq \
+          -p 5672:5672 \
+          -p 5671:5671 \
+          -v ${{ github.workspace }}/.certs/rabbitmq:/etc/ssl:ro \
+          -v ${{ github.workspace }}/external_config/rabbitmq/rabbitmq.conf:/etc/rabbitmq/rabbitmq.conf:ro \
+          -e RABBITMQ_DEFAULT_USER=guest \
+          -e RABBITMQ_DEFAULT_PASS=guest \
+          rabbitmq:3-management-alpine
+    - name: Wait for RabbitMQ to start
+      run: |
+        echo "Waiting for RabbitMQ to initialize..."
+        # Give the container time to start up and apply the configuration.
+        sleep 8
+    - name: Set up Python 3.8
+      uses: actions/setup-python@v3
+      with:
+        python-version: "3.8"
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pytest pika coverage
+        if [ -f dev_requirements.txt ]; then pip install -r dev_requirements.txt; fi
+    - name: Run unit tests with coverage
+      run: |
+        coverage run --source=amqp_client_python -m pytest -v tests/unit/
+    - name: Run integration tests with coverage
+      run: |
+        coverage run --append --source=amqp_client_python -m pytest -v tests/integration/
+      env:
+        AMQP_DOMAIN: localhost
+    - name: Generate and show combined coverage report
+      run: |
+        coverage report --show-missing

amqp_client_python-0.2.1.dev1/.github/workflows/type.yml

@@ -0,0 +1,19 @@
+name: Python Type Checking
+
+on: [push, pull_request]
+
+jobs:
+  mypy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install mypy
+    - name: Run mypy
+      run: mypy amqp_client_python/

amqp_client_python-0.2.1.dev1/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+node_modules/
+dist/*
+.certs/
+.config/
+*_env/
+site/

amqp_client_python-0.2.1.dev1/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+-   repo: https://github.com/ambv/black
+    rev: 23.1.0
+    hooks:
+    - id: black
+      language_version: python3.8
+      stages: [commit]
+-   repo: https://github.com/PyCQA/flake8
+    rev: 6.0.0
+    hooks:
+    - id: flake8
+      stages: [commit]
+-   repo: local
+    hooks:
+      - id: requirements
+        name: requirements
+        entry: bash -c 'dev_env/bin/pip3 freeze > dev_requirements.txt; git add dev_requirements.txt'
+        language: system
+        pass_filenames: false
+        stages: [commit]

amqp_client_python-0.2.1.dev1/.readthedocs.yaml

@@ -0,0 +1,33 @@
+version: 2
+
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.8"
+  jobs:
+    post_create_environment:
+      - pip install poetry
+      - poetry config virtualenvs.create false
+    post_install:
+      - pip install --only doc
+    # You can also specify other tool versions:
+    # nodejs: "19"
+    # rust: "1.64"
+    # golang: "1.19"
+
+# Build documentation in the "docs/" directory with Sphinx
+mkdocs:
+   configuration: mkdocs.yml
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#    - pdf
+#    - epub
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+# python:
+#    install:
+#    - requirements: docs/requirements.txt

amqp_client_python-0.2.1.dev1/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "[python]": {
+        "editor.defaultFormatter": "ms-python.autopep8"
+    },
+    "python.formatting.provider": "none"
+}

amqp_client_python-0.2.1.dev1/CODE_OF_CONDUCT.md

@@ -0,0 +1,22 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender identity, sexual orientation, disability, personal appearance, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing others' private information, such as physical or electronic addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at our [discord channel](https://discord.gg/RkXNeZpNZk). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.1, available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/PKG-INFO

@@ -1,38 +1,40 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: amqp-client-python
-Version: 0.2.0
+Version: 0.2.1.dev1
 Summary: Python AMQP Client Library
-Home-page: https://github.com/nutes-uepb/amqp-client-python
+Project-URL: Homepage, https://github.com/nutes-uepb/amqp-client-python
+Project-URL: Repository, https://github.com/nutes-uepb/amqp-client-python
+Project-URL: Bug Tracker, https://github.com/nutes-uepb/amqp-client-python/issues
+Project-URL: Source, https://github.com/nutes-uepb/amqp-client-python
+Author-email: NUTES UEPB <dev.seniorsaudemovel@gmail.com>
+Maintainer-email: "João Pedro Miranda C. Hluchan" <berrytern@gmail.com>
 License: Apache-2.0
-Keywords: packaging,dependency,amqp-client-python
-Author: NUTES UEPB
-Author-email: dev.seniorsaudemovel@gmail.com
-Requires-Python: >=3.7,<4.0
+License-File: LICENSE
+Keywords: amqp-client-python,dependency,packaging
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Communications
 Classifier: Topic :: Internet
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Networking
-Requires-Dist: pika (>=1.3.0,<2.0.0)
-Project-URL: Bug Tracker, https://github.com/nutes-uepb/amqp-client-python/issues
-Project-URL: Repository, https://github.com/nutes-uepb/amqp-client-python
+Requires-Python: <4.0,>=3.9
+Requires-Dist: pika<2.0.0,>=1.3.0
 Description-Content-Type: text/markdown
 
 # AMQP Client Python
 
-Client with high level of abstraction for manipulation of messages in the event bus RabbitMQ.
+A Python client providing a high-level abstraction for interacting with RabbitMQ, simplifying message publishing, subscribing, and RPC patterns.
 
 --------
 
@@ -53,6 +55,18 @@ Client with high level of abstraction for manipulation of messages in the event
 
 **Source Code**: <a href="https://github.com/nutes-uepb/amqp-client-python" target="_blank">https://github.com/nutes-uepb/amqp-client-python</a>
 
+**Discord Server**: <a href="https://discord.gg/RkXNeZpNZk" target="_blank">https://discord.gg/RkXNeZpNZk</a>
+
+### 🦀 Looking for higher performance? Try `amqp-rs`!
+If you need higher throughput, thread safety, and built-in compression, check out [**amqp-rs**](https://pypi.org/project/amqp-rs/).
+
+It is a high-performance Python extension developed in Rust using PyO3 and `tokio`. It shares a similar API and design philosophy with this library, but adds native thread safety, `zstd`/`zlib`/`lz4` compression, robust TLS/SSL support, and graceful shutdowns. 
+
+You can install it via `pip` or `uv`:
+```bash
+pip install amqp-rs
+```
+
 ---
 ### Features:
 - Automatic creation and management of queues, exchanges and channels;
@@ -69,6 +83,18 @@ Client with high level of abstraction for manipulation of messages in the event
 | 0.2.0 | 0.2.0 |
 | 0.1.14 | ~0.1.12 |
 
+### Installation
+
+You can install `amqp-client-python` using pip:
+```bash
+pip install amqp-client-python
+```
+
+### Prerequisites
+
+*   Python 3.7+
+*   A running RabbitMQ instance.
+
 ### Examples:
 #### you can use [sync](https://github.com/nutes-uepb/amqp-client-python/blob/develop/amqp_client_python/rabbitmq/eventbus_rabbitmq.py) , [async eventbus](https://github.com/nutes-uepb/amqp-client-python/blob/develop/amqp_client_python/rabbitmq/async_eventbus_rabbitmq.py) and [sync wrapper](https://github.com/nutes-uepb/amqp-client-python/blob/develop/amqp_client_python/rabbitmq/eventbus_wrapper_rabbitmq.py) of async eventbus
 <details><summary>async usage </summary>
@@ -229,4 +255,4 @@ When using [**EventbusRabbitMQ**](https://github.com/nutes-uepb/amqp-client-pyth
 [known-vulnerabilities-image]: https://snyk.io/test/github/nutes-uepb/amqp-client-python/badge.svg?targetFile=requirements.txt
 [known-vulnerabilities-url]: https://snyk.io/test/github/nutes-uepb/amqp-client-python?targetFile=requirements.txt
 [releases-image]: https://img.shields.io/github/release-date/nutes-uepb/amqp-client-python.svg
-[releases-url]: https://github.com/nutes-uepb/amqp-client-python/releases
+[releases-url]: https://github.com/nutes-uepb/amqp-client-python/releases

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/README.md

@@ -1,6 +1,6 @@
 # AMQP Client Python
 
-Client with high level of abstraction for manipulation of messages in the event bus RabbitMQ.
+A Python client providing a high-level abstraction for interacting with RabbitMQ, simplifying message publishing, subscribing, and RPC patterns.
 
 --------
 
@@ -21,6 +21,18 @@ Client with high level of abstraction for manipulation of messages in the event
 
 **Source Code**: <a href="https://github.com/nutes-uepb/amqp-client-python" target="_blank">https://github.com/nutes-uepb/amqp-client-python</a>
 
+**Discord Server**: <a href="https://discord.gg/RkXNeZpNZk" target="_blank">https://discord.gg/RkXNeZpNZk</a>
+
+### 🦀 Looking for higher performance? Try `amqp-rs`!
+If you need higher throughput, thread safety, and built-in compression, check out [**amqp-rs**](https://pypi.org/project/amqp-rs/).
+
+It is a high-performance Python extension developed in Rust using PyO3 and `tokio`. It shares a similar API and design philosophy with this library, but adds native thread safety, `zstd`/`zlib`/`lz4` compression, robust TLS/SSL support, and graceful shutdowns. 
+
+You can install it via `pip` or `uv`:
+```bash
+pip install amqp-rs
+```
+
 ---
 ### Features:
 - Automatic creation and management of queues, exchanges and channels;
@@ -37,6 +49,18 @@ Client with high level of abstraction for manipulation of messages in the event
 | 0.2.0 | 0.2.0 |
 | 0.1.14 | ~0.1.12 |
 
+### Installation
+
+You can install `amqp-client-python` using pip:
+```bash
+pip install amqp-client-python
+```
+
+### Prerequisites
+
+*   Python 3.7+
+*   A running RabbitMQ instance.
+
 ### Examples:
 #### you can use [sync](https://github.com/nutes-uepb/amqp-client-python/blob/develop/amqp_client_python/rabbitmq/eventbus_rabbitmq.py) , [async eventbus](https://github.com/nutes-uepb/amqp-client-python/blob/develop/amqp_client_python/rabbitmq/async_eventbus_rabbitmq.py) and [sync wrapper](https://github.com/nutes-uepb/amqp-client-python/blob/develop/amqp_client_python/rabbitmq/eventbus_wrapper_rabbitmq.py) of async eventbus
 <details><summary>async usage </summary>

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/__init__.py

@@ -2,3 +2,14 @@ from .rabbitmq import EventbusRabbitMQ, AsyncEventbusRabbitMQ, EventbusWrapperRa
 from .domain.models import Config, Options, SSLOptions
 from .domain.utils import ConnectionType
 from pika import DeliveryMode
+
+__all__ = [
+    "EventbusRabbitMQ",
+    "AsyncEventbusRabbitMQ",
+    "EventbusWrapperRabbitMQ",
+    "Config",
+    "Options",
+    "SSLOptions",
+    "ConnectionType",
+    "DeliveryMode",
+]

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/domain/models/__init__.py

@@ -1,3 +1,9 @@
 from .config import Config
 from .options import Options
 from .ssl_options import SSLOptions
+
+__all__ = [
+    "Config",
+    "Options",
+    "SSLOptions",
+]

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/domain/models/config.py

@@ -10,15 +10,11 @@ class Config:
         self, options: Options, ssl_options: Optional[SSLOptions] = None
     ) -> None:
         """
-        Create an Config object thats hold and mount the connection information.
+        Create a Config object that holds and manages the connection information.
 
         Args:
-            options: hold information for estabilish connection
-            ssl_options: hold information for estabilish SSL connections
-
-        Returns:
-
-        Raises:
+            options: holds information for establishing connection
+            ssl_options: holds information for establishing SSL connections
 
         Examples:
             >>> Config(
@@ -32,16 +28,13 @@ class Config:
 
     def build(self) -> "Config":
         """
-        Create an Config object thats hold and mount the connection information.
-
-        Args:
+        Create a Config object that holds and manages the connection information.
 
         Returns:
             Config object
 
-        Raises:
-
         Examples:
+            >>> # config = Config(...)
             >>> config.build()
         """
         opt = {

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/domain/models/options.py

@@ -18,7 +18,7 @@ class Options:
         **kwargs: Dict[str, Any]
     ) -> None:
         """
-        Create an Options object that hold the credentials and configs options.
+        Create an Options object that holds the credentials and configuration options.
 
         Args:
             queue_name: name of queue that will be used for subscriptions
@@ -34,10 +34,6 @@ class Options:
             publisher_confirms: wait for publisher confirmations
             **kwargs: pika options
 
-        Returns:
-
-        Raises:
-
         Examples:
             >>> Options("example", "example.rpc", "example.rpc", "amqp://admin:admin@localhost:5672/")
 

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/domain/models/ssl_options.py

@@ -3,18 +3,13 @@ class SSLOptions:
         self, certfile_path: str, keyfile_path: str, ca_certs_path: str
     ) -> None:
         """
-        Create an SslOptions object that hold the certs paths.
+        Create an SslOptions object that holds the cert paths.
 
         Args:
             certfile_path: cert file path string
             keyfile_path: private key file path string
             ca_certs_path: ca file path string
 
-        Returns:
-            Um dicionário com as notas da escala e os graus.
-
-        Raises:
-
         Examples:
             >>> SSLOptions("./.certs/cert.pem", "./.certs/privkey.pem", "./.certs/ca.pem")
         """

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/domain/utils/__init__.py

@@ -1,2 +1,7 @@
 from .connection_type import ConnectionType
 from .types import HandlerType
+
+__all__ = [
+    "ConnectionType",
+    "HandlerType",
+]

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/event/__init__.py

@@ -4,3 +4,12 @@ from .async_provider_handler import AsyncProviderHandler
 from .async_subscriber_handler import AsyncSubscriberHandler
 from .provider_handler import ProviderHandler
 from .subscriber_handler import SubscriberHandler
+
+__all__ = [
+    "IntegrationEvent",
+    "IntegrationEventHandler",
+    "AsyncProviderHandler",
+    "AsyncSubscriberHandler",
+    "ProviderHandler",
+    "SubscriberHandler",
+]

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/exceptions/__init__.py

@@ -7,3 +7,15 @@ from .publish_timeout_exception import PublishTimeoutException
 from .auto_reconnect_exception import AutoReconnectException
 from .blocking_exception import BlockingException
 from .thread_unsafe_exception import ThreadUnsafeException
+
+__all__ = [
+    "EventBusException",
+    "NackException",
+    "RpcProviderException",
+    "TimeoutException",
+    "ResponseTimeoutException",
+    "PublishTimeoutException",
+    "AutoReconnectException",
+    "BlockingException",
+    "ThreadUnsafeException",
+]

{amqp_client_python-0.2.0 → amqp_client_python-0.2.1.dev1}/amqp_client_python/rabbitmq/__init__.py

@@ -1,6 +1,6 @@
 from .async_eventbus_rabbitmq import AsyncEventbusRabbitMQ
 from .async_connection_factory import AsyncConnectionFactoryRabbitMQ
-from .async_connection import AsyncConnection, ConnectionType
+from .async_connection import AsyncConnection
 from .async_channel_factory import AsyncChannelFactoryRabbitMQ
 from .async_channel import AsyncChannel
 from .eventbus_rabbitmq import EventbusRabbitMQ
@@ -9,3 +9,17 @@ from .connection_rabbitmq import ConnectionRabbitMQ
 from .channel_factory_rabbitmq import ChannelFactoryRabbitMQ
 from .channel_rabbitmq import ChannelRabbitMQ
 from .eventbus_wrapper_rabbitmq import EventbusWrapperRabbitMQ
+
+__all__ = [
+    "AsyncEventbusRabbitMQ",
+    "AsyncConnectionFactoryRabbitMQ",
+    "AsyncConnection",
+    "AsyncChannelFactoryRabbitMQ",
+    "AsyncChannel",
+    "EventbusRabbitMQ",
+    "ConnectionFactoryRabbitMQ",
+    "ConnectionRabbitMQ",
+    "ChannelFactoryRabbitMQ",
+    "ChannelRabbitMQ",
+    "EventbusWrapperRabbitMQ",
+]