Skip to main content

Easy Zone - DNS Zone abstraction module

Project description

dnszone

========

Overview


This package is forked from Easyzone,

created by Chris Miles. I have forked it to include bugfixes for installation

and also to update the package for compatibility with Python 3.

DNSZone 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).

Websites:

Requirements


Build/Test/Install


Build::

  $ python setup.py build

Test::

  $ python setup.py test

Install::

  $ python setup.py install

OR with setuptools::

  $ easy_install dnszone

Examples


dnszone::


  >>> from dnszone import dnszone

  >>> z = dnszone.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 dnszone.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 dnszone.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 "<stdin>", line 1, in <module>

    File "dnszone/zone_reload.py", line 51, in reload

      raise ZoneReloadError("rndc failed with return code %d" % r)

  dnszone.zone_reload.ZoneReloadError: rndc failed with return code 1

  >>>

  >>> r = ZoneReload(rndc='/usr/sbin/rndc')

  >>> r.reload('example.com')

  zone reload up-to-date

  >>>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for dnszone, version 2.0.2
Filename, size File type Python version Upload date Hashes
Filename, size dnszone-2.0.2-py2-none-any.whl (9.0 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size dnszone-2.0.2-py3-none-any.whl (9.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size dnszone-2.0.2.tar.gz (6.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page