Skip to main content

Python API for interacting with *hole.

Project description

Python API for interacting with a xyz-hole instance. You know the thing that is blocking Ads by manipulating your DNS requests and run on your single board computer or on other hardware with different operating systems.

This module supports both v5 and v6 versions of the API through a unified interface. Simply specify the version when creating your client:

from hole import Hole

# For v6 (default)
client = Hole("YOUR_API_TOKEN")

# For v5
client_v5 = Hole("YOUR_API_TOKEN", version=5)

This module is consuming the details provided by the endpoint api.php and other API endpoints available in v5 and v6.

If you wonder why the weird name and that the usage of xzy-hole instead of the real name, please contact the trademark holder. They were unhappy with original name of the module and came up with very funny ideas which were not feasible or match the existing naming standards. Also, it should remind us that a community is a vital part of every Open Source project.

This module is not supported or endorsed by that particular trademark holder. The development happens independently, they are not providing resources and the module may no longer work if they breaking their API endpoint.

Installation

The module is available from the Python Package Index.

$ pip3 install hole

On a Fedora-based system.

$ sudo dnf -y install python-hole

For Nix or NixOS is a pre-packed module available. The lastest release is usually present in the unstable channel.

$ nix-env -iA nixos.python3Packages.hole

Usage

The files examplev5.py and examplev6.py contains examples about how to use this module.

Roadmap

There are more features on the roadmap but there is no ETA because I prefer to support Open Source projects where third party contributions are appreciated.

License

python-hole is licensed under MIT, for more details check LICENSE.

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

hole-0.9.0.tar.gz (9.1 kB view details)

Uploaded Source

File details

Details for the file hole-0.9.0.tar.gz.

File metadata

  • Download URL: hole-0.9.0.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for hole-0.9.0.tar.gz
Algorithm Hash digest
SHA256 8f9a3b4bc089f92f2a4b36eedd60ef421d3f0c17ad3bedcb09f3a7cd9aa4e187
MD5 02fbd0951a742f41ea5fadecac6e8e20
BLAKE2b-256 488e3a91a74481a51231a73263dd0cba6fa8fa22b0b229b75387904046b2ef17

See more details on using hashes here.

Supported by

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