{ "info": { "author": "Loek Geleijn", "author_email": "loek@pcextreme.nl", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: POSIX", "Programming Language :: Python :: 3" ], "description": "# auroradns-cli\nA command line api client for PCextreme's AuroraDNS service based on Apache\nLibcloud.\n\n# Usage\n```\nusage: auroradns-cli.py [action] [aruments] (--help for more information)\n\nAuroraDNS Command Line Interface\n\npositional arguments:\n {list-zones,get-record,create-record,delete-record,update-record,create-zone,delete-zone,set-hostname}\n Specify the action to perform.\n\noptional arguments:\n -h, --help show this help message and exit\n --details print details\n --extras print extras\n --force don't prompt\n\nauthentication:\n --apikey APIKEY, -a APIKEY\n dns api key\n --secretkey SECRETKEY, -s SECRETKEY\n dns secret key\n\nrecord arguments:\n -n NAME, --name NAME dns name field, defaults to apex\n -d DATA, --data DATA dns data/content field\n -p PRIO, --prio PRIO dns record PRIO, mandatory for MX and SRV record types\n -t TYPE, --type TYPE dns record type, defaults to A/AAAA based on DATA, mandatory otherwise\n --ttl TTL dns record TTL\n --recordid RECORDID dns record ID\n\nzone arguments:\n -z ZONE, --zone ZONE dns ZONE name\n --zoneid ZONEID dns zone ID\n```\n\n## Examples\nList all records in a zone:\n```\n./auroradns-cli.py get-record --zone=mydomain.net\nname type priority ttl data\n----------------- ---------- ---------- ---------- ----------------------------------------------------------------------\n@ A 900 203.0.113.20\n* A 900 203.0.113.20\n@ AAAA 900 2001:db8:1337::5054:efff:fe0c:c675\n* AAAA 900 2001:db8:1337::5054:efff:fe0c:c675\n@ MX 10 900 primary.mail.pcextreme.nl\n@ MX 20 900 fallback.mail.pcextreme.nl\n@ NS 3600 ns081.auroradns.eu\n@ NS 3600 ns082.auroradns.nl\n@ NS 3600 ns083.auroradns.info\n@ SOA 4800 ns081.auroradns.eu admin.auroradns.eu 2019011401 86400 7200 604800 300\n```\n\nFilter on specific record types and ttl:\n```\n./auroradns-cli.py get-record --zone=mydomain.net --type=AAAA --ttl=900\nname type priority ttl data\n------------- ---------- ---------- ---------- ----------------------------------\n@ AAAA 900 2001:db8:1337::5054:efff:fe0c:c675\n* AAAA 900 2001:db8:1337::5054:efff:fe0c:c675\n```\n\nCreate a new dns-record, IPv6 and IPv4 records are validated and record type is\nautomatically set to AAAA or A if not specified. TTL defaults to zone default:\n```\n./auroradns-cli.py create-record --zone=mydomain.net --name=test123 --data=2001:db8:1337:dbfd:5054:3eff:feba:c1f3\nRecord created: test123.mydomain.net. 3600 IN AAAA 2001:db8:1337:dbfd:5054:3eff:feba:c1f3\n```\n\nDelete a record, multiple records can be removed if the filters\nreturn multiple results:\n```\n./auroradns-cli.py delete-record --zone=mydomain.net --name=mysubdomain --type=A\nname type priority ttl data\n-------------------- ---------- ---------- ---------- ----------------------------\nmysubdomain AAAA 3600 2001:db8:1337::5054:15ff:feb8:6a0e\n\nWarning, you are about to delete the records shown above, this cannot be undone.\nType _uppercase_ yes to confirm: YES\n\nDeleted record id 9f020b67-5b77-46e8-832c-0792280e3260: mysubdomain.mydomain.net. 3600 IN A 203.0.113.10\n```\n\nAutomatically create or update AAAA-/A-records for the host\n```\n./auroradns-cli.py set-hostname\nRecord created: mysubdomain.mydomain.net. 3600 IN AAAA 2001:db8:1337::5054:15ff:feb8:6a0e\nRecord updated: mysubdomain.mydomain.net. 3600 IN A 203.0.113.10\n```\n\n# Authentication\nYou can either pass the `--apikey APIKEY` and `--secretkey SECRETKEY` command\nline argumenrs or set the `DNS_API_KEY` and `DNS_SECRET_KEY` environment\nvariables:\n\n```\nexport DNS_API_KEY=MYAPIKEY; export DNS_SECRET_KEY=MYSECRETKEY\n```\n\n# Setup\n```\npip3 install auroradns-cli\n```\n\n## Requirements\n### Ubuntu 16+\n```\napt install python3 python3-pip python3-dev libcurl4-openssl-dev libssl-dev\n```\n\n### CentOS 7\n```\nyum install python36 python36-pip python36-devel libcurl libcurl-devel openssl openssl-libs openssl-devel\n```\n\nIf you get the following error: `ImportError: pycurl: libcurl link-time ssl backend (nss) is different from compile-time ssl backend (openssl)`, reinstall pycurl with `--global-option=\"--with-nss\"`:\n```\npip3 uninstall pycurl\npip3 install pycurl>=7.43.0.2 --global-option=\"--with-nss\"\n```\n\n# License\n* MIT License\n\nThis is my first python project ever so there's probably a lot of code in here\nthat doesn't even come close to being pythonic and some design choices that\nmay seem very strange but they seemed logical to me at the time. So no\nguarantees on this whatsoever, use at your own risk. If this works for you,\ngreat, enjoy! If not, send me a message and I'll try to fix the issue.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://www.pcextreme.nl/dns-health-checks", "keywords": "pcextreme auroradns auroradns-cli auroradns_cli", "license": "", "maintainer": "", "maintainer_email": "", "name": "auroradns-cli", "package_url": "https://pypi.org/project/auroradns-cli/", "platform": "", "project_url": "https://pypi.org/project/auroradns-cli/", "project_urls": { "Homepage": "https://www.pcextreme.nl/dns-health-checks" }, "release_url": "https://pypi.org/project/auroradns-cli/0.2.0/", "requires_dist": [ "apache-libcloud", "pycurl (>=7.43.0.2)", "tldextract", "urllib3" ], "requires_python": ">=3", "summary": "A simple CLI client for AuroraDNS", "version": "0.2.0" }, "last_serial": 5633748, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "8e02ec54808e587c2b09d17f4c1c60b0", "sha256": "0eb3e3c9199e2042ab3ec96e2105a943da5c80443bd8da3f4b34712fc42e0907" }, "downloads": -1, "filename": "auroradns_cli-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8e02ec54808e587c2b09d17f4c1c60b0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 11698, "upload_time": "2019-08-05T11:24:43", "url": "https://files.pythonhosted.org/packages/c8/99/e9fead3bd74bada24cac12d63eada4896e4757f73e927784b5527c351f61/auroradns_cli-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "03bde98ce9ddd8ca6c6c98b8e65209f0", "sha256": "77a7f2ec6538dd294e706088aa334368ab28ee7538af2ec4795d7e0cbf1ec3ba" }, "downloads": -1, "filename": "auroradns-cli-0.2.0.tar.gz", "has_sig": false, "md5_digest": "03bde98ce9ddd8ca6c6c98b8e65209f0", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3", "size": 10466, "upload_time": "2019-08-05T11:24:46", "url": "https://files.pythonhosted.org/packages/e5/84/ecfdd3700d3e0c02a4734845e3694094114c2434d47dec28fdfe71bdf548/auroradns-cli-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8e02ec54808e587c2b09d17f4c1c60b0", "sha256": "0eb3e3c9199e2042ab3ec96e2105a943da5c80443bd8da3f4b34712fc42e0907" }, "downloads": -1, "filename": "auroradns_cli-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8e02ec54808e587c2b09d17f4c1c60b0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 11698, "upload_time": "2019-08-05T11:24:43", "url": "https://files.pythonhosted.org/packages/c8/99/e9fead3bd74bada24cac12d63eada4896e4757f73e927784b5527c351f61/auroradns_cli-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "03bde98ce9ddd8ca6c6c98b8e65209f0", "sha256": "77a7f2ec6538dd294e706088aa334368ab28ee7538af2ec4795d7e0cbf1ec3ba" }, "downloads": -1, "filename": "auroradns-cli-0.2.0.tar.gz", "has_sig": false, "md5_digest": "03bde98ce9ddd8ca6c6c98b8e65209f0", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3", "size": 10466, "upload_time": "2019-08-05T11:24:46", "url": "https://files.pythonhosted.org/packages/e5/84/ecfdd3700d3e0c02a4734845e3694094114c2434d47dec28fdfe71bdf548/auroradns-cli-0.2.0.tar.gz" } ] }