{ "info": { "author": "James Mills", "author_email": "James Mills, prologic at shortcircuit dot net dot au", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: No Input/Output (Daemon)", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: GNU General Public License (GPL)", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Communications :: Chat :: Internet Relay Chat" ], "description": ".. _dnslib: https://pypi.python.org/pypi/dnslib\r\n.. _circuits: http://circuitsframework.org/\r\n.. _Docker: http://docker.com/\r\n.. _Python: http://python.org/\r\n.. _Docker Compose: https://docs.docker.com/compose/\r\n\r\n\r\nudns - a micro (\u00b5) DNS Server\r\n=============================\r\n\r\n.. image:: https://badge.waffle.io/prologic/udns.png?label=ready&title=Ready \r\n :target: https://waffle.io/prologic/udns\r\n :alt: 'Stories in Ready'\r\n\r\n.. image:: https://travis-ci.org/prologic/udns.svg\r\n :target: https://travis-ci.org/prologic/udns\r\n :alt: Build Status\r\n\r\n.. image:: https://coveralls.io/repos/prologic/udns/badge.svg\r\n :target: https://coveralls.io/r/prologic/udns\r\n :alt: Coverage\r\n\r\n.. image:: https://landscape.io/github/prologic/udns/master/landscape.png\r\n :target: https://landscape.io/github/prologic/udns/master\r\n :alt: Quality\r\n\r\nudns is an authoritative, caching DNS server for development and small\r\ndeployments written in `Python`_ using the `circuits`_ Application Framework\r\nand the `dnslib`_ DNS library. udns can be run standalone, via `Docker`_\r\nor using the `Docker Compose`_ tool. udns is designed to be small,\r\nlightweight, fast and flexible. udns fully supports forwarding, caching\r\nas well as honoring TTL(s). udns will also read your ``/etc/hosts`` file\r\nat startup and use this to populate an internal hosts cache so that entries\r\nin your local ``/etc/hosts`` file are fully resolvable with tools such as\r\n``host``, ``dig`` and resolver client libraries.\r\n\r\n\r\nInstallation and Usage\r\n----------------------\r\n\r\nFrom Source::\r\n \r\n $ git clone https://github.com/prologic/udns\r\n $ cd udns\r\n $ python setup.py develop\r\n $ sudo udnsd --debug # Server\r\n $ udnsc --help # Client\r\n\r\nFrom Source using `Docker`_ and `Docker Compose`_::\r\n \r\n $ git clone https://github.com/prologic/udns\r\n $ cd udns\r\n $ docker-compose up -d # Server\r\n $ docker-compose run --rm udns udnsc # Client\r\n\r\nUsing `Docker`_::\r\n \r\n $ docker run -d -p 53:53/udp prologic/udns\r\n\r\nFrom PyPi (*coming soon*)::\r\n \r\n $ pip install udns\r\n $ udnsd # Server\r\n $ udnsc # Client\r\n\r\n\r\nRunning as a Daemon::\r\n \r\n $ sudo udnsd -d --logfile=$(pwd)/udnsd.log --pidfile=$(pwd)/udnsd.pid\r\n\r\n\r\nManaging Zones and Records\r\n--------------------------\r\n\r\nudns is a full authoritative, caching DNS server and ships with a client to\r\nhelp manage zones and records. Here are some quick examples:\r\n\r\nCreate new Zone::\r\n \r\n $ udnsc create abc.com.\r\n\r\nCreate new Zone from a file::\r\n \r\n $ udnsc create abc.com. abc.com\r\n\r\nor:::\r\n \r\n $ udnsc create abc.com. - < abc.com\r\n\r\nList Zones::\r\n \r\n $ udnsc list\r\n\r\nShow Zone Records::\r\n \r\n $ udnsc show abc.com.\r\n\r\nExport a Zone:::\r\n \r\n $ udnsc export abc.com.\r\n\r\n.. note:: This exports the Zone to stdout which you can pipe into an output\r\n file for storage using your shell.\r\n e.g: ``udnsc export abc.com. > abc.com``\r\n\r\nAdd Zone Records::\r\n \r\n $ udnsc add abc.com. www 127.0.0.1\r\n\r\nDelete a Zone Record::\r\n \r\n $ udnsc delete abc.com. www\r\n\r\nDelete a Zone::\r\n \r\n $ udnsc delete abc.com.\r\n\r\n.. note:: You __must__ specify zones as fully qualified domain names with a\r\n trailing period. e.g: ``abc.com.``\r\n\r\n\r\nChanges\r\n-------\r\n\r\n\r\nudns 0.0.2 (*2016-01-26*)\r\n.........................\r\n\r\n- Added support for CNAME(s)\r\n- Added support for @ ($ORIGIN)\r\n- Various small bugfixes\r\n\r\nudns 0.0.1 (*2014-08-26*)\r\n.........................\r\n\r\n- Initial Release", "description_content_type": null, "docs_url": null, "download_url": "https://github.org/com/udns/releases/", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/prologic/udns/", "keywords": "micro dns server udns", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "udns", "package_url": "https://pypi.org/project/udns/", "platform": "POSIX", "project_url": "https://pypi.org/project/udns/", "project_urls": { "Download": "https://github.org/com/udns/releases/", "Homepage": "https://github.com/prologic/udns/" }, "release_url": "https://pypi.org/project/udns/0.0.2/", "requires_dist": null, "requires_python": null, "summary": "micro dns server", "version": "0.0.2" }, "last_serial": 1925012, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "a9344cfdbadd716a5dabb0865bc6189e", "sha256": "e69fb4e47e000da836fe4ae6588b6247994f8c0b4992cb53fa6b5852a2ad0419" }, "downloads": -1, "filename": "udns-0.0.1-py2.7.egg", "has_sig": false, "md5_digest": "a9344cfdbadd716a5dabb0865bc6189e", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 22399, "upload_time": "2014-11-19T12:36:55", "url": "https://files.pythonhosted.org/packages/b6/15/c092aae153046fae2db91ce1a5185a05b781ed281636b42387b09bf83090/udns-0.0.1-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "cd2ecbac813841841cd5b27ccc4ce10d", "sha256": "06ae3461a2145e520ee913c31fb124ce07d3bdc1a4fec236ffbb6afbea46de97" }, "downloads": -1, "filename": "udns-0.0.1.tar.gz", "has_sig": false, "md5_digest": "cd2ecbac813841841cd5b27ccc4ce10d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7529, "upload_time": "2014-11-19T12:36:53", "url": "https://files.pythonhosted.org/packages/12/27/4e27ee1dbaeb1f4cc32031fc98525f156102b1809899e76dd5c6779d1855/udns-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "2d1d243e5710e133b14df4fde597f5fa", "sha256": "055875fcb65fa84f0310beaf1d004eae0d0655718ca0f14aeb987a04e316456d" }, "downloads": -1, "filename": "udns-0.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "2d1d243e5710e133b14df4fde597f5fa", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 14817, "upload_time": "2016-01-27T06:41:17", "url": "https://files.pythonhosted.org/packages/b8/de/d6c1c967e70366947daca689a680566b289fae0e44c0ed9246ee0ce6e622/udns-0.0.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8056089d8ef00ae2ec2b1c4ecb89f10a", "sha256": "a9cda6058041f4c820e5504e7c6f6b6f6ffad2d2c42c40eabd9290e60bf0a2fb" }, "downloads": -1, "filename": "udns-0.0.2.tar.gz", "has_sig": false, "md5_digest": "8056089d8ef00ae2ec2b1c4ecb89f10a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11217, "upload_time": "2016-01-27T06:41:05", "url": "https://files.pythonhosted.org/packages/eb/88/4e4c4a44ff4b9b6bab9b4f6d345acbe86f6da6fb29335a988e61eaa20b8f/udns-0.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2d1d243e5710e133b14df4fde597f5fa", "sha256": "055875fcb65fa84f0310beaf1d004eae0d0655718ca0f14aeb987a04e316456d" }, "downloads": -1, "filename": "udns-0.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "2d1d243e5710e133b14df4fde597f5fa", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 14817, "upload_time": "2016-01-27T06:41:17", "url": "https://files.pythonhosted.org/packages/b8/de/d6c1c967e70366947daca689a680566b289fae0e44c0ed9246ee0ce6e622/udns-0.0.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8056089d8ef00ae2ec2b1c4ecb89f10a", "sha256": "a9cda6058041f4c820e5504e7c6f6b6f6ffad2d2c42c40eabd9290e60bf0a2fb" }, "downloads": -1, "filename": "udns-0.0.2.tar.gz", "has_sig": false, "md5_digest": "8056089d8ef00ae2ec2b1c4ecb89f10a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11217, "upload_time": "2016-01-27T06:41:05", "url": "https://files.pythonhosted.org/packages/eb/88/4e4c4a44ff4b9b6bab9b4f6d345acbe86f6da6fb29335a988e61eaa20b8f/udns-0.0.2.tar.gz" } ] }