{"id":13705004,"url":"https://github.com/chrysn/aiocoap","last_synced_at":"2025-05-14T01:02:47.216Z","repository":{"id":17679687,"uuid":"20484530","full_name":"chrysn/aiocoap","owner":"chrysn","description":"The Python CoAP library","archived":false,"fork":false,"pushed_at":"2025-03-20T16:56:47.000Z","size":4177,"stargazers_count":270,"open_issues_count":150,"forks_count":123,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-04-03T11:41:26.002Z","etag":null,"topics":["asyncio","coap","internet-of-things","oscore","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chrysn.png","metadata":{"files":{"readme":"README.rst","changelog":"NEWS.rst","contributing":null,"funding":null,"license":"LICENSES/BSD-3-Clause.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-06-04T13:22:46.000Z","updated_at":"2025-03-28T17:43:37.000Z","dependencies_parsed_at":"2022-08-07T09:00:10.445Z","dependency_job_id":"2ba1031f-1524-4d04-a943-132161f890df","html_url":"https://github.com/chrysn/aiocoap","commit_stats":{"total_commits":2176,"total_committers":29,"mean_commits":75.03448275862068,"dds":0.04365808823529416,"last_synced_commit":"a1d55fa8e14db99c5729c43bdc11ea7bb84fa90e"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrysn%2Faiocoap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrysn%2Faiocoap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrysn%2Faiocoap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrysn%2Faiocoap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chrysn","download_url":"https://codeload.github.com/chrysn/aiocoap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248252659,"owners_count":21072699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asyncio","coap","internet-of-things","oscore","python"],"created_at":"2024-08-02T22:00:29.708Z","updated_at":"2025-04-10T16:22:49.826Z","avatar_url":"https://github.com/chrysn.png","language":"Python","funding_links":[],"categories":["Libraries"],"sub_categories":["Python"],"readme":".. meta::\n  :copyright: SPDX-FileCopyrightText: Christian Amsüss and the aiocoap contributors\n  :copyright: SPDX-License-Identifier: MIT\n\naiocoap -- The Python CoAP library\n==================================\n\nThe aiocoap package is an implementation of CoAP, the `Constrained Application\nProtocol`_. It facilitates writing applications that talk to\nnetwork enabled embedded (\"IoT\" / \"Internet of Things\") devices.\n\nIt is written in Python 3 using its `native asyncio`_ methods to facilitate\nconcurrent operations while maintaining an easy to use interface.\n\n.. _`Constrained Application Protocol`: http://coap.space/\n.. _`native asyncio`: https://docs.python.org/3/library/asyncio\n\nUsage\n-----\n\nFor how to use the aiocoap library, have a look at the guidedtour_, or at\nthe examples_ and tools_ provided.\n\nA full reference is available in the  `API documentation`_.\n\nAll examples can be run directly from a source code copy. If you prefer to\ninstall it, the usual Python mechanisms apply (see installation_).\n\n.. _`API documentation`: http://aiocoap.readthedocs.io/en/latest/api.html\n\nFeatures / Standards\n--------------------\n\nThis library supports the following standards in full or partially:\n\n* RFC7252_ (CoAP): Supported for clients and servers. Multicast is supported on\n  the server side, and partially for clients. DTLS is supported but experimental,\n  and lacking some security properties. No caching is done inside the library.\n* RFC7641_ (Observe): Basic support for clients and servers. Reordering,\n  re-registration, and active cancellation are missing.\n* RFC7959_ (Blockwise): Supported both for atomic and random access.\n* RFC8323_ (TCP, WebSockets): Supports CoAP over TCP, TLS, and WebSockets (both\n  over HTTP and HTTPS). The TLS parts are server-certificate only;\n  preshared, raw public keys and client certificates are not supported yet.\n* RFC7967_ (No-Response): Supported.\n* RFC8132_ (PATCH/FETCH): Types and codes known, FETCH observation supported.\n* RFC9176_: A standalone resource directory\n  server is provided along with a library function to register at one. They\n  lack support for groups and security considerations, and are generally rather\n  simplistic.\n* RFC8613_ (OSCORE): Full support client-side; protected servers can be\n  implemented based on it but are not automatic yet.\n* draft-ietf-core-oscore-groupcomm-23_ (Group OSCORE): Supported for both group\n  and pairwise mode in groups that are fully known. (The lack of an implemented\n  joining or persistence mechanism makes this impractical for anything but\n  experimentation.)\n* RFC9528_ (EDHOC): Experimental and rudimentary support for configured peers\n  using the lakers_ implementation.\n\nIf something described by one of the standards but not implemented, it is\nconsidered a bug; please file at the `github issue tracker`_. (If it's not on\nthe list or in the excluded items, file a wishlist item at the same location).\n\n.. _RFC7252: https://tools.ietf.org/html/rfc7252\n.. _RFC7641: https://tools.ietf.org/html/rfc7641\n.. _RFC7959: https://tools.ietf.org/html/rfc7959\n.. _RFC7967: https://tools.ietf.org/html/rfc7967\n.. _RFC8132: https://tools.ietf.org/html/rfc8132\n.. _RFC8323: https://tools.ietf.org/html/rfc8323\n.. _RFC8613: https://tools.ietf.org/html/rfc8613\n.. _RFC9176: https://tools.ietf.org/html/rfc9176\n.. _RFC9528: https://tools.ietf.org/html/rfc9528\n.. _draft-ietf-core-oscore-groupcomm-23: https://tools.ietf.org/html/draft-ietf-core-oscore-groupcomm-23\n.. _lakers: https://pypi.org/project/lakers-python/\n\nDependencies\n------------\n\nBasic aiocoap works out of the box on Python_ 3.10 or newer (also works on\nPyPy3_). For full support (DTLS, OSCORE and link-format handling) follow the\ninstallation_ instructions as these require additional libraries.\n\naiocoap provides different network backends for different platforms. The most\nfeatureful backend is available for Linux, but most operations work on BSDs,\nWindows and macOS as well. See the FAQ_ for more details.\n\nIf your library depends on aiocoap, it should pick the required extras (as per\ninstallation_) and declare a dependency like ``aiocoap[linkheader,oscore] \u003e= 0.4b2``.\n\n.. _Python: https://www.python.org/\n.. _PyPy3: http://pypy.org/\n.. _FAQ: http://aiocoap.readthedocs.io/en/latest/faq.html\n\nDevelopment\n-----------\n\naiocoap tries to stay close to PEP8_ recommendations and general best practice,\nand should thus be easy to contribute to.\n\nBugs (ranging from \"design goal\" and \"wishlist\" to typos) are currently tracked\nin the `github issue tracker`_. Pull requests are welcome there; if you start\nworking on larger changes, please coordinate on the issue tracker.\n\nSecurity critical bugs may instead be reported in private to \u003cchrysn@fsfe.org\u003e\n(`PGP key`_) for coordinated disclosure; the maintainer reserves the right to\npublish fixes ahead of a planned embargo time at he deems suitable.\n\nDocumentation is built using sphinx_ with ``python3 -m sphinx doc/ ${TARGET}``;\nhacks used there are described in ``./doc/README.doc``.\n\nUnit tests are implemented in the ``./tests/`` directory and easiest run using\ntox_ (but also available through ``python3 -m unittest`` to test the local environment);\ncomplete test coverage is aimed for, but not yet complete (and might never be,\nas the error handling for pathological network partners is hard to trigger with\na library designed not to misbehave). The tests are regularly run at the `CI\nsuite at codeberg`_, from where `coverage reports`_ are available.\n\n.. _PEP8: http://legacy.python.org/dev/peps/pep-0008/\n.. _sphinx: http://sphinx-doc.org/\n.. _`github issue tracker`: https://github.com/chrysn/aiocoap/issues\n.. _`CI suite at codeberg`: https://ci.codeberg.org/repos/12879\n.. _`coverage reports`: https://aiocoap.codeberg.page/aiocoap/coverage/\n.. _tox: https://tox.readthedocs.io/\n.. _`PGP key`: https://christian.amsuess.com/pgp\n\nRelevant URLs\n-------------\n\n* https://codeberg.org/aiocoap/aiocoap\n\n  This is where the latest source code can be found.\n  Generally, this serves as the project web site.\n\n* http://aiocoap.readthedocs.org/\n\n  Online documentation built from the sources.\n\n* https://coap.space/\n\n  Further general information on CoAP, the standard documents involved, and\n  other implementations and tools available.\n\nLicensing\n---------\n\naiocoap is published under the MIT License, and follows the best practice of `reuse.software`_.\nFiles in ``aiocoap/util/vendored/`` may have different (but compatible and OSI approved) licenses.\n\nWhen using aiocoap for a publication, please cite it according to the output of\n``./setup.py cite [--bibtex]``.\n\nCopyright Christian Amsüss and the aiocoap contributors.\n\naiocoap was originally based on txThings_ by Maciej Wasilak.\nThe full list of aiocoap contributors can be obtained from the version control history.\n\n.. Any filtering by a mailmap would apply, but no need to state that unless we do get a mailmap.\n\n.. _guidedtour: http://aiocoap.readthedocs.io/en/latest/guidedtour.html\n.. _examples: http://aiocoap.readthedocs.io/en/latest/examples.html\n.. _tools: http://aiocoap.readthedocs.io/en/latest/tools.html\n.. _installation: http://aiocoap.readthedocs.io/en/latest/installation.html\n.. _reuse.software: https://reuse.software/\n.. _txThings: https://github.com/siskin/txThings\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrysn%2Faiocoap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchrysn%2Faiocoap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrysn%2Faiocoap/lists"}