Metadata-Version: 1.1
Name: dnsdb-python
Version: 1.0.0
Summary: An unofficial Farsight Security DNSDB client
Home-page: https://domainaware.github.io/dnsdb-python
Author: Sean Whalen
Author-email: whalenster@gmail.com
License: Apache 2.0
Description: ============
        dnsdb-python
        ============
        
        A full-featured unofficial Python client and CLI for
        `Farsight Security's DNSDB`_ passive DNS service.
        
        ::
        
            Usage: dnsdb [OPTIONS] COMMAND [ARGS]...
        
              An unofficial Farsight Security DNSDB client
        
            Options:
              --version  Show the version and exit.
              --verbose  Enable verbose logging.
              --help     Show this message and exit.
        
            Commands:
              forward  Forward DNS lookup.
              inverse  Inverse DNS lookup.
              quotas   Show the API quotas for your API key and exit.
        
        ::
        
            Usage: dnsdb forward [OPTIONS] OWNER_NAME
        
              Forward DNS lookup.
        
            Options:
              -t, --rrtype TEXT               Filter results by DNS resource record type.
                                              [default: ANY]
              -b, --bailiwick TEXT            Filter results by DNS bailiwick.
              --first-seen-before TEXT        Only show results first seen before this
                                              date.
              --first-seen-after TEXT         Only show results first seen after this
                                              date.
              --first-seen-before TEXT        Only show results first seen before this
                                              date.
              --first-seen-after TEXT         Only show results first seen after this
                                              date.
              --last-seen-before TEXT         Only show results last seen before this
                                              date.
              --last-seen-after TEXT          Only show results last seen after this date.
              -l, --limit INTEGER             Limit the number of results to this number.
              -j, --json                      Output in JSON format.
              -s, --sort [count|time_first|time_last|rrname|rrtype|bailiwick|rdata|source]
                                              Sort JSON results by this field.
              -r, --reverse                   Reverse the sorting.
              --help                          Show this message and exit.
        
        ::
        
            Usage: dnsdb inverse [OPTIONS] [name|ip|raw] VALUE
        
              Inverse DNS lookup.
        
            Options:
              -t, --rrtype TEXT               Filter results by DNS resource record type.
                                              [default: ANY]
              --first-seen-before TEXT        Only show results first seen before this
                                              date.
              --first-seen-after TEXT         Only show results first seen after this
                                              date.
              --first-seen-before TEXT        Only show results first seen before this
                                              date.
              --first-seen-after TEXT         Only show results first seen after this
                                              date.
              --last-seen-before TEXT         Only show results last seen before this
                                              date.
              --last-seen-after TEXT          Only show results last seen after this date.
              -l, --limit INTEGER             Limit the number of results to this number.
              -j, --json                      Output in JSON format.
              -s, --sort [count|time_first|time_last|rrname|rrtype|bailiwick|rdata|source]
                                              Sort JSON results by this field.
              -r, --reverse                   Reverse the sorting.
              --help                          Show this message and exit.
        
        Features
        --------
        
        - Easy to use Python class covers all DNSDB API endpoints and options
        - Supports hosted and self-hosted instances of DNSDB
        - Full CLI
        - Python 2 and 3 support
        - Parses multiple human date formats for time filtering
        - Output in text (DNS master file format)
        - JSON output
           - Outputs results as a pretty printed JSON list
           - Sort output by any JSON field
           - Automatically converts UNIX epoch timestamps to ISO 8601 timestamps
           - Normalize timestamp fields for sensor and zone file observations
        
        Installation
        ------------
        
        To install the latest stable version, run
        
        .. code-block:: bash
        
            sudo -H pip3 install -U dnsdb-python
        
        To install the latest development version, run
        
        .. code-block:: bash
        
            sudo -H pip3 install -U git+https://github.com/domainaware/dnsdb-python.git
        
        Store your API key as an environment variable named ``DNSDB_KEY``.
        
        If you are using a self-hosted instance of DNSDB, store the URL toot as an
        environment variable named ``DNSDB_ROOT``.
        
        See also
        --------
        
        - `DNSDB API reference`_
        
        .. _Farsight Security's DNSDB: https://www.farsightsecurity.com/solutions/dnsdb/
        .. _DNSDB API reference: https://api.dnsdb.info/
Keywords: DNS,passive,DNS,Farsight Security,DNSDB
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
