inspectr 0.0.4__py3-none-any.whl → 0.1.0__py3-none-any.whl

inspectr/__main__.py

@@ -2,13 +2,14 @@ import sys
 import pathlib
 import importlib
 
+
 def main():
     if len(sys.argv) < 2:
-        print("Usage: inspectr <subtool> [files...]")
+        print("Usage: inspectr <subtool> [options] [files...]")
         sys.exit(1)
 
     subtool = sys.argv[1]
-    args = [pathlib.Path(arg) for arg in sys.argv[2:]]
+    remaining_args = sys.argv[2:]
 
     try:
         mod = importlib.import_module(f"inspectr.{subtool}")
@@ -21,7 +22,31 @@ def main():
         print(f"Subtool '{subtool}' does not define a main(args) function")
         sys.exit(1)
 
-    mod.main(args)
+    files = []
+    kwargs = {}
+    
+    # convert --option style options into keyword arguments
+    i = 0
+    while i < len(remaining_args):
+        arg = remaining_args[i]
+        if arg.startswith("--"):
+            option_name = arg[2:].replace("-", "_")
+            if i + 1 < len(remaining_args) and not remaining_args[i + 1].startswith("--"):
+                value = remaining_args[i + 1]
+                try:
+                    kwargs[option_name] = int(value)
+                except ValueError:
+                    kwargs[option_name] = value
+                i += 2
+            else:
+                kwargs[option_name] = True
+                i += 1
+        else:
+            files.append(pathlib.Path(arg))
+            i += 1
+    
+    mod.main(files, **kwargs)
+
 
 if __name__ == "__main__":
     main()

inspectr/authenticity.py

@@ -4,15 +4,28 @@ import pathlib
 from typing import List
 
 
-def main(files: List[pathlib.Path]) -> None:
+def main(files: List[pathlib.Path], **kwargs) -> None:
+    for f in files:
+        if not f.exists():
+            print(f"Error: file does not exist: {f}")
+            return
+        if not f.is_file():
+            print(f"Error: not a file: {f}")
+            return
+
     todo_count = 0
+    fixme_count = 0
+    placeholder_count = 0
     empty_try_except_count = 0
     stub_functions = []
 
     for f in files:
         src = f.read_text(encoding="utf-8")
 
+        # TODO: make these case insensitive
         todo_count += src.count("TODO")
+        fixme_count += src.count("FIXME")
+        placeholder_count += src.count("Placeholder")
 
         try:
             tree = ast.parse(src, filename=str(f))
@@ -31,19 +44,31 @@ def main(files: List[pathlib.Path]) -> None:
             if isinstance(node, ast.FunctionDef):
                 # Only consider body statements that are `pass` or empty return
                 is_stub = True
-                for stmt in node.body:
+                non_docstring_seen = False
+                for i, stmt in enumerate(node.body):
                     if isinstance(stmt, ast.Pass):
+                        non_docstring_seen = True
                         continue
                     elif isinstance(stmt, ast.Return) and stmt.value is None:
+                        non_docstring_seen = True
                         continue
+                    elif isinstance(stmt, ast.Expr) and isinstance(stmt.value, ast.Constant) and isinstance(stmt.value.value, str):
+                        # ignore docstrings
+                        if i == 0 or (i == 1 and not non_docstring_seen):
+                            continue
+                        else:
+                            is_stub = False
+                            break
                     else:
                         is_stub = False
                         break
-                if is_stub:
+                if is_stub and len(node.body) > 0:
                     stub_functions.append(f"{f}:{node.name}")
 
     print("Analysis results:")
     print(f"  TODO comments: {todo_count}")
+    print(f"  FIXME comments: {fixme_count}")
+    print(f"  Placeholder comments: {placeholder_count}")
     print(f"  Empty try/except blocks: {empty_try_except_count}")
     print(f"  Stub functions/methods: {len(stub_functions)}")
     for stub in stub_functions:

inspectr/bare_ratio.py

@@ -5,7 +5,16 @@ from collections import defaultdict, Counter
 from typing import List
 
 
-def main(files: List[pathlib.Path]) -> None:
+def main(files: List[pathlib.Path], **kwargs) -> None:
+    for f in files:
+        if not f.exists():
+            print(f"Error: File does not exist: {f}")
+            return
+        
+        if not f.is_file():
+            print(f"Error: Not a file: {f}")
+            return
+
     # distinct exception types
     exception_types = Counter()
 

inspectr/compare_funcs.py

@@ -0,0 +1,118 @@
+import ast
+import os
+from pathlib import Path
+from collections import defaultdict
+from typing import List
+
+
+def extract_functions(file_path: str):
+    """Return a set of top-level functions and class methods from a Python file."""
+    functions = []
+    try:
+        with open(file_path, "r", encoding="utf-8") as f:
+            tree = ast.parse(f.read(), filename=file_path)
+    except (SyntaxError, FileNotFoundError):
+        return functions
+
+    for node in ast.walk(tree):
+        if isinstance(node, ast.FunctionDef):
+            functions.append(node.name)
+        elif isinstance(node, ast.AsyncFunctionDef):
+            functions.append(node.name)
+    return functions
+
+
+def compare_functions(dir1: str, dir2: str, rel_files: list[str]):
+    functions_in_dir1 = defaultdict(list)
+    functions_in_dir2 = defaultdict(list)
+
+    for rel in rel_files:
+        file1 = os.path.join(dir1, rel)
+        file2 = os.path.join(dir2, rel)
+
+        funcs1 = extract_functions(file1)
+        funcs2 = extract_functions(file2)
+
+        for fn in funcs1:
+            functions_in_dir1[fn].append(rel)
+        for fn in funcs2:
+            functions_in_dir2[fn].append(rel)
+
+        common_set = set(funcs1) & set(funcs2)
+        if common_set:
+            print(f"\n[{rel}]")
+            print("  Common functions/methods:")
+            for fn in sorted(common_set):
+                count1 = funcs1.count(fn)
+                count2 = funcs2.count(fn)
+                if count1 > 1 or count2 > 1:
+                    print(f"    - {fn} (appears {count1} times in dir1, {count2} times in dir2)")
+                else:
+                    print(f"    - {fn}")
+        else:
+            print(f"No functions in common between {dir1} and {dir2} in {rel}")
+
+    # cross-file check: moved functions
+    moved = []
+    for fn in set(functions_in_dir1.keys()) | set(functions_in_dir2.keys()):
+        files1 = set(functions_in_dir1.get(fn, []))
+        files2 = set(functions_in_dir2.get(fn, []))
+        if files2 and files1 and files1 != files2:
+            intersection = files1 & files2
+            if not intersection:
+                moded.append((fn, files1, files2))
+
+    if moved:
+        print("\nFunctions/methods that appear to have moved:")
+        for fn, f1, f2 in moved:
+            count1 = len(functions_in_dir1[fn])
+            count2 = len(functions_in_dir2[fn])
+            if count1 > 1 or count2 > 1:
+                print(f"  {fn} (appears {count1} times in dir1, {count2} times in dir2): {f1} -> {f2}")
+            else:
+                print(f"  {fn}: {f1} -> {f2}")
+    else:
+        print("No functions moved to a different file")
+
+
+def main(files: List[Path], **kwargs) -> None:
+    if len(files) < 3:
+        print("Usage: inspectr compare_funcs <files_list.txt> <dir1> <dir2>")
+        print("  files_list.txt: text file containing relative paths to compare, one per line")
+        print("  dir1: first directory")
+        print("  dir2: second directory")
+        return
+
+    files_list_path = files[0]
+    dir1 = files[1]
+    dir2 = files[2]
+
+    if not files_list_path.exists():
+        print(f"Error: File list does not exist: {files_list_path}")
+        return
+
+    if not files_list_path.is_file():
+        print(f"Error: Not a file: {files_list_path}")
+        return
+
+    if not dir1.exists():
+        print(f"Error: Directory does not exist: {dir1}")
+        return
+
+    if not dir1.is_dir():
+        print(f"Error: Not a directory: {dir1}")
+        return
+
+    if not dir2.exists():
+        print(f"Error: Directory does not exist: {dir2}")
+        return
+
+    if not dir2.is_dir():
+        print(f"Error: Not a directory: {dir2}")
+        return
+
+    with open(files_list_path, "r", encoding="utf-8") as f:
+        rel_files = [line.rstrip("\n") for line in f if line.strip()]
+
+    compare_functions(str(dir1), str(dir2), rel_files)
+