swarmauri_certs_composite 0.3.0.dev3

Feature-routing certificate service for Swarmauri

---

Swarmauri Certs Composite

Routing certificate service delegating to child providers based on requested features.

Installation

pip install swarmauri_certs_composite

Usage

The composite accepts a sequence of certificate service implementations and routes each call to the first provider that advertises a matching capability. Below is a minimal example using two toy providers:

from swarmauri_certs_composite import CompositeCertService
from swarmauri_base.certs.CertServiceBase import CertServiceBase


class SelfSignedOnly(CertServiceBase):

    def supports(self):
        return {"features": ("self_signed",)}

    async def create_self_signed(self, key, subject, **kw):
        return b"self-signed-cert"


class CsrOnly(CertServiceBase):

    def supports(self):
        return {"features": ("csr",)}

    async def create_csr(self, key, subject, **kw):
        return b"csr-data"


svc = CompositeCertService([SelfSignedOnly(), CsrOnly()])

# create a self-signed certificate - routed to SelfSignedOnly
cert = await svc.create_self_signed("key", {"CN": "example"})

# create a CSR and explicitly route to the second provider by class name
csr = await svc.create_csr("key", {"CN": "example"}, opts={"backend": "CsrOnly"})

supports() aggregates the advertised features of all child providers, allowing callers to inspect available capabilities before invoking them.

Entry point

The provider is registered under the swarmauri.certs entry-point as CompositeCertService.