https://github.com/vimalloc/easyzone
https://github.com/vimalloc/easyzone
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/vimalloc/easyzone
- Owner: vimalloc
- Created: 2014-05-12T22:06:55.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2016-06-14T19:36:28.000Z (over 9 years ago)
- Last Synced: 2025-04-24T05:03:32.450Z (9 months ago)
- Language: Python
- Size: 46.9 KB
- Stars: 3
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.txt
Awesome Lists containing this project
README
Fork of easyzone from https://bitbucket.org/chrismiles/easyzone.
Includes AAAAA/SRV/PTR records from provnet here:
https://bitbucket.org/chrismiles/easyzone/pull-request/1/add-include-option-to-clear_all_records/diff
Also fixes up Exception so they derive from an EasyZone Exception base class,
and don't overwtire NameError
easyzone
========
Overview
--------
Easyzone is a package to manage the common record types of a
zone file, including SOA records. This module sits on top of
the dnspython package and provides a higher level abstraction
for common zone file manipulation use cases.
Main features:
* A high-level abstraction on top of dnspython.
* Load a zone file into objects.
* Modify/add/delete zone/record objects.
* Save back to zone file.
* Auto-update serial (if necessary).
http://www.psychofx.com/easyzone/
http://pypi.python.org/pypi/easyzone
https://bitbucket.org/chrismiles/easyzone/
Requirements
------------
* dnspython - http://www.dnspython.org/
Build/Test/Install
------------------
Build::
$ python setup.py build
Test::
$ python setup.py test
Install::
$ python setup.py install
OR with setuptools::
$ easy_install easyzone
Examples
--------
easyzone::
>>> from easyzone import easyzone
>>> z = easyzone.zone_from_file('example.com', '/var/namedb/example.com')
>>> z.domain
'example.com.'
>>> z.root.soa.serial
2007012902L
>>> z.root.records('NS').items
['ns1.example.com.', 'ns2.example.com.']
>>> z.root.records('MX').items
[(10, 'mail.example.com.'), (20, 'mail2.example.com.')]
>>> z.names['foo.example.com.'].records('A').items
['10.0.0.1']
>>> ns = z.root.records('NS')
>>> ns.add('ns3.example.com.')
>>> ns.items
['ns1.example.com.', 'ns2.example.com.', 'ns3.example.com.']
>>> ns.delete('ns2.example.com')
>>> ns.items
['ns1.example.com.', 'ns3.example.com.']
>>> z.save(autoserial=True)
ZoneCheck::
>>> from easyzone.zone_check import ZoneCheck
>>> c = ZoneCheck()
>>> c.isValid('example.com', '/var/named/zones/example.com')
True
>>> c.isValid('foo.com', '/var/named/zones/example.com')
False
>>> c.error
'Bad syntax'
>>>
>>> c = ZoneCheck(checkzone='/usr/sbin/named-checkzone')
>>> c.isValid('example.com', '/var/named/zones/example.com')
True
>>>
ZoneReload::
>>> from easyzone.zone_reload import ZoneReload
>>> r = ZoneReload()
>>> r.reload('example.com')
zone reload up-to-date
>>> r.reload('foo.com')
rndc: 'reload' failed: not found
Traceback (most recent call last):
File "", line 1, in
File "easyzone/zone_reload.py", line 51, in reload
raise ZoneReloadError("rndc failed with return code %d" % r)
easyzone.zone_reload.ZoneReloadError: rndc failed with return code 1
>>>
>>> r = ZoneReload(rndc='/usr/sbin/rndc')
>>> r.reload('example.com')
zone reload up-to-date
>>>