Metadata-Version: 1.1
Name: checkdmarc
Version: 1.6.1
Summary: A Python module and command line parser for SPF and DMARC records
Home-page: https://domainaware.github.io/checkdmarc
Author: Sean Whalen
Author-email: whalenster@gmail.com
License: Apache 2.0
Description: ::
        
            usage: checkdmarc [-h] [-d] [-f FORMAT] [-o OUTPUT]
                          [-n NAMESERVER [NAMESERVER ...]] [-t TIMEOUT] [-v]
                          [-w WAIT]
                          domain [domain ...]
        
            Validates and parses SPF amd DMARC DNS records
        
            positional arguments:
              domain                one or ore domains, or a single path to a file
                                    containing a list of domains
        
            optional arguments:
              -h, --help            show this help message and exit
              -d, --descriptions    include descriptions of DMARC tags in the JSON output
              -f FORMAT, --format FORMAT
                                    specify JSON or CSV output format
              -o OUTPUT, --output OUTPUT
                                    output to a file path rather than printing to the
                                    screen
              -n NAMESERVER [NAMESERVER ...], --nameserver NAMESERVER [NAMESERVER ...]
                                    nameservers to query
              -t TIMEOUT, --timeout TIMEOUT
                                    number of seconds to wait for an answer from DNS
                                    (default 6.0)
              -v, --version         show program's version number and exit
              -w WAIT, --wait WAIT  number os seconds to wait between processing domains
                                    (default 0.0)
        
        
        .. code-block:: bash
        
            $ checkdmarc fbi.gov -d
        
        .. code-block:: json
        
            {
              "domain": "fbi.gov",
              "base_domain": "fbi.gov",
              "mx": {
                "hosts": [
                  {
                    "preference": 10,
                    "hostname": "mx-east.fbi.gov",
                    "addresses": [
                      "153.31.160.5"
                    ]
                  }
                ],
                "warnings": []
              },
              "spf": {
                "record": "v=spf1 +mx ip4:153.31.0.0/16 -all",
                "valid": true,
                "dns_lookups": 1,
                "results": {
                  "pass": [
                    {
                      "value": "mx-east.fbi.gov",
                      "mechanism": "mx"
                    },
                    {
                      "value": "153.31.0.0/16",
                      "mechanism": "ip4"
                    }
                  ],
                  "neutral": [],
                  "softfail": [],
                  "fail": [],
                  "include": [],
                  "redirect": null,
                  "exp": null,
                  "all": "fail"
                },
                "warnings": []
              },
              "dmarc": {
                "record": "v=DMARC1; p=reject; adkim=r; aspf=r; rua=mailto:dmarc-feedback@fbi.gov; ruf=mailto:dmarc-feedback@fbi.gov; pct=100",
                "valid": true,
                "location": "fbi.gov",
                "tags": {
                  "v": {
                    "value": "DMARC1",
                    "explicit": true
                  },
                  "p": {
                    "value": "reject",
                    "explicit": true
                  },
                  "adkim": {
                    "value": "r",
                    "explicit": true
                  },
                  "aspf": {
                    "value": "r",
                    "explicit": true
                  },
                  "rua": {
                    "value": [
                      "mailto:dmarc-feedback@fbi.gov"
                    ],
                    "explicit": true
                  },
                  "ruf": {
                    "value": [
                      "mailto:dmarc-feedback@fbi.gov"
                    ],
                    "explicit": true
                  },
                  "pct": {
                    "value": 100,
                    "explicit": true
                  },
                  "fo": {
                    "value": [
                      "0"
                    ],
                    "explicit": false
                  },
                  "rf": {
                    "value": [
                      "afrf"
                    ],
                    "explicit": false
                  },
                  "ri": {
                    "value": 86400,
                    "explicit": false
                  },
                  "sp": {
                    "value": "reject",
                    "explicit": false
                  }
                },
                "warnings": []
              }
            }
        
        
        
        Installation
        ------------
        
        ``checkdmarc`` requires Python 3.
        
        On Debian or Ubuntu systems, run:
        
        .. code-block:: bash
        
            $ sudo apt-get install python3-pip
        
        
        Python 3 installers for Windows and macOS can be found at https://www.python.org/downloads/
        
        To install or upgrade to the latest stable release of ``checkdmarc`` on macOS or Linux, run
        
        .. code-block:: bash
        
            $ sudo -H pip3 install -U checkdmarc
        
        Or, install the latest development release directly from GitHub:
        
        .. code-block:: bash
        
            $ sudo -H pip3 install -U git+https://github.com/domainaware/checkdmarc.git
        
        .. note::
        
            On Windows, ``pip3`` is ``pip``, even with Python 3. So on Windows, simply
            substitute ``pip`` as an administrator in place of ``sudo pip3``, in the above commands.
        
        
        Documentation
        -------------
        
        https://domainaware.github.io/checkdmarc
        
        Bug reports
        -----------
        
        Please report bugs on the GitHub issue tracker
        
        https://github.com/domainaware/checkdmarc/issues
Keywords: DNS,SPF,DMARC
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 :: 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 :: Only
