python-hole
===========
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 is consuming the details provided by the endpoint ``api.php`` only
for now.
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 <https://pypi.python.org/pypi>`_.
.. code:: bash
$ pip3 install hole
On a Fedora-based system.
.. code:: bash
$ sudo dnf -y install python-hole
For Nix or NixOS is a `pre-packed module <https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&query=hole>`_
available. The lastest release is usually present in the ``unstable`` channel.
.. code:: bash
$ nix-env -iA nixos.python3Packages.hole
Usage
-----
The file ``example.py`` contains an example 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 were third party contributions are appreciated.
License
-------
``python-hole`` is licensed under MIT, for more details check LICENSE.
Raw data
{
"_id": null,
"home_page": "https://github.com/home-assistant-ecosystem/python-hole",
"name": "hole",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Fabian Affolter",
"author_email": "fabian@affolter-engineering.ch",
"download_url": "https://files.pythonhosted.org/packages/45/8b/6ae8e2083eb52baa81b1c11daa5ca2652f7d0e7942edae488ab9c1e0c170/hole-0.8.0.tar.gz",
"platform": null,
"description": "python-hole\n===========\n\nPython API for interacting with a xyz-hole instance. You know the thing that is\nblocking Ads by manipulating your DNS requests and run on your single board\ncomputer or on other hardware with different operating systems.\n\nThis module is consuming the details provided by the endpoint ``api.php`` only\nfor now.\n\nIf you wonder why the weird name and that the usage of xzy-hole instead of the\nreal name, please contact the trademark holder. They were unhappy with original\nname of the module and came up with very funny ideas which were not feasible\nor match the existing naming standards. Also, it should remind us that a\ncommunity is a vital part of every Open Source project.\n\nThis module is not supported or endorsed by that particular trademark holder.\nThe development happens independently, they are not providing resources and\nthe module may no longer work if they breaking their API endpoint.\n\nInstallation\n------------\n\nThe module is available from the `Python Package Index <https://pypi.python.org/pypi>`_.\n\n.. code:: bash\n\n $ pip3 install hole\n\nOn a Fedora-based system.\n\n.. code:: bash\n\n $ sudo dnf -y install python-hole\n\nFor Nix or NixOS is a `pre-packed module <https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&query=hole>`_\navailable. The lastest release is usually present in the ``unstable`` channel.\n\n.. code:: bash\n\n $ nix-env -iA nixos.python3Packages.hole\n\nUsage\n-----\n\nThe file ``example.py`` contains an example about how to use this module.\n\nRoadmap\n-------\n\nThere are more features on the roadmap but there is no ETA because I prefer\nto support Open Source projects were third party contributions are appreciated.\n\nLicense\n-------\n\n``python-hole`` is licensed under MIT, for more details check LICENSE.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python API for interacting with *hole.",
"version": "0.8.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "f7598cfb08f91e3124be355d758775cc",
"sha256": "ce48212c97b54b3376a8e78bdb7f93d884a31a4b8e0ddf6d240d6d3b7870d9ad"
},
"downloads": -1,
"filename": "hole-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "f7598cfb08f91e3124be355d758775cc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 5332,
"upload_time": "2022-12-23T21:18:52",
"upload_time_iso_8601": "2022-12-23T21:18:52.817315Z",
"url": "https://files.pythonhosted.org/packages/45/8b/6ae8e2083eb52baa81b1c11daa5ca2652f7d0e7942edae488ab9c1e0c170/hole-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-23 21:18:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "home-assistant-ecosystem",
"github_project": "python-hole",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hole"
}
JSON
