The aiocoap API¶
In preparation for a semantically versioned 1.0 release, some parts of aiocoap are described as stable.
The library does not try to map the distinction between “public API” and
internal components in the sense of semantic versioning to Python’s “public”
and “private” (
_-prefixed) interaces – tying those together would mean
intrusive refactoring every time a previously internal mechanism is stabilized.
Neither does it only document the public API, as that would mean that library development would need to resort to working with code comments; that would also impede experimentation, and migrating comments to docstrings would be intrusive again. All modules’ documentation can be searched or accedd via modindex.
Instead, functions, methods and properties in the library should only be considered public (in the semantic versioning sense) if they are described as “stable” in their documentation. The documentation may limit how an interface may used or what can be expected from it. (For example, while a method may be typed to return a particular class, the stable API may only guarantee that an instance of a particular abstract base class is returned).
__all__ attributes of aiocoap modules try to represent semantic
publicality of its members (in accordance with PEP8); however, the
documentation is the authoritative source.
Modules with stable components¶
- aiocoap module
- aiocoap.protocol module
- aiocoap.message module
- aiocoap.options module
- aiocoap.interfaces module
- aiocoap.error module
- aiocoap.defaults module
- aiocoap.transports module
- aiocoap.proxy module
- aiocoap.proxy.client module
- aiocoap.proxy.server module
- aiocoap.numbers module
- aiocoap.optiontypes module
- aiocoap.resource module
- aiocoap.dump module
- aiocoap.util module
- aiocoap.util.asyncio module
- aiocoap.util.cli module
- aiocoap.util.socknumbers module
- aiocoap.util.secrets module
- aiocoap.util.uri module
- aiocoap.cli module
- aiocoap.oscore module