mersal 0.1.0__tar.gz

mersal-0.1.0/.gitignore

@@ -0,0 +1,196 @@
+
+# Created by https://www.toptal.com/developers/gitignore/api/python,emacs
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,emacs
+
+*.DS_Store
+### Emacs ###
+# -*- mode: gitignore; -*-
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Org-mode
+.org-id-locations
+*_archive
+
+# flymake-mode
+*_flymake.*
+
+# eshell files
+/eshell/history
+/eshell/lastdir
+
+# elpa packages
+/elpa/
+
+# reftex files
+*.rel
+
+# AUCTeX auto folder
+/auto/
+
+# cask packages
+.cask/
+dist/
+
+# Flycheck
+flycheck_*.el
+
+# server auth directory
+/server/
+
+# projectiles files
+.projectile
+
+# directory configuration
+.dir-locals.el
+
+# network security
+/network-security.data
+
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# End of https://www.toptal.com/developers/gitignore/api/python,emacs

mersal-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,53 @@
+default_language_version:
+  python: "3.13"
+repos:
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.0.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-ast
+      - id: check-case-conflict
+      - id: check-toml
+      - id: debug-statements
+        exclude: ^(core/src/mersal/retry/default_retry_step\.py)$
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.0
+    hooks:
+      - id: ruff
+        args: ["--fix", "--config", "pyproject.toml"]
+      - id: ruff-format
+        args: ["--config", "pyproject.toml"]
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
+        additional_dependencies:
+          - tomli
+  - repo: https://github.com/python-formate/flake8-dunder-all
+    rev: v0.4.1
+    hooks:
+      - id: ensure-dunder-all
+        args: ["--use-tuple"]
+  # - repo: https://github.com/ariebovenberg/slotscheck
+  #   rev: v0.19.1
+  #   hooks:
+  #     - id: slotscheck
+  #       exclude: "docs|.github"
+  - repo: https://github.com/sphinx-contrib/sphinx-lint
+    rev: "v1.0.0"
+    hooks:
+      - id: sphinx-lint
+  # - repo: local
+  #   hooks:
+  #     - id: pypi-readme
+  #       name: pypi-readme
+  #       language: python
+  #       entry: python tools/pypi_readme.py
+  #       types: [markdown]

mersal-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

mersal-0.1.0/Makefile

@@ -0,0 +1,254 @@
+SHELL := /bin/bash
+
+# =============================================================================
+# Configuration and Environment Variables
+# =============================================================================
+
+.DEFAULT_GOAL := help
+.ONESHELL:
+.EXPORT_ALL_VARIABLES:
+MAKEFLAGS += --no-print-directory
+
+# -----------------------------------------------------------------------------
+# Display Formatting and Colors
+# -----------------------------------------------------------------------------
+BLUE := $(shell printf "\033[1;34m")
+GREEN := $(shell printf "\033[1;32m")
+RED := $(shell printf "\033[1;31m")
+YELLOW := $(shell printf "\033[1;33m")
+NC := $(shell printf "\033[0m")
+INFO := $(shell printf "$(BLUE)ℹ$(NC)")
+OK := $(shell printf "$(GREEN)✓$(NC)")
+WARN := $(shell printf "$(YELLOW)⚠$(NC)")
+ERROR := $(shell printf "$(RED)✖$(NC)")
+
+# =============================================================================
+# Help and Documentation
+# =============================================================================
+
+.PHONY: help
+help:                                               ## Display this help text for Makefile
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z0-9_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+# =============================================================================
+# Installation and Environment Setup
+# =============================================================================
+
+.PHONY: install-uv
+install-uv:                                         ## Install latest version of uv
+	@echo "${INFO} Installing uv..."
+	@curl -LsSf https://astral.sh/uv/install.sh | sh >/dev/null 2>&1
+	@echo "${OK} UV installed successfully"
+
+.PHONY: install
+install: destroy clean                              ## Install the project, dependencies, and pre-commit
+	@echo "${INFO} Starting fresh installation..."
+	@uv python pin 3.13 >/dev/null 2>&1
+	@uv venv >/dev/null 2>&1
+	@uv sync --all-extras --dev --all-packages
+	@echo "${OK} Installation complete! 🎉"
+
+.PHONY: destroy
+destroy:                                            ## Destroy the virtual environment
+	@echo "${INFO} Destroying virtual environment... 🗑️"
+	@uv run pre-commit clean >/dev/null 2>&1
+	@rm -rf .venv
+	@echo "${OK} Virtual environment destroyed 🗑️"
+
+# =============================================================================
+# Dependency Management
+# =============================================================================
+
+.PHONY: upgrade
+upgrade:                                            ## Upgrade all dependencies to latest stable versions
+	@echo "${INFO} Updating all dependencies... 🔄"
+	@uv lock --upgrade
+	@echo "${OK} Dependencies updated 🔄"
+	@uv run pre-commit autoupdate
+	@echo "${OK} Updated Pre-commit hooks 🔄"
+
+.PHONY: lock
+lock:                                              ## Rebuild lockfiles from scratch
+	@echo "${INFO} Rebuilding lockfiles... 🔄"
+	@uv lock --upgrade >/dev/null 2>&1
+	@echo "${OK} Lockfiles updated"
+
+# =============================================================================
+# Build and Release
+# =============================================================================
+
+.PHONY: build
+build:                                             ## Build the package
+	@echo "${INFO} Building package... 📦"
+	@uv build --all-packages >/dev/null 2>&1
+	@echo "${OK} Package build complete"
+
+.PHONY: release
+release:                                           ## Bump version and create release tag
+	@echo "${INFO} Preparing for release... 📦"
+	@make docs
+	@make clean
+	@make build
+	@uv lock --upgrade-package litestar-vite >/dev/null 2>&1
+	@uv run bump-my-version bump $(bump)
+	@echo "${OK} Release complete 🎉"
+
+# =============================================================================
+# Cleaning and Maintenance
+# =============================================================================
+
+.PHONY: clean
+clean:                                              ## Cleanup temporary build artifacts
+	@echo "${INFO} Cleaning working directory... 🧹"
+	@rm -rf .pytest_cache .ruff_cache .hypothesis build/ -rf dist/ .eggs/ .coverage coverage.xml coverage.json htmlcov/ .pytest_cache tests/.pytest_cache tests/**/.pytest_cache .mypy_cache .unasyncd_cache/ .auto_pytabs_cache >/dev/null 2>&1
+	@find . -name '*.egg-info' -exec rm -rf {} + >/dev/null 2>&1
+	@find . -type f -name '*.egg' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*.pyc' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*.pyo' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '*~' -exec rm -f {} + >/dev/null 2>&1
+	@find . -name '__pycache__' -exec rm -rf {} + >/dev/null 2>&1
+	@find . -name '.ipynb_checkpoints' -exec rm -rf {} + >/dev/null 2>&1
+	@echo "${OK} Working directory cleaned"
+	$(MAKE) docs-clean
+
+# =============================================================================
+# Testing and Quality Checks
+# =============================================================================
+
+.PHONY: test
+test:                                               ## Run the tests
+	@echo "${INFO} Running core test cases... 🧪"
+	@uv run pytest core/tests
+	@echo "${OK} Core Tests complete ✨"
+
+.PHONY: test-litestar
+test-litestar:            			              	## Run the mersal_litestar tests
+	@echo "${INFO} Running mersal_litestar test cases... 🧪"
+	@uv run --package=mersal_litestar pytest  packages/mersal_litestar/tests
+	@echo "${OK} Mersal_Litestar Tests complete ✨"
+
+.PHONY: test-polling
+test-polling:            			              	## Run the mersal_polling tests
+	@echo "${INFO} Running mersal_polling test cases... 🧪"
+	@uv run --package=mersal_polling pytest packages/mersal_polling/tests
+	@echo "${OK} Mersal_Polling Tests complete ✨"
+
+.PHONY: test-sqlalchemy
+test-sqlalchemy:            			              	## Run the mersal_alchemy tests
+	@echo "${INFO} Running mersal_alchemy test cases... 🧪"
+	@uv run --package=mersal_alchemy pytest packages/mersal_alchemy/tests
+	@echo "${OK} Mersal_Alchemy Tests complete ✨"
+
+.PHONY: test-msgspec
+test-msgspec:            			              	## Run the mersal_msgspec tests
+	@echo "${INFO} Running mersal_msgspec test cases... 🧪"
+	@uv run --package=mersal_msgspec pytest packages/mersal_msgspec/tests
+	@echo "${OK} Mersal_Msgspec Tests complete ✨"
+
+.PHONY: test-examples
+test-examples:            			              	## Run the doc examples tests
+	@echo "${INFO} Running doc examples test cases... 🧪"
+	@uv run --package=mersal_docs pytest docs/examples/tests
+	@echo "${OK} Doc Examples Tests complete ✨"
+
+.PHONY: test-all
+test-all: test test-litestar test-polling test-sqlalchemy test-msgspec # test-examples ## Run all tests
+	@echo "${INFO} All tests executed successfully ✨"
+
+# .PHONY: coverage
+# coverage:                                           ## Run tests with coverage report
+# 	@echo "${INFO} Running tests with coverage... 📊"
+# 	@uv run pytest --cov -n auto --quiet
+# 	@uv run coverage html >/dev/null 2>&1
+# 	@uv run coverage xml >/dev/null 2>&1
+# 	@echo "${OK} Coverage report generated ✨"
+
+# -----------------------------------------------------------------------------
+# Type Checking
+# -----------------------------------------------------------------------------
+
+.PHONY: mypy
+mypy:                                               ## Run mypy
+	@echo "${INFO} Running mypy... 🔍"
+	@uv run dmypy run
+	@echo "${OK} Mypy checks passed ✨"
+
+.PHONY: pyright
+pyright:                                            ## Run pyright
+	@echo "${INFO} Running basedpyright... 🔍"
+	@uv run basedpyright
+	@echo "${OK} basedpyright checks passed ✨"
+
+.PHONY: type-check
+type-check: mypy pyright                            ## Run all type checking
+
+# -----------------------------------------------------------------------------
+# Linting and Formatting
+# -----------------------------------------------------------------------------
+
+.PHONY: pre-commit
+pre-commit:                                        ## Run pre-commit hooks
+	@echo "${INFO} Running pre-commit checks... 🔎"
+	@uv run pre-commit run --color=always --all-files
+	@echo "${OK} Pre-commit checks passed ✨"
+
+# .PHONY: slotscheck
+# slotscheck:                                        ## Run slotscheck
+# 	@echo "${INFO} Running slotscheck... 🔍"
+# 	@uv run slotscheck core/src
+# 	@uv run slotscheck packages/mersal_polling/src
+# 	@uv run slotscheck packages/mersal_alchemy/src
+# 	@uv run slotscheck packages/mersal_litestar/src
+# 	@uv run slotscheck packages/mersal_msgspec/src
+# 	@echo "${OK} Slotscheck complete ✨"
+
+.PHONY: fix
+fix:                                               ## Run code formatters
+	@echo "${INFO} Running code formatters... 🔧"
+	@uv run ruff check --fix --unsafe-fixes
+	@uv run ruff format
+	@echo "${OK} Code formatting complete ✨"
+
+.PHONY: lint
+lint: fix pre-commit type-check # slotscheck             ## Run all linting checks
+	@echo "${OK} All linting checks passed ✨"
+
+.PHONY: check-all
+check-all: lint test-all # coverage                  ## Run all checks (lint, test, coverage)
+	@echo "${OK} All checks passed successfully ✨"
+# =============================================================================
+# Documentation
+# =============================================================================
+
+.PHONY: docs-clean
+docs-clean:                                        ## Clean documentation build
+	@echo "${INFO} Cleaning documentation build assets... 🧹"
+	@rm -rf docs/_build >/dev/null 2>&1
+	@echo "${OK} Documentation assets cleaned"
+
+.PHONY: docs-serve
+docs-serve: docs-clean                             ## Serve documentation locally
+	@echo "${INFO} Starting documentation server... 📚"
+	@uv run sphinx-autobuild docs docs/_build/ -j auto --watch core --watch packages --watch docs --watch CONTRIBUTING.rst --port 8002
+
+.PHONY: docs
+docs: docs-clean                                   ## Build documentation
+	@echo "${INFO} Building documentation... 📝"
+	@uv run sphinx-build -M html docs docs/_build/ -E -a -j auto -W --keep-going >/dev/null 2>&1
+	@echo "${OK} Documentation built successfully"
+
+.PHONY: docs-linkcheck
+docs-linkcheck:                                    ## Check documentation links
+	@echo "${INFO} Checking documentation links... 🔗"
+	@uv run sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_ignore='http://.*','https://.*'
+	@echo "${OK} Link check complete"
+
+.PHONY: docs-linkcheck-full
+docs-linkcheck-full:                               ## Run full documentation link check
+	@echo "${INFO} Running full link check... 🔗"
+	@uv run sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_anchors=0
+	@echo "${OK} Full link check complete"
+
+# =============================================================================
+# End of Makefile
+# =============================================================================

mersal-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: mersal
+Version: 0.1.0
+Summary: A service bus library.
+Author-email: Abdulhaq Emhemmed <abdulhaq.emhemmed@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4.8.0
+Description-Content-Type: text/x-rst
+
+Mersal
+=======
+
+**Mersal** is a service bus library for Python.

mersal-0.1.0/README.rst

@@ -0,0 +1,4 @@
+Mersal
+=======
+
+**Mersal** is a service bus library for Python.

mersal-0.1.0/core/README.md

@@ -0,0 +1,3 @@
+# mersal
+
+Describe your project here.

mersal-0.1.0/core/src/mersal/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

mersal-0.1.0/core/src/mersal/_activation/builtin_handler_activator.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+from collections import defaultdict
+from typing import TYPE_CHECKING, TypeVar, cast
+
+from mersal.pipeline import MessageContext
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+    from mersal._activation.handler_activator import HandlerFactory
+    from mersal.app import Mersal
+    from mersal.handlers import MessageHandler
+    from mersal.transport import TransactionContext
+
+# Define locally to avoid import cycle with handler_activator.py
+MessageT = TypeVar("MessageT")
+
+__all__ = ("BuiltinHandlerActivator",)
+
+
+class BuiltinHandlerActivator:
+    """Default implementation of the handler activator pattern.
+
+    This class manages the registration and activation of message handlers
+    based on message types. It stores handler factories indexed by message type
+    and instantiates the appropriate handlers when a message needs to be processed.
+    """
+
+    def __init__(self) -> None:
+        """Initialize a new instance of the BuiltinHandlerActivator."""
+        self._handler_factories: dict[type, list[HandlerFactory]] = defaultdict(list)
+        self._app: Mersal | None = None
+
+    async def get_handlers(
+        self,
+        message: MessageT,
+        transaction_context: TransactionContext,
+    ) -> Sequence[MessageHandler[MessageT]]:
+        """Get handlers for the specified message.
+
+        Args:
+            message: The message to get handlers for
+            transaction_context: The current transaction context
+
+        Returns:
+            A sequence of message handlers that can process the message
+
+        Raises:
+            Exception: If called outside of a message context
+        """
+        message_context = MessageContext.current()
+        if not message_context:
+            raise Exception(
+                "BuiltinHandlerActivator get_handlers called outside of a transaction.",
+            )
+
+        return [x(message_context, self.app) for x in self._handler_factories.get(type(message), [])]
+
+    def register(
+        self,
+        message_type: type[MessageT],
+        factory: HandlerFactory[MessageT],
+    ) -> BuiltinHandlerActivator:
+        """Register a handler factory for a specific message type.
+
+        Args:
+            message_type: The type of message to register a handler for
+            factory: A factory function that creates a message handler
+
+        Returns:
+            The handler activator instance for method chaining
+        """
+        self._handler_factories[message_type].append(factory)
+        return self
+
+    @property
+    def registered_message_types(self) -> set[type]:
+        """Get the set of message types that have registered handlers.
+
+        Returns:
+            A set containing all registered message types
+        """
+        return set(self._handler_factories.keys())
+
+    @property
+    def app(self) -> Mersal:
+        """Get the associated application instance.
+
+        Returns:
+            The Mersal application instance
+        """
+        return cast("Mersal", self._app)
+
+    @app.setter
+    def app(self, value: Mersal) -> None:
+        """Set the associated application instance.
+
+        Args:
+            value: The Mersal application instance
+        """
+        self._app = value