neuroglia-python 0.1.3__tar.gz → 0.1.4__tar.gz

{neuroglia_python-0.1.3 → neuroglia_python-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: neuroglia-python
-Version: 0.1.3
+Version: 0.1.4
 Summary: Port from .NET to Python of the Neuroglia Framework
 License: Apache
 Author: Charles d'Avernas
@@ -13,19 +13,19 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: annotated-types (>0.6.0)
 Requires-Dist: classy-fastapi (>=0.6.1,<0.7.0)
 Requires-Dist: esdbclient (>1)
-Requires-Dist: fastapi (>=0.115.12,<0.116.0)
+Requires-Dist: fastapi (>=0)
 Requires-Dist: grpcio (>=1.71)
 Requires-Dist: httpx (>=0.28.1,<0.29.0)
-Requires-Dist: mkdocs (>=1.6.1,<2.0.0)
-Requires-Dist: mkdocs-material (>=9.5.46,<10.0.0)
+Requires-Dist: mkdocs (>=1.6.1)
+Requires-Dist: mkdocs-material (>=9.5.46)
 Requires-Dist: multipledispatch (>=1.0.0,<2.0.0)
-Requires-Dist: pydantic-settings (>=2.2.0,<3.0.0)
-Requires-Dist: pymongo (>=4.6.1,<5.0.0)
-Requires-Dist: pytest (>=8.1.1,<9.0.0)
+Requires-Dist: pydantic-settings (>=2)
+Requires-Dist: pymongo (>=4.6.3)
+Requires-Dist: pytest (>=8.1.1)
 Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
-Requires-Dist: rx (>=3.2.0,<4.0.0)
-Requires-Dist: typing-extensions (>=4.9.0,<5.0.0)
-Requires-Dist: uvicorn (>=0.34.0,<0.35.0)
+Requires-Dist: rx (>=3.2.0)
+Requires-Dist: typing-extensions (>=4.9.0)
+Requires-Dist: uvicorn (>=0.34.0)
 Description-Content-Type: text/markdown
 
 # Neuroglia Python Framework
@@ -69,12 +69,16 @@ This project was the opportunity for me (cdavernas) to learn Python while portin
 ## Packaging
 
 ```sh
+# Set `package-mode = true` in pyproject.toml
 # Set the version tag in pyproject.toml
 # Commit changes
-
+# Create API Token in pypi.org...
+# Configure credentials for pypi registry:
+poetry config pypi-token.pypi  {pypi-....mytoken}
+# Build package locally
 poetry build
-
-poetry publish --repository gitlab -u <token-username> -p <token-password>
+# Publish package to pypi.org:
+poetry publish
 
 ```
 

{neuroglia_python-0.1.3 → neuroglia_python-0.1.4}/README.md

@@ -39,11 +39,15 @@ This project was the opportunity for me (cdavernas) to learn Python while portin
 ## Packaging
 
 ```sh
+# Set `package-mode = true` in pyproject.toml
 # Set the version tag in pyproject.toml
 # Commit changes
-
+# Create API Token in pypi.org...
+# Configure credentials for pypi registry:
+poetry config pypi-token.pypi  {pypi-....mytoken}
+# Build package locally
 poetry build
-
-poetry publish --repository gitlab -u <token-username> -p <token-password>
+# Publish package to pypi.org:
+poetry publish
 
 ```

{neuroglia_python-0.1.3 → neuroglia_python-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "neuroglia-python"
-version = "0.1.3"
+version = "0.1.4"
 description = "Port from .NET to Python of the Neuroglia Framework"
 authors = ["Charles d'Avernas <charles.davernas@neuroglia.io>"]
 license = "Apache"
@@ -15,19 +15,19 @@ python = "^3.12"
 annotated-types = ">0.6.0"
 classy-fastapi = "^0.6.1"
 esdbclient = ">1"
-fastapi = "^0.115.12"
+fastapi = ">=0"
 grpcio = ">=1.71"
 httpx = "^0.28.1"
 multipledispatch = "^1.0.0"
-pydantic-settings = "^2.2.0"
-pymongo = "^4.6.1"
+pydantic-settings = ">=2"
+pymongo = ">=4.6.3"
 python-dotenv = "^1.0.1"
-rx = "^3.2.0"
-uvicorn = "^0.34.0"
-typing-extensions = "^4.9.0"
-pytest = "^8.1.1"
-mkdocs = "^1.6.1"
-mkdocs-material = "^9.5.46"
+rx = ">=3.2.0"
+uvicorn = ">=0.34.0"
+typing-extensions = ">=4.9.0"
+pytest = ">=8.1.1"
+mkdocs = ">=1.6.1"
+mkdocs-material = ">=9.5.46"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.0.1"

neuroglia_python-0.1.4/src/neuroglia/eventing/cloud_events/cloud_event.py

@@ -0,0 +1,83 @@
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Any, Optional, Union, Dict
+
+
+class CloudEventSpecVersion:
+    """Exposes all supported versions of the Cloud Event Specification"""
+
+    v1_0: str = "1.0"
+    """ Gets the version '1.0' of the Cloud Event Specification """
+
+
+@dataclass
+class CloudEvent:
+    """
+    Represents a Cloud Event.
+
+    Attributes:
+        id (str): A string that uniquely identifies the cloud event in the scope of its source.
+        specversion (str): The version of the CloudEvents specification which the event uses. Defaults to '1.0'.
+        time (Optional[datetime]): The date and time at which the event has been produced.
+        source (str): The cloud event's source.
+        type (str): The cloud event's type.
+        subject (Optional[str]): A value that describes the subject of the event in the context of the event producer.
+        datacontenttype (Optional[str]): The cloud event's data content type. Defaults to 'application/json'.
+        dataschema (Optional[str]): An URI that references the versioned schema of the event's data.
+        data (Optional[Any]): The event's data, if any. Only used if the event has been formatted using the structured mode.
+        data_base64 (Optional[str]): The event's binary data, encoded in base 64. Used if the event has been formatted using the binary mode.
+        extensionAttributes (Optional[Dict[str, Any]]): A mapping containing the event's extension attributes.
+    """
+
+    id: str
+    """ Gets/sets string that uniquely identifies the cloud event in the scope of its source. """
+
+    source: str
+    """ Gets/sets the cloud event's source. Must be an absolute URI. """
+
+    type: str
+    """ Gets/sets the cloud event's source. Should be a reverse DNS domain name, which must only contain lowercase alphanumeric, '-' and '.' characters. """
+
+    specversion: str = "1.0"  # Default value for specversion
+    """ Gets/sets the version of the CloudEvents specification which the event uses. Defaults to '1.0'. """
+
+    sequencetype: Optional[str] = None
+    """ Gets/sets the type of the sequence. """
+
+    sequence: Optional[int] = None
+    """ Gets/sets the sequence of the event. """
+
+    time: Optional[datetime] = None
+    """ Gets/sets the date and time at which the event has been produced. """
+
+    subject: Optional[str] = None
+    """ Gets/sets value that describes the subject of the event in the context of the event producer. """
+
+    datacontenttype: Optional[str] = "application/json"  # Default value for datacontenttype
+    """ Gets/sets the cloud event's data content type. Defaults to 'application/json'. """
+
+    dataschema: Optional[str] = None
+    """ Gets/sets an URI, if any, that references the versioned schema of the event's data. """
+
+    data: Optional[Any] = None
+    """ Gets/sets the event's data, if any. Only used if the event has been formatted using the structured mode. """
+
+    data_base64: Optional[str] = None
+    """ Gets/sets the event's binary data, encoded in base 64. Used if the event has been formatted using the binary mode. """
+
+    _extra_attributes: Dict[str, Any] = field(default_factory=dict, repr=False)
+
+    def __init__(self, **kwargs):
+        self._extra_attributes = {}
+        for key, value in kwargs.items():
+            if key in CloudEvent.__dataclass_fields__:
+                setattr(self, key, value)
+            else:
+                self._extra_attributes[key] = value
+        super().__init__()
+
+    def get_attribute(self, name: str) -> Optional[Any]:
+        """Gets the value of the attribute with the specified name, if any"""
+        if not name:
+            raise ValueError("Attribute name cannot be empty or None.")
+        return self.__dict__[name] if name in self.__dict__.keys() else None

{neuroglia_python-0.1.3 → neuroglia_python-0.1.4}/src/neuroglia/eventing/cloud_events/infrastructure/cloud_event_middleware.py

@@ -8,7 +8,7 @@ from starlette.middleware.base import BaseHTTPMiddleware
 
 
 class CloudEventMiddleware(BaseHTTPMiddleware):
-    ''' Represents the HTTP middleware used to handle incoming cloud events '''
+    """Represents the HTTP middleware used to handle incoming cloud events"""
 
     def __init__(self, app, service_provider: ServiceProviderBase):
         super().__init__(app)
@@ -17,17 +17,17 @@ class CloudEventMiddleware(BaseHTTPMiddleware):
         self.cloud_event_bus = self.service_provider.get_required_service(CloudEventBus)
 
     service_provider: ServiceProviderBase
-    ''' Gets the current service provider '''
+    """ Gets the current service provider """
 
     cloud_event_bus: CloudEventBus
-    ''' Gets the service used to stream the application's incoming and outgoing cloud events '''
+    """ Gets the service used to stream the application's incoming and outgoing cloud events """
 
     serializer: JsonSerializer
-    ''' Gets the service used to serialize/deserialize values to/from JSON '''
+    """ Gets the service used to serialize/deserialize values to/from JSON """
 
     async def dispatch(self, request: Request, call_next):
-        content_type = request.headers.get('content-type', None)
-        if content_type is None or not content_type.startswith('application/cloudevents+json'):
+        content_type = request.headers.get("content-type", None)
+        if content_type is None or not content_type.startswith("application/cloudevents+json"):
             return await call_next(request)
         try:
             attributes = self.serializer.deserialize(await request.body(), dict)

neuroglia_python-0.1.3/src/neuroglia/eventing/cloud_events/cloud_event.py

@@ -1,72 +0,0 @@
-from dataclasses import dataclass
-from datetime import datetime
-from typing import Any, Optional
-
-
-class CloudEventSpecVersion:
-    ''' Exposes all supported versions of the Cloud Event Specification '''
-
-    v1_0: str = "1.0"
-    ''' Gets the version '1.0' of the Cloud Event Specification '''
-
-
-@dataclass
-class CloudEvent:
-    '''
-    Represents a Cloud Event.
-
-    Attributes:
-        id (str): A string that uniquely identifies the cloud event in the scope of its source.
-        specversion (str): The version of the CloudEvents specification which the event uses. Defaults to '1.0'.
-        time (Optional[datetime]): The date and time at which the event has been produced.
-        source (str): The cloud event's source.
-        type (str): The cloud event's type.
-        subject (Optional[str]): A value that describes the subject of the event in the context of the event producer.
-        datacontenttype (Optional[str]): The cloud event's data content type. Defaults to 'application/json'.
-        dataschema (Optional[str]): An URI that references the versioned schema of the event's data.
-        data (Optional[Any]): The event's data, if any. Only used if the event has been formatted using the structured mode.
-        data_base64 (Optional[str]): The event's binary data, encoded in base 64. Used if the event has been formatted using the binary mode.
-        extensionAttributes (Optional[Dict[str, Any]]): A mapping containing the event's extension attributes.
-    '''
-
-    id: str
-    ''' Gets/sets string that uniquely identifies the cloud event in the scope of its source. '''
-
-    source: str
-    ''' Gets/sets the cloud event's source. Must be an absolute URI. '''
-
-    type: str
-    ''' Gets/sets the cloud event's source. Should be a reverse DNS domain name, which must only contain lowercase alphanumeric, '-' and '.' characters. '''
-
-    specversion: str = '1.0'  # Default value for specversion
-    ''' Gets/sets the version of the CloudEvents specification which the event uses. Defaults to '1.0'. '''
-
-    sequencetype: Optional[str] = None
-    ''' Gets/sets the type of the sequence. '''
-
-    sequence: Optional[int] = None
-    ''' Gets/sets the sequence of the event. '''
-
-    time: Optional[datetime] = None
-    ''' Gets/sets the date and time at which the event has been produced. '''
-
-    subject: Optional[str] = None
-    ''' Gets/sets value that describes the subject of the event in the context of the event producer. '''
-
-    datacontenttype: Optional[str] = 'application/json'  # Default value for datacontenttype
-    ''' Gets/sets the cloud event's data content type. Defaults to 'application/json'. '''
-
-    dataschema: Optional[str] = None
-    ''' Gets/sets an URI, if any, that references the versioned schema of the event's data. '''
-
-    data: Optional[Any] = None
-    ''' Gets/sets the event's data, if any. Only used if the event has been formatted using the structured mode. '''
-
-    data_base64: Optional[str] = None
-    ''' Gets/sets the event's binary data, encoded in base 64. Used if the event has been formatted using the binary mode. '''
-
-    def get_attribute(self, name: str) -> Optional[Any]:
-        ''' Gets the value of the attribute with the specified name, if any '''
-        if not name:
-            raise ValueError("Attribute name cannot be empty or None.")
-        self.__dict__[name] if name in self.__dict__.keys() else None