Merge branch 'release/4.0.4'

* release/4.0.4: (39 commits)
  feat: add Dockerfile for multi-version Python setup and update devcontainer configuration
  prepare version 4.1.0
  Bump version: 4.0.3 → 4.1.0
  fix: correct quotes in bumpversion configuration for setup.py
  refactor: improve type hints and code structure in agent and message modules; update pyjabber dependency
  fix slixmpp address kwarg error + keep backwards compatibility
  fix format
  fix lint
  use of memory database. Will work with the new pyjabber release
  windows unittest timeout
  bad format label python matrix version
  drop python 3.8 support
  use of embedded server for examples
  fixed slixmpp JID problem with comparator
  fix lint
  fix slixmpp.JID cast to spade use + fix messagebase match
  update requirements and fix message equality check in tests
  hotfix
  hotfix server fixture
  hotfix unittest presence
  ...

Author: javipalanca

.devcontainer/Dockerfile

@@ -0,0 +1,34 @@
+FROM ubuntu:22.04
+
+# Instalar versiones de Python 3.9, 3.10, 3.11 y 3.12
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -y software-properties-common \
+    && add-apt-repository -y ppa:deadsnakes/ppa \
+    && apt-get update \
+    && apt-get install -y python3.9 python3.10 python3.11 python3.12 \
+    && apt-get install -y python3-pip \
+    # Instalar distutils y setuptools para todas las versiones de Python
+    && apt-get install -y python3-distutils python3-setuptools \
+    && apt-get install -y python3.9-distutils python3.10-distutils python3.11-distutils python3.12-distutils \
+    && apt-get install -y python3.9-dev python3.10-dev python3.11-dev python3.12-dev
+
+# establecer Python 3.12 como predeterminado
+RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1 \
+    && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2 \
+    && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 3 \
+    && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 4
+
+# Actualizar pip y setuptools
+RUN pip install --upgrade pip setuptools wheel
+
+# Instalar tox
+RUN pip install tox
+
+# Establecer directorio de trabajo
+WORKDIR /workspaces/spade
+
+# No copiar requirements.txt (esto se hará después del montaje)
+# Los archivos se montarán automáticamente desde tu directorio local
+
+# Establecer Python 3.12 como predeterminado
+ENV PYTHONPATH=/workspaces/spade

.devcontainer/devcontainer.json

@@ -3,21 +3,25 @@
 {
 	"name": "SPADE Python 3",
 	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	//"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	"dockerFile": "Dockerfile",
 
 	// Features to add to the dev container. More info: https://containers.dev/features.
 	// "features": {},
 
+
 	// Use 'forwardPorts' to make a list of ports inside the container available locally.
 	// "forwardPorts": [],
 
 	// Use 'postCreateCommand' to run commands after the container is created.
-    "postCreateCommand": "chmod +x .devcontainer/postcreate.sh && .devcontainer/postcreate.sh",
+    "postCreateCommand": "pip install -e .[dev] || pip install -r requirements.txt -r requirements_dev.txt || echo 'No se pudieron instalar las dependencias automáticamente'",
 	// Configure tool-specific properties.
 	"customizations": {
 		"vscode": {
             "extensions": [
-                "GitHub.copilot"
+                "GitHub.copilot",
+				"ms-python.python",
+				"gitlens.vscode-gitlens"
             ]
         }
 	}

.devcontainer/postcreate.sh

@@ -34,29 +34,22 @@ jobs:
       fail-fast: false
       matrix:
         name:
-          - "ubuntu-py38"
           - "ubuntu-py39"
           - "ubuntu-py310"
           - "ubuntu-py311"
           - "ubuntu-py312"
 
-          - "macos-py38"
           - "macos-py39"
           - "macos-py310"
           - "macos-py311"
           - "macos-py312"
 
-          - "windows-py38"
           - "windows-py39"
           - "windows-py310"
           - "windows-py311"
           - "windows-py312"
 
         include:
-          - name: "ubuntu-py38"
-            python: "3.8"
-            os: ubuntu-latest
-            tox_env: "py38"
           - name: "ubuntu-py39"
             python: "3.9"
             os: ubuntu-latest
@@ -74,10 +67,6 @@ jobs:
             os: ubuntu-latest
             tox_env: "py312"
 
-          - name: "macos-py38"
-            python: "3.8"
-            os: macos-latest
-            tox_env: "py38"
           - name: "macos-py39"
             python: "3.9"
             os: macos-latest
@@ -95,10 +84,6 @@ jobs:
             os: macos-latest
             tox_env: "py312"
 
-          - name: "windows-py38"
-            python: "3.8"
-            os: windows-latest
-            tox_env: "py38"
           - name: "windows-py39"
             python: "3.9"
             os: windows-latest
@@ -140,7 +125,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
     steps:
     - uses: actions/checkout@v2
     - name: Set up Python ${{ matrix.python-version }}

.github/workflows/python-package.yml

@@ -62,3 +62,6 @@ target/
 .python-version
 /.ipynb_checkpoints/
 /.pytest_cache/
+
+# pyjabberdb
+pyjabber.db

.gitignore

@@ -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.

HISTORY.rst

@@ -54,6 +54,9 @@ clean-test: ## remove test and coverage artifacts
 lint: ## check style with flake8
 	ruff check spade tests
 
+format: ## format code with black
+	ruff format spade tests
+
 test: ## run tests quickly with the default Python
 	pytest
 

Makefile

@@ -12,7 +12,7 @@
 #
 # All configuration values have a default; values that are commented out
 # serve to show the default.
-
+import spade
 import sys
 import os
 
@@ -31,7 +31,6 @@
 # version is used.
 sys.path.insert(0, project_root)
 
-import spade
 
 # -- General configuration ---------------------------------------------
 
@@ -40,23 +39,27 @@
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode', 'sphinx.ext.autosectionlabel']
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.viewcode",
+    "sphinx.ext.autosectionlabel",
+]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ".rst"
 
 # The encoding of source files.
 # source_encoding = 'utf-8-sig'
 
 # The master toctree document.
-master_doc = 'index'
+master_doc = "index"
 
 # General information about the project.
-project = u'SPADE'
-copyright = u"2020, Javi Palanca"
+project = "SPADE"
+copyright = "2020, Javi Palanca"
 
 # The version info for the project you're documenting, acts as replacement
 # for |version| and |release|, also used in various other places throughout
@@ -79,7 +82,7 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = ["_build"]
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
@@ -97,7 +100,7 @@
 # show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = "sphinx"
 
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
@@ -111,7 +114,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'sphinx_rtd_theme'
+html_theme = "sphinx_rtd_theme"
 
 # Theme options are theme-specific and customize the look and feel of a
 # theme further.  For a list of options available for each theme, see the
@@ -142,7 +145,7 @@
 # here, relative to this directory. They are copied after the builtin
 # static files, so a file named "default.css" will overwrite the builtin
 # "default.css".
-html_static_path = ['_static']
+html_static_path = ["_static"]
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page
 # bottom, using the given strftime format.
@@ -188,17 +191,15 @@
 # html_file_suffix = None
 
 # Output file base name for HTML help builder.
-htmlhelp_basename = 'spadedoc'
+htmlhelp_basename = "spadedoc"
 
 # -- Options for LaTeX output ------------------------------------------
 
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
     # 'papersize': 'letterpaper',
-
     # The font size ('10pt', '11pt' or '12pt').
     # 'pointsize': '10pt',
-
     # Additional stuff for the LaTeX preamble.
     # 'preamble': '',
 }
@@ -207,9 +208,7 @@
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
-    ('index', 'spade.tex',
-     u'SPADE Documentation',
-     u'Javi Palanca', 'manual'),
+    ("index", "spade.tex", "SPADE Documentation", "Javi Palanca", "manual"),
 ]
 
 # The name of an image file (relative to this directory) to place at
@@ -237,11 +236,7 @@
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'spade',
-     u'SPADE Documentation',
-     [u'Javi Palanca'], 1)
-]
+man_pages = [("index", "spade", "SPADE Documentation", ["Javi Palanca"], 1)]
 
 # If true, show URL addresses after external links.
 # man_show_urls = False
@@ -253,12 +248,15 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    ('index', 'spade',
-     u'SPADE Documentation',
-     u'Javi Palanca',
-     'spade',
-     'Smart Python multi-Agent Development Environment.',
-     'Artificial Intelligence'),
+    (
+        "index",
+        "spade",
+        "SPADE Documentation",
+        "Javi Palanca",
+        "spade",
+        "Smart Python multi-Agent Development Environment.",
+        "Artificial Intelligence",
+    ),
 ]
 
 # Documents to append as an appendix to all manuals.