Python SSDP library
Project description
SSDPy: Python SSDP library
SSDPy is a lightweight implementation of SSDP (Simple Service Discovery Protocol). It is designed for ease of use and high compatibility with the protocol in real-life use. It supports both the IETF and UPnP versions of the protocol.
Example usage
Send an SSDP discover packet (M-SEARCH):
>>> from ssdpy import SSDPClient
>>> client = SSDPClient()
>>> devices = client.m_search("ssdp:all")
>>> for device in devices:
... print(device.get("usn"))
uuid:Dell-Printer-1_0-dsi-secretariat::urn:schemas-upnp-org:service:PrintBasic:1
uuid:00000000-0000-0000-0200-00125A8A0960::urn:schemas-microsoft-com:nhed:presence:1
Send an SSDP NOTIFY packet, telling others about a service:
>>> from ssdpy import SSDPServer
>>> server = SSDPServer("my-service-identifier")
>>> server.notify()
Start an SSDP server which responds to relevant M-SEARCHes:
>>> from ssdpy import SSDPServer
>>> server = SSDPServer("my-service-identifier", device_type="my-device-type")
>>> server.serve_forever()
Then, from a client, M-SEARCH for our server:
>>> from ssdpy import SSDPClient
>>> client = SSDPClient()
>>> devices = client.m_search("my-device-type")
>>> for device in devices:
... print(device.get("usn"))
my-service-identifier
CLI utilities
SSDPy comes with two CLI utilities:
- ssdpy-server is a server that listens for M-SEARCHes and responds if they match its name.
- ssdpy-discover sends an M-SEARCH query and collects all responses.
Release checklist
- Update
ssdpy/version.py
with new version name. - Update
CHANGES.md
. - Commit the changes, tag with version & push.
- Run
make release
.
Links
- IETF draft of the protocl (still in use by some devices, e.g. redfish) https://tools.ietf.org/html/draft-cai-ssdp-v1-03
- UPnP Device Architecture 1.1 https://web.archive.org/web/20150905102426/http://upnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v1.1.pdf
- UPnP Device Architecture 2.0 https://web.archive.org/web/20151107123618/http://upnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v2.0.pdf
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ssdpy-0.2.4.tar.gz
(9.3 kB
view hashes)
Built Distribution
ssdpy-0.2.4-py2.py3-none-any.whl
(12.5 kB
view hashes)
Close
Hashes for ssdpy-0.2.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3feda14755a8aaec4465bd4bbc5d22d456d8e92157704912e46d66f2efd00e67 |
|
MD5 | c44c9eae3cb3f3b4f2a0d6ebea4989e8 |
|
BLAKE2b-256 | 9830154797ea6a0d5a40737a4ab4d9c1135c2e243182eb2b04339c57c27230ad |