prepare version 4.1.0

Author: javipalanca

HISTORY.rst

@@ -2,6 +2,22 @@
 History
 =======
 
+4.1.0 (2025-05-22)
+---------------------
+
+* XMPP server is now auto launched transparently with agents.
+* Added support for Python 3.13.
+* Added end2end tests.
+* Memory database integration for the XMPP server.
+* Server parameter configurations improved.
+* Enhanced presence management and subscription process.
+* Added embedded server capability for examples.
+* Dropped Python 3.8 support.
+* Added overloadable presence_received handler.
+* Fixed slixmpp address kwarg error.
+* Improved type hints and code structure in agent and message modules.
+
+
 4.0.3 (2025-02-17)
 --------------------
 * Prepare XMPP messages linked to client stream.

docs/usage.rst

@@ -28,6 +28,7 @@ launched, managed during the coroutine's lifespan, and deleted once it finishes.
                     coroutine   |
                                 |
                             Server Flag
+
 This is the preferred method for launching SPADE scripts, as it eliminates the need for the user to install or manage any external server.
 
 
@@ -68,7 +69,8 @@ This approach is useful for more complex MAS integrations and for obtaining a de
     A valid JID would be something like *agent1@localhost* or *[email protected]*
 
 Dedicated XMPP server
-####################
+#####################
+
 Any XMPP server can be used with the SPADE platform. *Prosody* is a well-tested solution with SPADE,
 but there is a wide range of popular servers with large communities.
 
@@ -114,7 +116,7 @@ To create an agent in a project you just need to: ::
 This agent is only printing on screen a message during its setup and stopping. If you run this script you get
 the following output
 
-.. code-block:: bash
+.. code-block:: console
 
     $ python dummyagent.py
     Hello World! I'm agent dummy@localhost

pyproject.toml

@@ -21,11 +21,11 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Operating System :: MacOS :: MacOS X",
     "Operating System :: POSIX :: Linux",
     "Operating System :: Microsoft :: Windows",

setup.py

@@ -59,7 +59,8 @@ def parse_requirements(filename):
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
-        "Programming Language :: Python :: 3.13" "Operating System :: MacOS :: MacOS X",
+        "Programming Language :: Python :: 3.13",
+        "Operating System :: MacOS :: MacOS X",
         "Operating System :: POSIX :: Linux",
         "Operating System :: Microsoft :: Windows",
         "Topic :: Scientific/Engineering :: Artificial Intelligence",

spade/agent.py

@@ -171,7 +171,7 @@ async def _async_connect(self) -> None:  # pragma: no cover
             )
             self.client.add_event_handler("message", self._message_received)
 
-            if slixmpp_version <= '1.9.1':
+            if slixmpp_version <= "1.9.1":
                 self.client.connect(address=(self.jid.host, self.xmpp_port))
             else:
                 self.client.connect(host=self.jid.host, port=self.xmpp_port)

spade/container.py

@@ -30,7 +30,7 @@ def get_or_create_eventloop():  # pragma: no cover
     # Use uvloop or winloop if available
     if platform.system() == "Windows":
         try:
-            import winloop   # pyright: ignore[reportMissingImports]
+            import winloop  # pyright: ignore[reportMissingImports]
 
             asyncio.set_event_loop_policy(winloop.EventLoopPolicy())
         except ImportError:

spade/message.py

@@ -1,5 +1,5 @@
 import logging
-from typing import Optional, Dict, Type, Union
+from typing import Optional, Dict, Union
 
 import slixmpp.stanza
 from slixmpp import ClientXMPP
@@ -12,7 +12,7 @@
 
 
 class MessageBase(object):
-    """ """
+    """Base class for message handling in SPADE."""
 
     def __init__(
         self,
@@ -22,7 +22,6 @@ def __init__(
         thread: Optional[str] = None,
         metadata: Optional[Dict[str, str]] = None,
     ):
-
         self.sent = False
         self.to = to  # type: ignore
         self.sender = sender  # type: ignore