Skip to main content

ddcheck

Check URLs and manage the respective records in DynDNS.

Description

ddcheck accepts a list of healthckeck URLs, resolve them to IPs and makes HTTP requests directly to the IPs. When given IP is recognized as down, it will remove the record from DynDNS

Features

  • IPv4 and IPv6 support (A and AAAA records in DNS)

  • Traversing over CNAMEs to target A/AAAA records

  • IP is marked as failed when it either timeouts (configurable in seconds) or returns defined HTTP code (for example 500, by default turned off)

  • Dry run mode: Will not change the DynDNS recods. Outputs only curl commands instead.

  • Will not delete IPs from DynDNS, when all the IPs in the dns record fail.

Installation

pip install 'git+https://github.com/whiskybar/ddcheck.git#egg=ddcheck'

Usage

CLI

DynDNS credetials can be defined either by env variables, or as parameters.

# ddcheck --help

usage: ddcheck [-h] [-d] [-e ERROR_CODES] [-t TIMEOUT] [-D]
               [--dynect-customer DYNECT_CUSTOMER] [--dynect-user DYNECT_USER]
               [--dynect-password DYNECT_PASSWORD]
               URL [URL ...]

Run a ddcheck.

positional arguments:
  URL                   URL to check

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           Debug logging on
  -e ERROR_CODES, --error-codes ERROR_CODES
                        HTTP codes considered as non-OK
  -t TIMEOUT, --timeout TIMEOUT
                        URL timeout
  -D, --dry-run         Do not really update the dyndns. Just print records to
                        delete.
  --dynect-customer DYNECT_CUSTOMER
                        Customer name in DynEct (defaults to
                        DYNECT_CUSTOMER_NAME env variable)
  --dynect-user DYNECT_USER
                        Username in DynEct (defaults to DYNECT_USER_NAME env
                        variable)
  --dynect-password DYNECT_PASSWORD
                        Password in DynEct (defaults to DYNECT_PASSWORD env
                        variable)

Example

export DYNECT_PASSWORD=aaa
export DYNECT_USER_NAME=bbb
export DYNECT_CUSTOMER_NAME=ccc
ddcheck -e 500 --debug --dry-run http://root.example1.com/health/ http://cname.example2.com/check/

Python

Example

Metadata

Release files for ddcheck 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ddcheck 0.0.1
File Size Uploaded Provenance
ddcheck-0.0.1.tar.gz 6.0 kB Without provenance Details

Release files / ddcheck-0.0.1.tar.gz

Download URL ddcheck-0.0.1.tar.gz
Size 6.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3b214f3dc0d435ba109fa3ad207d37a646ac9260e9effd7987bda4316f110e4d
BLAKE2b-256 checksum
How to use checksums
acd2b0fc4d2f50fd4cbc35572fe3cf2314b50fb71c69ee0390e16e5869699474
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for ddcheck 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.0.1 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page