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