Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Sync DNS records stored in a flat file format to your DNS provider.

Project description

Sync DNS records stored in a flat file format to your DNS provider. Cloudflare support currently provided.

Installation PyPI Version

$ pip install namesync

Quick Guide

Create a file with the name of your domain:

$ touch example.com

Or, if you have existing records, you can export them:

$ namesync --get example.com

Enter one record per line with the following format:

<record-type> <name> <value> <ttl:optional>

For example:

A       *       10.10.10.10         # You can even use comments
A       .       10.10.10.10         # . references the domain itself, example.com
A       test    10.10.10.11
A       example 10.10.10.12 86400
CNAME   mail    ghs.googlehosted.com
MX      .       aspmx.l.google.com

MX records allow you to specify a priority:

MX <name> <value> <priority:optional> <ttl:optional>

Like this:

MX      .       alt1.aspmx.l.google.com 20
MX      .       aspmx3.googlemail.com 30 86400

If the value contains spaces, quote it:

TXT     .       "v=spf1 a include:amazonses.com include:_spf.google.com ~all"

Then sync your records:

$ namesync example.com

You will be given a chance to review your changes before they are synced:

The following changes will be made:
ADD    A     *       10.10.10.10
ADD    A     example 10.10.10.12 86400
ADD    A     test    10.10.10.11
ADD    CNAME mail    ghs.googlehosted.com
ADD    MX    .       aspmx.l.google.com
UPDATE A     .       10.10.10.10
REMOVE A     old     10.10.10.13
Do you want to continue? [y/N]

Usage

usage: namesync [-h] [-g] [-z ZONE] [-y] [-d DATA_DIR] [-t] RECORDS

positional arguments:
  RECORDS               file containing DNS records, one per line. The zone is
                        derived from the basename of this file. For example,
                        if "dns/example.com" is used then the zone is assumed
                        to be "example.com" unless the --zone option is used

optional arguments:
  -h, --help            show this help message and exit
  -g, --get             save existing DNS records to RECORDS
  -z ZONE, --zone ZONE  specify the zone instead of using the RECORDS filename
  -y, --yes             sync records without prompting before making changes
  -d DATA_DIR, --data-dir DATA_DIR
                        the directory where namesync.conf and other cache data
                        is stored. [default: ~/.namesync]
  -t, --dry-run         print actions and exit without making any changes

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 namesync, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size namesync-0.4.tar.gz (13.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page