.github/workflows/lint.yaml

@@ -9,14 +9,15 @@ jobs:
   lint:
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13.0-rc.2"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
         os: [ubuntu-latest, windows-latest, macos-latest]
     runs-on: ${{ matrix.os }}
 
     steps:
       - uses: actions/checkout@v4
       - name: Install poetry
-        run: pipx install poetry
+        run: pipx install poetry==1.8.5
+
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}

.github/workflows/release.yaml

@@ -17,7 +17,7 @@ jobs:
 
       - run: git fetch --prune --unshallow --tags
 
-      - run: pipx install poetry
+      - run: pipx install poetry==1.8.5
 
       - name: Set up Python
         uses: actions/setup-python@v5
@@ -77,34 +77,27 @@ jobs:
           name: python-package-distributions
           path: dist/
       - name: Sign the dists with Sigstore
-        uses: sigstore/gh-action-sigstore-python@v2.1.1
+        uses: sigstore/gh-action-sigstore-python@v3.0.0
         with:
           inputs: >-
             ./dist/*.tar.gz
             ./dist/*.whl
-      - name: Upload artifact signatures to GitHub Release
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-        # Upload to GitHub Release using the `gh` CLI.
-        # `dist/` contains the built packages, and the
-        # sigstore-produced signatures and certificates.
-        run: >-
-          gh release upload
-          '${{ github.ref_name }}' dist/**
-          --repo '${{ github.repository }}'
 
   publish-docs:
     name: Publish documentation 📚 to GitHub Pages
     needs:
       - github-release
     runs-on: ubuntu-latest
 
+    permissions:
+      contents: write # IMPORTANT: mandatory for deploying to GitHub Pages
+
     steps:
       - uses: actions/checkout@v4
 
       - run: git fetch --prune --unshallow --tags
 
-      - run: pipx install poetry
+      - run: pipx install poetry==1.8.5
 
       - name: Set up Python
         uses: actions/setup-python@v5

.github/workflows/test-docs.yaml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Install poetry
-        run: pipx install poetry
+        run: pipx install poetry==1.8.5
 
       - uses: actions/setup-python@v5
         with:

.github/workflows/test.yaml

@@ -9,14 +9,14 @@ jobs:
   tests:
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13.0-rc.2"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
         os: [ubuntu-latest, windows-latest, macos-latest]
     runs-on: ${{ matrix.os }}
 
     steps:
       - uses: actions/checkout@v4
 
-      - run: pipx install poetry
+      - run: pipx install poetry==1.8.5
 
       - name: Setup Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5

README.md

@@ -48,7 +48,7 @@ An online version is generated and available [here](https://jphutchins.github.io
 
 ### Install Dependencies
 
-- poetry: https://python-poetry.org/docs/#installation
+- poetry==1.8.5: https://python-poetry.org/docs/#installation
 
 ### Create the venv
 

docs/enumeration_management.md

@@ -0,0 +1,3 @@
+# Enumeration Management
+
+::: smp.enumeration_management

mkdocs.yaml

@@ -11,6 +11,7 @@ nav:
   - Settings Management: settings_management.md
   - Shell Management: shell_management.md
   - Statistics Management: statistics_management.md
+  - Enumeration Management: enumeration_management.md
   - Zephyr Management: zephyr_management.md
   - User Groups:
       - Intercreate: user/intercreate.md

pyproject.toml

@@ -64,6 +64,7 @@ legacy_tox_ini = """
         py310
         py311
         py312
+        py313
 
     [testenv]
     allowlist_externals =

smp/enumeration_management.py

@@ -0,0 +1,159 @@
+"""The Simple Management Protocol (SMP) Enumeration Management group."""
+
+from __future__ import annotations
+
+from enum import IntEnum, unique
+from typing import Tuple
+
+from pydantic import BaseModel, ConfigDict
+
+import smp.error as smperr
+import smp.header as smphdr
+import smp.message as smpmsg
+
+
+class GroupCountRequest(smpmsg.ReadRequest):
+    """Read the number of SMP server groups.
+
+    Count of supported groups returns the total number of SMP command groups
+    that a device supports.
+    """
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.GROUP_COUNT
+
+
+class GroupCountResponse(smpmsg.ReadResponse):
+    """SMP group count response."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.GROUP_COUNT
+
+    count: int
+    """Contains the total number of supported SMP groups on the device."""
+
+
+class ListOfGroupsRequest(smpmsg.ReadRequest):
+    """List the available SMP groups."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.LIST_OF_GROUPS
+
+
+class ListOfGroupsResponse(smpmsg.ReadResponse):
+    """SMP group list response."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.LIST_OF_GROUPS
+
+    groups: Tuple[smphdr.GroupIdField, ...]
+    """Contains a list of the supported SMP group IDs on the device."""
+
+
+class GroupIdRequest(smpmsg.ReadRequest):
+    """List a SMP group by index.
+
+    Fetch single group ID command allows listing the group IDs of supported SMP
+    groups on the device, one by one.
+    """
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.GROUP_ID
+
+    index: int | None = None
+    """Contains the (0-based) index of the group to return information on, can
+    be omitted to return the first group's details.
+"""
+
+
+class GroupIdResponse(smpmsg.ReadResponse):
+    """SMP group at index response."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.GROUP_ID
+
+    group: smphdr.GroupIdField
+    """The Group ID at the requested index."""
+    end: bool | None = None
+    """Will be set to true if the listed group is the final supported group on
+    the device, otherwise will be omitted.
+    """
+
+
+class GroupDetailsRequest(smpmsg.ReadRequest):
+    """Request the details of the supported SMP groups.
+
+    Details on supported groups command allows fetching details on each
+    supported SMP group, such as the name and number of handlers. A device can
+    specify an allow list of groups to return details on or details on all
+    groups can be returned.
+
+    This command is optional, it can be enabled using
+    `CONFIG_MCUMGR_GRP_ENUM_DETAILS`. The optional name and number of handlers
+    can be enabled/disabled with `CONFIG_MCUMGR_GRP_ENUM_DETAILS_NAME` and
+    `CONFIG_MCUMGR_GRP_ENUM_DETAILS_HANDLERS`.
+    """
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.GROUP_DETAILS
+
+    groups: Tuple[smphdr.GroupIdField, ...] | None = None
+    """Contains a list of the SMP group IDs to fetch details on.
+
+    If omitted, details on all supported groups will be returned.
+    """
+
+
+class GroupDetails(BaseModel):
+    """Group Details"""
+
+    model_config = ConfigDict(extra="forbid", frozen=True)
+
+    id: smphdr.GroupIdField
+    """The group ID of the SMP command group."""
+    name: str | None = None
+    """The name of the SMP command group."""
+    handlers: int | None = None
+    """The number of handlers that the SMP command group supports."""
+
+
+class GroupDetailsResponse(smpmsg.ReadResponse):
+    """SMP group details response."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+    _COMMAND_ID = smphdr.CommandId.EnumManagement.GROUP_DETAILS
+
+    groups: Tuple[GroupDetails, ...]
+    """Contains a list of the requested SMP group details."""
+
+
+@unique
+class ENUM_MGMT_ERR(IntEnum):
+    """Return codes for the enumeration management group."""
+
+    OK = 0
+    """No error, this is implied if there is no ret value in the response."""
+
+    UNKNOWN = 1
+    """Unknown error occurred."""
+
+    ERR_TOO_MANY_GROUP_ENTRIES = 2
+    """Too many entries were provided."""
+
+    ERR_INSUFFICIENT_HEAP_FOR_ENTRIES = 3
+    """Insufficient heap memory to store entry data."""
+
+    ENUM_MGMT_ERR_INDEX_TOO_LARGE = 4
+    """Provided index is larger than the number of supported groups."""
+
+
+class EnumManagementErrorV1(smperr.ErrorV1):
+    """Error response to a enumeration management command."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT
+
+
+class EnumManagementErrorV2(smperr.ErrorV2[ENUM_MGMT_ERR]):
+    """Error response to a enumeration management command."""
+
+    _GROUP_ID = smphdr.GroupId.ENUM_MANAGEMENT