/aiocoap

The Python CoAP library

Primary LanguagePythonOtherNOASSERTION

aiocoap -- The Python CoAP library

The aiocoap package is a Python implementation of CoAP, the Constrained Application Protocl (RFC 7252, more info at http://coap.technology/).

It uses the asyncio module introduced in Python 3.4 to facilitate concurrent operations while maintaining a simple to use interface and not depending on anything outside the standard library.

aiocoap is originally based on txThings. If you want to use CoAP in your existing twisted application, or can not migrate to Python 3 yet, that is probably more useful to you than aiocoap.

Usage

For details on how to usethe aiocoap library, have a look at the :mod:`aiocoap` module documentation, or at the :doc:`examples` and :doc:`tools` provided.

All examples can be run directly from a source code copy. If you prefer to install it, the usual Python mechanisms apply.

Development

aiocoap tries to stay close to PEP8 recommendations and general best practice, and should thus be easy to contribute to. Unit tests are implemented in the ./tests/ directory; complete test coverage is aimed for, but not yet complete (and might never be, as the error handling for pathological network partners is hard to trigger with a library designed not to missbehave).

Documentation is built using sphinx; hacks used there are described in ./doc/README.doc.

Bugs from design goal and wishlist to typos are currently tracked in github (see below).

Relevant URLs

Licensing

aiocoap is published under the MIT License, see :doc:`LICENSE` for details.

Copyright (c) 2012-2014 Maciej Wasilak <http://sixpinetrees.blogspot.com/>,
2013-2014 Christian Amsüss <c.amsuess@energyharvesting.at>