zone_records.py

#!/usr/bin/env python3

# This script assumes an account token.
#
# If all you have is a user token you can run this script, by passing email and password when creating the client
# like so:
# `client = Client(sandbox=True, email=<your_email>, password=<your_password>`

import sys

from auth_token import token
from dnsimple import Client

"""
Construct a client instance.

If you want to connect to production omit the sandbox option
"""
client = Client(sandbox=True, access_token=token)

"""
All calls to client pass through a service. In this case, `client.identity` is the identity service

`client.identity.whoami() is the method for retrieving the account details for your
current credentials via the DNSimple API.
"""
response = client.identity.whoami()

"""
The response object returned by any API method includes a `data` attribute.

Underneath that attribute is an attribute for each data object returned.

In this case, `account` provides access to the contained account object.

Here the account id is extracted for use in future calls:
"""
account_id = response.data.account.id

"""
dnsimple.client.zones.list_records is the method to list the records in a DNSimple zone.

In the example below we are iterating through all the zone records of a given domain.
"""
page = 1

while True:
    response = client.zones.list_records(account_id, str(sys.argv[1]), page=page)

    for record in response.data:
        print(f'- {record.content} ({record.id})')

    if page == response.pagination.total_pages:
        break

    page += 1