csirtgadgets / dnsdb-py

a simpler dnsdb python sdk

Farsight dnsdb.info client

Getting Started

Commandline

$ export FARSIGHT_TOKEN=1234
$ pip install csirtg_dnsdb
$ dnsdb --search 172.217.6.206
$ dnsdb -q google.com

SDK

from pprint import pprint
import json
from csirtg_dnsdb.client import Client

p = ArgumentParser(
    description=textwrap.dedent('''\
    example usage:
        $ dnsdb -q 1.2.3.4
    '''),
    formatter_class=RawDescriptionHelpFormatter,
    prog='dnsdb',
)
p.add_argument('--token', help='specify api token', default=TOKEN)
p.add_argument('--search', '-q', help='search for something')
args = p.parse_args()

c = Client(token=args.token)

for r in c.search(args.search):
    print(json.dumps(r))

Getting Involved

There are many ways to get involved with the project. If you have a new and exciting feature, or even a simple bugfix, simply fork the repo, create some simple test cases, generate a pull-request and give yourself credit!

If you've never worked on a GitHub project, this is a good piece for getting started.

• How To Contribute

Development

Some of the tools we use:

• PyCharm
• VirtualenvWrapper
• Vagrant

COPYRIGHT AND LICENCE

Copyright (C) 2016 the CSIRT Gadgets Foundation

Free use of this software is granted under the terms of the Mozilla Public Licence v2 (MPL2). For details see the files LICENSE included with the distribution.