Skip to main content

A Python tool for easily querying OpenAlias records

Project description

Privex Pyrewall

Build Status Codecov
PyPi Version License Button PyPI - Downloads PyPI - Python Version GitHub last commit

A Python tool to query OpenAlias records - for easily grabbing all cryptocurrency addresses associated with a domain. Uses DNS-over-HTTPs by default for security, but also supports plain DNS if needed.

Screenshot of OpenAlias.py commands

OpenAlias.py - A Python tool for easily querying OpenAlias records
Copyright (c) 2023    Privex Inc. ( https://www.privex.io )

Copyright::

    +===================================================+
    |                 © 2023 Privex Inc.                |
    |               https://www.privex.io               |
    +===================================================+
    |                                                   |
    |        OpenAlias.py - A python OpenAlias Client   |
    |        License: X11/MIT                           |
    |                                                   |
    |        https://github.com/Privex/openalias-py     |
    |                                                   |
    |        Core Developer(s):                         |
    |                                                   |
    |          (+)  Chris (@someguy123) [Privex]        |
    |                                                   |
    +===================================================+

Quickstart Install

We recommend that you use Python 3.7 or newer, as the tool makes use of dataclasses.

It might be possible to run on 3.6 at the lowest, but you'll need to install the dataclasses backport package

Install via PyPi with Pip

python3 -m pip install -U openalias

Install from source

git clone https://github.com/Privex/openalias-py.git
cd openalias-py
# You can either use pip to install it, or setup.py
# Via pip
pip3 install .
# Via setup.py
python3 setup.py install

Usage

# You can either use the command which is supposed to be auto-installed into /usr/local/bin
# or ~/.local/bin - or you can use python3 -m openalias

# View help (independent command script)
openaliaspy --help
# View help (using the command via python module call)
python3 -m openalias --help

# Get the XMR address associated with the domain privex.io
openaliaspy get privex.io xmr

# Get JUST the LTC address on it's own associated with the domain privex.io
# (useful for programmatic use)
openaliaspy get -p privex.io ltc

# List all addresses associated with privex.io in a colourful rich table
openaliaspy list privex.io

# List the addresses and other data in plain comma-separated text
openaliaspy list -p privex.io

# Use standard DNS instead of DNS-over-HTTPs to list/get privex.io's addresses
openaliaspy -P dns list privex.io
openaliaspy -P dns get privex.io xmr

# Use a custom resolver for DNS-over-HTTPs or standard DNS
openaliaspy -P dns -r 9.9.9.9 get privex.io btc
openaliaspy -r https://dns.privex.io list privex.io

License

OpenAlias.py is released under the X11 / MIT License, see LICENSE for more info.

Thanks for reading!

If this project has helped you, consider grabbing a VPS or Dedicated Server from Privex - prices start at as little as US$0.99/mo (we take cryptocurrency!)

You can also donate to us using our OpenAlias address privex.io :)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openalias-1.0.2.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

openalias-1.0.2-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file openalias-1.0.2.tar.gz.

File metadata

  • Download URL: openalias-1.0.2.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.0

File hashes

Hashes for openalias-1.0.2.tar.gz
Algorithm Hash digest
SHA256 e88d8af8ca18739cd55d6745ec37fa0ab2f6c21dac336d6f0d7b926530ec9a1d
MD5 e14904d02d948bfd06b2421522e9ac44
BLAKE2b-256 e7595d8bbda48436959b6809981d7eb2ef5dd9a8cb39512f3e64486fca3dabdb

See more details on using hashes here.

File details

Details for the file openalias-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: openalias-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.0

File hashes

Hashes for openalias-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f9db6bcf6d10bf65853c12e6e9bbfd57d31cd1a4f867365e68068de39414feb8
MD5 3e42db06466152b10986ca2568637bc2
BLAKE2b-256 e477279b364fb25762611fe8ba4b03aa3873305cc3259c6abfb9a5d0f1e1c3ca

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page