added watchdog file monitoring

core/correctness/__init__.py

@@ -0,0 +1,3 @@
+
+from core.correctness.validation import *
+from core.correctness.vars import *

core/correctness/validation.py

@@ -1,7 +1,9 @@
 
-from abc import ABCMeta
+from os.path import sep
 from typing import Any, _SpecialForm
 
+from core.correctness.vars import VALID_PATH_CHARS
+
 def check_input(variable:Any, expected_type:type, alt_types:list[type]=[], 
         or_none:bool=False)->None:
     """
@@ -73,8 +75,8 @@ def valid_dict(variable:dict[Any, Any], key_type:type, value_type:type,
         required_keys:list[Any]=[], optional_keys:list[Any]=[], 
         strict:bool=True, min_length:int=1)->None:
     check_input(variable, dict)
-    check_input(key_type, type, alt_types=[_SpecialForm, ABCMeta])
-    check_input(value_type, type, alt_types=[_SpecialForm, ABCMeta])
+    check_input(key_type, type, alt_types=[_SpecialForm])
+    check_input(value_type, type, alt_types=[_SpecialForm])
     check_input(required_keys, list)
     check_input(optional_keys, list)
     check_input(strict, bool)
@@ -110,3 +112,12 @@ def valid_list(variable:list[Any], entry_type:type,
             f"of length {min_length}")
     for entry in variable:
         check_input(entry, entry_type, alt_types=alt_types)
+
+def valid_path(variable:str, allow_base=False, extension:str="", min_length=1):
+    valid_string(variable, VALID_PATH_CHARS, min_length=min_length)
+    if not allow_base and variable.startswith(sep):
+        raise ValueError(f"Cannot accept path '{variable}'. Must be relative.")
+    if min_length > 0 and extension and not variable.endswith(extension):
+        raise ValueError(f"Path '{variable}' does not have required "
+            f"extension '{extension}'.")
+        

core/correctness/vars.py

@@ -1,6 +1,8 @@
 
 import os
 
+from inspect import signature
+
 CHAR_LOWERCASE = 'abcdefghijklmnopqrstuvwxyz'
 CHAR_UPPERCASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
 CHAR_NUMERIC = '0123456789'
@@ -15,4 +17,48 @@ VALID_VARIABLE_NAME_CHARS = CHAR_UPPERCASE + CHAR_LOWERCASE + CHAR_NUMERIC + "_"
 VALID_JUPYTER_NOTEBOOK_FILENAME_CHARS = VALID_NAME_CHARS + "." + os.path.sep
 VALID_JUPYTER_NOTEBOOK_EXTENSIONS = [".ipynb"]
 
-VALID_TRIGGERING_PATH_CHARS = VALID_NAME_CHARS + "." + os.path.sep
+VALID_PATH_CHARS = VALID_NAME_CHARS + "." + os.path.sep
+VALID_TRIGGERING_PATH_CHARS = VALID_NAME_CHARS + ".*" + os.path.sep
+
+BAREBONES_NOTEBOOK = {
+    "cells": [],
+    "metadata": {},
+    "nbformat": 4,
+    "nbformat_minor": 4
+}
+
+FILE_CREATE_EVENT = "file_created"
+FILE_MODIFY_EVENT = "file_modified"
+FILE_MOVED_EVENT = "file_moved"
+FILE_CLOSED_EVENT = "file_closed"
+FILE_DELETED_EVENT = "file_deleted"
+FILE_EVENTS = [
+    FILE_CREATE_EVENT, 
+    FILE_MODIFY_EVENT, 
+    FILE_MOVED_EVENT, 
+    FILE_CLOSED_EVENT, 
+    FILE_DELETED_EVENT
+]
+
+DIR_CREATE_EVENT = "dir_created"
+DIR_MODIFY_EVENT = "dir_modified"
+DIR_MOVED_EVENT = "dir_moved"
+DIR_DELETED_EVENT = "dir_deleted"
+DIR_EVENTS = [
+    DIR_CREATE_EVENT,
+    DIR_MODIFY_EVENT,
+    DIR_MOVED_EVENT,
+    DIR_DELETED_EVENT
+]
+
+PIPE_READ = 0
+PIPE_WRITE = 1
+
+def get_drt_imp_msg(base_class):
+    return f"{base_class.__name__} may not be instantiated directly. " \
+        f"Implement a child class."
+
+def get_not_imp_msg(parent_class, class_function):
+    return f"Children of the '{parent_class.__name__}' class must implement " \
+        f"the '{class_function.__name__}({signature(class_function)})' " \
+        "function"