From 89ac85bacd0df5de6a39481a54935946219ffcd7 Mon Sep 17 00:00:00 2001 From: anima Date: Sat, 19 Oct 2024 18:21:59 +0200 Subject: [PATCH] add basic docs Signed-off-by: anima --- README.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 65 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c87a76e..81f0b8a 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,66 @@ -# api-pihole +# API Wrapper: Pi-hole +>A basic API wrapper for Pi-hole -API wrapper for pihole \ No newline at end of file +## Functions +### Custom DNS +Read, add or delete a custom dns entry (no cname's!) +```python +get_custom_dns() +add_custom_dns(domain, ip) +del_custom_dns(domain, ip) +``` + +### Custom CNAMES +Same as Custom DNS but for CNAMES only. +```python +get_custom_cname() +add_custom_cname(domain, target) +del_custom_cname(domain, target) +``` + +### Filter Lists +Read, add or delete a filter list. +Availible lists: +- white +- black +- regex_white +- regex_black + +*white and black only match exact machtes!* + +```python +get_list(list, entry) +""" aliases """ +get_whitelist(entry) +get_regex_whitelist(entry) +get_blacklist(entry) +get_regex_blacklist(entry) + +add_to_list(list, entry) +""" aliases """ +add_to_whitelist(entry) +add_to_regex_whitelist(entry) +add_to_blacklist(entry) +add_to_regex_blacklist(entry) + +del_from_list(list, entry) +""" aliases """ +del_from_whitelist(entry) +del_from_regex_whitelist(entry) +del_from_blacklist(entry) +del_from_regex_blacklist(entry) +``` + +### Misc +Misc functions for: +- enable / disable filter +- get / check update status +- set temp unit from cpu + +```python +enable() +disable() +get_version() +check_updates() +set_tmp_unit(unit) +``` \ No newline at end of file