{ "info": { "author": "David Francos", "author_email": "opensource@davidfrancos.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "Zeroconf\n================================================================================\n\nA simple Python interface to Zeroconf service discovery and registration.\nSupports python >= 2.7 <= 3.5\n\nInstallation\n--------------------------------------------------------------------------------\n\n### Requirements\n\nThe `zeroconf` module assumes that the [avahi](http://avahi.org/) command-line\ntools `avahi-browse` and `avahi-publish` are available.\nOn Ubuntu for example, they may me installed with:\n\n $ sudo apt-get install avahi-utils\n\nThe module also depend on [Andrew Moffat's subprocess wrapper][sh]. Install\nit with\n\n $ pip install sh\n\nRead more about package install methods on Install section.\n\nIf you install the package using setup.py or pip it'll be automatically\nhandled so you normally don't need to do this.\n\n[sh]: http://amoffat.github.io/sh\n\n### Install\n\nThere are multiple methods for installing a python package.\nFirst, download the source package, and cd to it.\n\nThen you could directly run setup.py:\n\n $ python setup.py install\n\nOr use pip, if you've got pip:\n\n $ pip install .\n\n\nPackages can be installed system-wide (with sudo):\n\n $ sudo pip install .\n\nOn a virtualenv:\n\n $ mkvirtualenv zeroconf\n $ workon zeroconf\n $ pip install .\n\nAnd with user options:\n\n $ python setup.py install --user\n\nOr\n\n $ pip install --user .\n\n\n### Running tests\n\nJust run\n\n $ python setup.py test\n\nIt'll install necesary test dependences and run the tests.\nNote that tests on windows are not covered this way and should be run with\n\n $ py.test --doctest-modules zeroconf/\n\n\nUsage\n--------------------------------------------------------------------------------\n\n### Zeroconf Services Discovery\n\nSearching for all available Zeroconf services is done by\n\n >>> from zeroconf import ZeroConf\n >>> zc = ZeroConf()\n >>> services = zc.search()\n\nThe search can be made more specific, for example:\n\n >>> services = zc.search(name=None, type=\"_workstation._tcp\", domain=\"local\")\n\nThe arguments, all optional, to the `search` functions are:\n\n - `name`: service name, defaults to `None` (interpreted as all),\n - `type`: service type, defaults to `None` (interpreted as all),\n - `domain`: domain name, defaults to `\"local\"`.\n\nSearch results are dictionaries:\n\n >>> print services\n {('tide [f0:7b:cb:42:ff:e0]', '_workstation._tcp', 'local'):\n {'txt': '', 'hostname': 'tide.local', 'port': '9', 'address': '192.168.0.13'},\n ('wreck [00:26:18:4c:3f:ee]', '_workstation._tcp', 'local'):\n {'txt': '', 'hostname': 'wreck.local', 'port': '9', 'address': '192.168.0.10'},\n ('biohazard [00:18:8b:ac:c8:45]', '_workstation._tcp', 'local'):\n {'txt': '', 'hostname': 'biohazard.local', 'port': '9', 'address': '192.168.0.12'}}\n\nThe keys are `(name, type, domain)` tuples and the values are dictionaries with `txt`,\n`hostname`, `port` and `address` keys.\n\n### Zeroconf Services Registration\n\nRegister a new zeroconf service in the local domain with:\n\n >>> zc = ZeroConf()\n >>> zc.register(name=\"ghost [08:00:27:bf:49:e1]\", type=\"_workstation._tcp\", port=\"9\")\n\nand when you're done, unregister it with:\n\n >>> zc = ZeroConf()\n >>> zc.unregister(name=\"ghost [08:00:27:bf:49:e1]\", type=\"_workstation._tcp\", port=\"9\")\n\nAll arguments to `unregister` are optional, so we could have done:\n\n >>> zc = ZeroConf()\n >>> zc.unregister(name=\"ghost [08:00:27:bf:49:e1]\")\n\nor even, to unregister all services published during the Python session:\n\n >>> zc = ZeroConf()\n >>> zc.unregister()\n\nContributors\n--------------------------------------------------------------------------------\n\n - S\u00e9bastien Boisg\u00e9rault :\n initial API design, Linux/avahi support.\n - Olivier Huynh : Windows/dns-sd support.\n - David Francos Cuartero : OOP rewrite, Python3 support\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "ZeroConf", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "zeroconf3", "package_url": "https://pypi.org/project/zeroconf3/", "platform": "", "project_url": "https://pypi.org/project/zeroconf3/", "project_urls": null, "release_url": "https://pypi.org/project/zeroconf3/2.0.5.dev17/", "requires_dist": null, "requires_python": "", "summary": "Python3 version of Sebastien Boisgerault's python zeroconf library", "version": "2.0.5.dev17" }, "last_serial": 2282321, "releases": { "2.0.5.dev17": [ { "comment_text": "", "digests": { "md5": "43db196a4069aa498ab76b54a1f84532", "sha256": "0e40be59f77b1784382bdfa8b3dcd445610c384785f2d2e83e36391095c31558" }, "downloads": -1, "filename": "zeroconf3-2.0.5.dev17.tar.gz", "has_sig": false, "md5_digest": "43db196a4069aa498ab76b54a1f84532", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12061, "upload_time": "2016-08-15T15:18:25", "url": "https://files.pythonhosted.org/packages/29/18/5eff8531d9fcc54b4e5d756c12f65c94cbe883e19826a9528877642c6515/zeroconf3-2.0.5.dev17.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "43db196a4069aa498ab76b54a1f84532", "sha256": "0e40be59f77b1784382bdfa8b3dcd445610c384785f2d2e83e36391095c31558" }, "downloads": -1, "filename": "zeroconf3-2.0.5.dev17.tar.gz", "has_sig": false, "md5_digest": "43db196a4069aa498ab76b54a1f84532", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12061, "upload_time": "2016-08-15T15:18:25", "url": "https://files.pythonhosted.org/packages/29/18/5eff8531d9fcc54b4e5d756c12f65c94cbe883e19826a9528877642c6515/zeroconf3-2.0.5.dev17.tar.gz" } ] }