fix(scanner): ignore common dependency and environment directories by default (#3)

fix(scanner): ignore common dependency and environment directories by default (#3)

Adds default ignores for common dependency, environment, build, and VCS directories
to reduce noise when scanning repository roots.

Ignored directories:
.venv, venv, env, site-packages, __pycache__, dist, build, and .git.

The ignore logic checks full path components to avoid accidental exclusion of
valid source directories (e.g., "environment"). Documentation has been updated
to reflect the new behavior and the version is bumped to 0.2.1.

Author: aureliuscanon

README.md

@@ -65,6 +65,8 @@ pip install privlog
 
 Once installed, you can run `privlog` against a specific path, or run it by itself to scan the current directory.
 
+> **Note:** `privlog` automatically ignores common dependency and build directories (like `.venv`, `site-packages`, `build`, etc.) to reduce noise.
+
 ### Default (Errors Only)
 
 By default, `privlog` only reports high-confidence `ERROR`s. If any are found, it will exit with a non-zero code, failing your build.
@@ -118,7 +120,7 @@ log_event = { details = "WARNING" }
 
 ## Status
 
-Privlog is currently in early development (v0.2.0).
+Privlog is currently in early development (v0.2.1).
 Feedback and contributions are welcome.
 
 ---

privlog/ast_checks.py

@@ -212,9 +212,27 @@ def visit_Call(self, node: ast.Call) -> None:
         self.generic_visit(node)
 
 
+DEFAULT_IGNORE_DIRS = {
+    ".venv",
+    "venv",
+    "env",
+    "site-packages",
+    "__pycache__",
+    "dist",
+    "build",
+    ".git",
+}
+
 def run_ast_checks(root: Path, config: PrivlogConfig) -> list[AstFinding]:
     findings: list[AstFinding] = []
-    for py in root.rglob("*.py"):
+    
+    all_python_files = root.rglob("*.py")
+
+    for py in all_python_files:
+        # Check if any parent directory component is in the ignore list
+        if any(part in DEFAULT_IGNORE_DIRS for part in py.parts):
+            continue
+
         try:
             text = py.read_text(encoding="utf-8", errors="replace")
             tree = ast.parse(text)

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "privlog"
-version = "0.2.0"
+version = "0.2.1"
 description = "Privacy-aware logging hygiene linter for Python"
 readme = "README.md"
 requires-python = ">=3.9"