Add elementary functions

README.md

@@ -1,4 +1,3 @@
-# Experimental and under development!!!!
 
 <p align="center">
     <img src="assets/logo.png" alt="fiableDB logo">

fiable_db.py

@@ -1,6 +1,83 @@
 FILE = "fiabledb.json"
 
 
-def start(file=False):
+def start(filename: str = "") -> str:
-    file_name = file if file else FILE
+    """Start the database
-    print(file_name)
+    Args:
+        file (str, optional): The file to use. Defaults to FILE.
+    Returns:
+        str: The file used
+    """
+    file_name = filename if filename else FILE
+    return file_name
+
+
+def add(
+    new_data: dict | list, table: str = ""
+) -> dict[int, int, dict] | list[dict[int, int, dict]]:
+    """Add data to the database
+    Args:
+        new_data (dict|list): The data to add
+        table (str, optional): The table to add to. Defaults to "".
+    Returns:
+        dict[int, int, dict]|list[dict[int, int, dict]]: The data added
+    """
+    if isinstance(new_data, dict):
+        return _add(new_data, table)
+    elif isinstance(new_data, list):
+        return [_add(entry, table) for entry in new_data]
+    else:
+        raise TypeError("new_data must be a dict or list")
+    pass
+
+
+def update(
+    new_data: dict | list, table: str = "", force: bool = False
+) -> dict[int, int, dict]:
+    """Update data in the database
+    Args:
+        new_data (dict|list): The data to update
+        table (str, optional): The table to update. Defaults to "".
+        force (bool, optional): Force the update. Defaults to False.
+    Returns:
+        dict[int, int, dict]: The data updated
+    """
+    pass
+
+
+def delete(id: int, data: dict, table: str = "") -> dict[int, int, dict]:
+    """Delete data from the database
+    Args:
+        id (int): The id of the data to delete
+        data (dict): Filter the data to delete
+        table (str, optional): The table to delete from. Defaults to "".
+    Returns:
+        dict[int, int, dict]: The data deleted
+    """
+    pass
+
+
+def find_one(
+    id: int = 0, data: dict = {}, table: str = "", rev: int = 0
+) -> dict[int, int, dict]:
+    """Find one data in the database
+    Args:
+        id (int, optional): The id of the data to find. Defaults to 0.
+        data (dict, optional): Filter the data to find. Defaults to {}.
+        table (str, optional): The table to find in. Defaults to "".
+        rev (int, optional): The revision of the data to find. Defaults to 0.
+    Returns:
+        dict[int, int, dict]: The data found
+    """
+    pass
+
+
+def find_all(data: dict = {}, table: str = "") -> list[dict[int, int, dict]]:
+    """Find all data in the database
+    Args:
+        data (dict, optional): Filter the data to find. Defaults to {}.
+        table (str, optional): The table to find in. Defaults to "".
+    Returns:
+        list[dict[int, int, dict]]: The data found
+    """
+    pass