ignore files for -- watch`

Author: hamelsmu

docs/.gitignore

@@ -14,3 +14,5 @@ _inv
 objects.json
 _sidebar.yml
 _extensions
+
+/.luarc.json

quartodoc/__main__.py

@@ -8,8 +8,9 @@
 from pathlib import Path
 from watchdog.observers import Observer
 from functools import partial
-from watchdog.events import FileSystemEventHandler
+from watchdog.events import PatternMatchingEventHandler
 from quartodoc import Builder, convert_inventory
+from typing import List
 
 def get_package_path(package_name):
     """
@@ -21,11 +22,28 @@ def get_package_path(package_name):
     except ModuleNotFoundError:
         raise ModuleNotFoundError(f"Package {package_name} not found.  Please install it in your environment.")
 
-class FileChangeHandler(FileSystemEventHandler):
+class QuartoDocFileChangeHandler(PatternMatchingEventHandler):
     """
     A handler for file changes.
     """
+
+    # Ignore patterns for the file watcher that are not relevant to the docs
+    py_ignore_patterns = [
+        '*/__pycache__/*',  # These are the compiled python code files which are automatically generated by Python
+        '*/.ipynb_checkpoints/*',  # This directory is created by Jupyter Notebook for auto-saving notebooks
+        '*/.vscode/*',  # If you're using Visual Studio Code, it creates this directory to store settings specific to that project.
+        '*/.idea/*',  # Similar to .vscode/, but for JetBrains IDEs like PyCharm.
+        '*/.git/*',  # i This directory is created by Git. It's not relevant to the docs.
+        '*/venv/*', '*/env/*',  '*/.env/*',  # Common names for directories containing a Python virtual environment.
+        '*/.pytest_cache/*',  # This directory is created when you run Pytest.
+        '*/.eggs/*', '*/dist/*', '*/build/*', '*/*.egg-info/*', # These are typically created when building Python packages with setuptools.
+        '*.pyo',  # These are optimized .pyc files, created when Python is run with the -O flag.
+        '*.pyd',  # This is the equivalent of a .pyc file, but for C extensions on Windows.
+        '*/.mypy_cache/*', # This directory is created when you run mypy.
+    ]
+
     def __init__(self, callback):
+        super().__init__(ignore_patterns=self.py_ignore_patterns)
         self.callback = callback
 
     @classmethod
@@ -71,9 +89,6 @@ def cli():
     pass
 
 
-
-
-
 @click.command()
 @click.option("--config", default="_quarto.yml", help="Change the path to the configuration file.  The default is `./_quarto.yml`")
 @click.option("--filter", nargs=1, default="*", help="Specify the filter to select specific files. The default is '*' which selects all files.")
@@ -97,7 +112,7 @@ def build(config, filter, dry_run, watch, verbose):
             if watch:
                 pkg_path = get_package_path(builder.package)
                 print(f"Watching {pkg_path} for changes...")
-                event_handler = FileChangeHandler(callback=doc_build)
+                event_handler = QuartoDocFileChangeHandler(callback=doc_build)
                 observer = Observer()
                 observer.schedule(event_handler, pkg_path, recursive=True)
                 observer.start()