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.

Source Distribution

dnszone-2.0.2.tar.gz (6.9 kB view hashes)

Uploaded Source

Built Distributions

dnszone-2.0.2-py3-none-any.whl (9.0 kB view hashes)

Uploaded Python 3

dnszone-2.0.2-py2-none-any.whl (9.0 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page