ghostbuster-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-08-29
+
+### Fixed
+
+- Use absolute GitHub raw asset URLs in `README.md` so headers and icons render properly on PyPI and third-party package viewers.
+
+## [0.2.1] - 2026-08-29
+
+### Fixed
+
+- `ghostbuster bust --confirm` now properly removes unused dependencies from `requirements.txt` and `pyproject.toml`.
+
 ## [0.2.0] - 2026-08-29
 
 ### Added

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ghostbuster-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Find and bust the ghosts haunting your codebase - unused deps, dead code, orphan files, and phantom env vars.
 Project-URL: Homepage, https://github.com/adewanggar/ghostbuster-cli
 Project-URL: Documentation, https://github.com/adewanggar/ghostbuster-cli#readme
@@ -38,17 +38,16 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-<img src="assets/readme_header.png" alt="Ghostbuster Header" width="100%" />
+<img src="https://raw.githubusercontent.com/adewanggar/ghostbuster-cli/main/assets/readme_header.png" alt="Ghostbuster Header" width="100%" />
 
 # Ghostbuster
 
 **Find and bust the ghosts haunting your codebase.**
 
-[![PyPI version](https://img.shields.io/pypi/v/ghostbuster-cli?color=blue&label=PyPI)](https://pypi.org/project/ghostbuster-cli/)
-[![Python](https://img.shields.io/pypi/pyversions/ghostbuster-cli)](https://pypi.org/project/ghostbuster-cli/)
+[![PyPI version](https://img.shields.io/pypi/v/ghostbuster-cli?color=blue&label=PyPI&logo=pypi)](https://pypi.org/project/ghostbuster-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/ghostbuster-cli?logo=python)](https://pypi.org/project/ghostbuster-cli/)
 [![CI](https://github.com/adewanggar/ghostbuster-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/adewanggar/ghostbuster-cli/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Downloads](https://img.shields.io/pypi/dm/ghostbuster-cli)](https://pypi.org/project/ghostbuster-cli/)
 
 Unused dependencies, dead functions, orphan files, and phantom environment variables lurk in codebases - slowing down repos, confusing new contributors, and wasting CI minutes.
 
@@ -58,7 +57,7 @@ Unused dependencies, dead functions, orphan files, and phantom environment varia
 
 ---
 
-## <img src="assets/terminal_icon.png" width="24" height="24" valign="middle" /> Quick Start
+## <img src="https://raw.githubusercontent.com/adewanggar/ghostbuster-cli/main/assets/terminal_icon.png" width="24" height="24" valign="middle" /> Quick Start
 
 ```bash
 # Install
@@ -226,7 +225,7 @@ Ghostbuster uses **pure AST analysis** - no runtime imports, no code execution,
 
 ## Roadmap
 
-- <img src="assets/npm_package_icon.png" width="18" height="18" valign="middle" /> Node.js / TypeScript support (scan `package.json`, dead exports)
+- <img src="https://raw.githubusercontent.com/adewanggar/ghostbuster-cli/main/assets/npm_package_icon.png" width="18" height="18" valign="middle" /> Node.js / TypeScript support (scan `package.json`, dead exports)
 - Pre-commit hook integration
 - GitHub Actions reporter (comment Ghost Score on PRs)
 - Config inheritance for monorepos

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/README.md

@@ -1,16 +1,15 @@
 <div align="center">
 
-<img src="assets/readme_header.png" alt="Ghostbuster Header" width="100%" />
+<img src="https://raw.githubusercontent.com/adewanggar/ghostbuster-cli/main/assets/readme_header.png" alt="Ghostbuster Header" width="100%" />
 
 # Ghostbuster
 
 **Find and bust the ghosts haunting your codebase.**
 
-[![PyPI version](https://img.shields.io/pypi/v/ghostbuster-cli?color=blue&label=PyPI)](https://pypi.org/project/ghostbuster-cli/)
-[![Python](https://img.shields.io/pypi/pyversions/ghostbuster-cli)](https://pypi.org/project/ghostbuster-cli/)
+[![PyPI version](https://img.shields.io/pypi/v/ghostbuster-cli?color=blue&label=PyPI&logo=pypi)](https://pypi.org/project/ghostbuster-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/ghostbuster-cli?logo=python)](https://pypi.org/project/ghostbuster-cli/)
 [![CI](https://github.com/adewanggar/ghostbuster-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/adewanggar/ghostbuster-cli/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Downloads](https://img.shields.io/pypi/dm/ghostbuster-cli)](https://pypi.org/project/ghostbuster-cli/)
 
 Unused dependencies, dead functions, orphan files, and phantom environment variables lurk in codebases - slowing down repos, confusing new contributors, and wasting CI minutes.
 
@@ -20,7 +19,7 @@ Unused dependencies, dead functions, orphan files, and phantom environment varia
 
 ---
 
-## <img src="assets/terminal_icon.png" width="24" height="24" valign="middle" /> Quick Start
+## <img src="https://raw.githubusercontent.com/adewanggar/ghostbuster-cli/main/assets/terminal_icon.png" width="24" height="24" valign="middle" /> Quick Start
 
 ```bash
 # Install
@@ -188,7 +187,7 @@ Ghostbuster uses **pure AST analysis** - no runtime imports, no code execution,
 
 ## Roadmap
 
-- <img src="assets/npm_package_icon.png" width="18" height="18" valign="middle" /> Node.js / TypeScript support (scan `package.json`, dead exports)
+- <img src="https://raw.githubusercontent.com/adewanggar/ghostbuster-cli/main/assets/npm_package_icon.png" width="18" height="18" valign="middle" /> Node.js / TypeScript support (scan `package.json`, dead exports)
 - Pre-commit hook integration
 - GitHub Actions reporter (comment Ghost Score on PRs)
 - Config inheritance for monorepos

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ghostbuster-cli"
-version = "0.2.0"
+version = "0.2.2"
 description = "Find and bust the ghosts haunting your codebase - unused deps, dead code, orphan files, and phantom env vars."
 readme = "README.md"
 license = "MIT"

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/src/ghostbuster/__init__.py

@@ -1,3 +1,3 @@
 """Ghostbuster — Find and bust the ghosts haunting your codebase."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

ghostbuster_cli-0.2.2/src/ghostbuster/fixers/import_fixer.py

@@ -0,0 +1,217 @@
+"""Import Fixer - removes unused packages from requirements/pyproject and unused import statements."""
+
+from __future__ import annotations
+
+import ast
+import re
+from pathlib import Path
+
+from ghostbuster.core.models import Ghost, GhostCategory
+
+
+class ImportFixer:
+    """Removes unused dependencies from config files and unused import statements."""
+
+    def preview(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Preview what changes would be made (dry-run mode)."""
+        changes: list[str] = []
+        dead_ghosts = [g for g in ghosts if g.category == GhostCategory.DEAD_IMPORT and g.fixable]
+        if not dead_ghosts:
+            return changes
+
+        # 1. Preview removing from requirements.txt and pyproject.toml
+        changes.extend(self._preview_config_removals(dead_ghosts))
+
+        # 2. Preview removing unused import statements from Python files
+        dead_packages = self._get_dead_package_names(dead_ghosts)
+        for py_file in path.rglob("*.py"):
+            parts = py_file.relative_to(path).parts
+            if any(p in {"venv", ".venv", "node_modules", ".git", "__pycache__"} for p in parts):
+                continue
+
+            file_changes = self._find_removable_imports(py_file, dead_packages)
+            changes.extend(file_changes)
+
+        return changes
+
+    def fix(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Apply fixes: remove unused dependencies from config and import statements."""
+        applied: list[str] = []
+        dead_ghosts = [g for g in ghosts if g.category == GhostCategory.DEAD_IMPORT and g.fixable]
+        if not dead_ghosts:
+            return applied
+
+        # 1. Remove from requirements.txt and pyproject.toml
+        applied.extend(self._apply_config_removals(dead_ghosts))
+
+        # 2. Remove unused import statements from Python files
+        dead_packages = self._get_dead_package_names(dead_ghosts)
+        for py_file in path.rglob("*.py"):
+            parts = py_file.relative_to(path).parts
+            if any(p in {"venv", ".venv", "node_modules", ".git", "__pycache__"} for p in parts):
+                continue
+
+            result = self._remove_imports_from_file(py_file, dead_packages)
+            applied.extend(result)
+
+        return applied
+
+    def _get_dead_package_names(self, ghosts: list[Ghost]) -> set[str]:
+        """Extract package names from dead-import ghost findings."""
+        return {
+            g.name.lower().replace("-", "_")
+            for g in ghosts
+            if g.category == GhostCategory.DEAD_IMPORT
+        }
+
+    def _preview_config_removals(self, ghosts: list[Ghost]) -> list[str]:
+        """Preview removal of dependencies from requirements.txt and pyproject.toml."""
+        changes: list[str] = []
+        for ghost in ghosts:
+            if ghost.file_path and ghost.file_path.exists():
+                changes.append(f"  Would remove '{ghost.name}' from {ghost.file_path.name}")
+        return changes
+
+    def _apply_config_removals(self, ghosts: list[Ghost]) -> list[str]:
+        """Remove declared dependencies from requirements.txt and pyproject.toml."""
+        applied: list[str] = []
+
+        # Group by config file
+        by_file: dict[Path, list[str]] = {}
+        for ghost in ghosts:
+            if ghost.file_path and ghost.file_path.exists():
+                by_file.setdefault(ghost.file_path, []).append(ghost.name)
+
+        for file_path, package_names in by_file.items():
+            if file_path.name == "requirements.txt" or file_path.name.endswith(".txt"):
+                removed = self._remove_from_requirements_txt(file_path, package_names)
+                for pkg in removed:
+                    applied.append(f"  Removed '{pkg}' from {file_path.name}")
+            elif file_path.name == "pyproject.toml":
+                removed = self._remove_from_pyproject_toml(file_path, package_names)
+                for pkg in removed:
+                    applied.append(f"  Removed '{pkg}' from {file_path.name}")
+
+        return applied
+
+    def _remove_from_requirements_txt(self, filepath: Path, package_names: list[str]) -> list[str]:
+        """Remove package entries from a requirements.txt file."""
+        removed: list[str] = []
+        try:
+            lines = filepath.read_text(encoding="utf-8").splitlines(keepends=True)
+            norm_targets = {p.lower().replace("-", "_") for p in package_names}
+
+            new_lines: list[str] = []
+            for line in lines:
+                stripped = line.strip()
+                if not stripped or stripped.startswith("#") or stripped.startswith("-"):
+                    new_lines.append(line)
+                    continue
+
+                pkg_name = re.split(r"[>=<!\[;@]", stripped)[0].strip()
+                norm_pkg = pkg_name.lower().replace("-", "_")
+
+                if norm_pkg in norm_targets:
+                    removed.append(pkg_name)
+                else:
+                    new_lines.append(line)
+
+            if removed:
+                filepath.write_text("".join(new_lines), encoding="utf-8")
+        except OSError:
+            pass
+
+        return removed
+
+    def _remove_from_pyproject_toml(self, filepath: Path, package_names: list[str]) -> list[str]:
+        """Remove package entries from dependencies list in pyproject.toml."""
+        removed: list[str] = []
+        try:
+            lines = filepath.read_text(encoding="utf-8").splitlines(keepends=True)
+            norm_targets = {p.lower().replace("-", "_") for p in package_names}
+
+            new_lines: list[str] = []
+            for line in lines:
+                stripped = line.strip().strip(",").strip('"').strip("'")
+                pkg_name = re.split(r"[>=<!\[;@]", stripped)[0].strip()
+                norm_pkg = pkg_name.lower().replace("-", "_")
+
+                if norm_pkg in norm_targets and ("=" not in stripped or "[" not in stripped):
+                    removed.append(pkg_name)
+                else:
+                    new_lines.append(line)
+
+            if removed:
+                filepath.write_text("".join(new_lines), encoding="utf-8")
+        except OSError:
+            pass
+
+        return removed
+
+    def _find_removable_imports(self, filepath: Path, dead_packages: set[str]) -> list[str]:
+        """Find import statements that can be removed from a file."""
+        changes: list[str] = []
+        try:
+            source = filepath.read_text(encoding="utf-8", errors="ignore")
+            tree = ast.parse(source, filename=str(filepath))
+        except (SyntaxError, OSError):
+            return changes
+
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Import):
+                for alias in node.names:
+                    pkg = alias.name.split(".")[0].lower().replace("-", "_")
+                    if pkg in dead_packages:
+                        changes.append(
+                            f"  Would remove: 'import {alias.name}' from {filepath.name}:{node.lineno}"
+                        )
+            elif isinstance(node, ast.ImportFrom) and node.module:
+                pkg = node.module.split(".")[0].lower().replace("-", "_")
+                if pkg in dead_packages:
+                    names = ", ".join(a.name for a in node.names)
+                    changes.append(
+                        f"  Would remove: 'from {node.module} import {names}' from {filepath.name}:{node.lineno}"
+                    )
+
+        return changes
+
+    def _remove_imports_from_file(self, filepath: Path, dead_packages: set[str]) -> list[str]:
+        """Remove import statements for dead packages from a single file."""
+        applied: list[str] = []
+        try:
+            source = filepath.read_text(encoding="utf-8", errors="ignore")
+            tree = ast.parse(source, filename=str(filepath))
+        except (SyntaxError, OSError):
+            return applied
+
+        lines_to_remove: set[int] = set()
+
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Import):
+                for alias in node.names:
+                    pkg = alias.name.split(".")[0].lower().replace("-", "_")
+                    if pkg in dead_packages:
+                        lines_to_remove.add(node.lineno)
+                        applied.append(
+                            f"  Removed: 'import {alias.name}' from {filepath.name}:{node.lineno}"
+                        )
+            elif isinstance(node, ast.ImportFrom) and node.module:
+                pkg = node.module.split(".")[0].lower().replace("-", "_")
+                if pkg in dead_packages:
+                    lines_to_remove.add(node.lineno)
+                    if node.end_lineno and node.end_lineno > node.lineno:
+                        for ln in range(node.lineno, node.end_lineno + 1):
+                            lines_to_remove.add(ln)
+                    names = ", ".join(a.name for a in node.names)
+                    applied.append(
+                        f"  Removed: 'from {node.module} import {names}' from {filepath.name}:{node.lineno}"
+                    )
+
+        if lines_to_remove:
+            source_lines = source.splitlines(keepends=True)
+            new_lines = [
+                line for i, line in enumerate(source_lines, start=1) if i not in lines_to_remove
+            ]
+            filepath.write_text("".join(new_lines), encoding="utf-8")
+
+        return applied

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/tests/test_cli.py

@@ -17,7 +17,7 @@ class TestCLI:
         result = runner.invoke(app, ["--version"])
         assert result.exit_code == 0
         assert "ghostbuster" in result.output
-        assert "0.2.0" in result.output
+        assert "0.2.2" in result.output
 
     def test_help_flag(self) -> None:
         """--help should print help text."""

{ghostbuster_cli-0.2.0 → ghostbuster_cli-0.2.2}/tests/test_fixers.py

@@ -7,6 +7,39 @@ from pathlib import Path
 from ghostbuster.core.models import Ghost, GhostCategory, Severity
 from ghostbuster.fixers.env_fixer import EnvFixer
 from ghostbuster.fixers.gitignore_fixer import GitignoreFixer
+from ghostbuster.fixers.import_fixer import ImportFixer
+
+
+class TestImportFixer:
+    """Tests for ImportFixer."""
+
+    def test_remove_dead_import_from_requirements_txt(self, tmp_path: Path) -> None:
+        """Should remove dead package from requirements.txt."""
+        req_file = tmp_path / "requirements.txt"
+        req_file.write_text("requests==2.28.0\nlxml>=4.9.0\npyyaml\n", encoding="utf-8")
+
+        ghosts = [
+            Ghost(
+                category=GhostCategory.DEAD_IMPORT,
+                name="lxml",
+                message="lxml is unused",
+                file_path=req_file,
+                severity=Severity.MEDIUM,
+                fixable=True,
+            ),
+        ]
+
+        fixer = ImportFixer()
+        preview = fixer.preview(ghosts, tmp_path)
+        assert any("lxml" in p for p in preview)
+
+        applied = fixer.fix(ghosts, tmp_path)
+        assert len(applied) == 1
+
+        content = req_file.read_text(encoding="utf-8")
+        assert "lxml" not in content
+        assert "requests==2.28.0" in content
+        assert "pyyaml" in content
 
 
 class TestGitignoreFixer:

ghostbuster_cli-0.2.0/src/ghostbuster/fixers/import_fixer.py

@@ -1,133 +0,0 @@
-"""Import Fixer — removes unused import statements from Python files.
-
-Works with the dead-import scanner findings to automatically clean up
-import statements that reference packages no longer needed.
-"""
-
-from __future__ import annotations
-
-import ast
-from pathlib import Path
-
-from ghostbuster.core.models import Ghost, GhostCategory
-
-
-class ImportFixer:
-    """Removes unused import statements from Python files.
-
-    This fixer works on a per-file basis, removing import lines that
-    reference packages identified as dead imports.
-    """
-
-    def preview(self, ghosts: list[Ghost], path: Path) -> list[str]:
-        """Preview what changes would be made (dry-run mode).
-
-        Returns a list of human-readable descriptions of changes.
-        """
-        changes: list[str] = []
-        dead_packages = self._get_dead_package_names(ghosts)
-
-        for py_file in path.rglob("*.py"):
-            parts = py_file.relative_to(path).parts
-            if any(p in {"venv", ".venv", "node_modules", ".git", "__pycache__"} for p in parts):
-                continue
-
-            file_changes = self._find_removable_imports(py_file, dead_packages)
-            changes.extend(file_changes)
-
-        return changes
-
-    def fix(self, ghosts: list[Ghost], path: Path) -> list[str]:
-        """Actually apply fixes: remove unused import statements.
-
-        Returns a list of applied changes.
-        """
-        applied: list[str] = []
-        dead_packages = self._get_dead_package_names(ghosts)
-
-        for py_file in path.rglob("*.py"):
-            parts = py_file.relative_to(path).parts
-            if any(p in {"venv", ".venv", "node_modules", ".git", "__pycache__"} for p in parts):
-                continue
-
-            result = self._remove_imports_from_file(py_file, dead_packages)
-            applied.extend(result)
-
-        return applied
-
-    def _get_dead_package_names(self, ghosts: list[Ghost]) -> set[str]:
-        """Extract package names from dead-import ghost findings."""
-        return {
-            g.name.lower().replace("-", "_")
-            for g in ghosts
-            if g.category == GhostCategory.DEAD_IMPORT
-        }
-
-    def _find_removable_imports(self, filepath: Path, dead_packages: set[str]) -> list[str]:
-        """Find import statements that can be removed from a file."""
-        changes: list[str] = []
-        try:
-            source = filepath.read_text(encoding="utf-8", errors="ignore")
-            tree = ast.parse(source, filename=str(filepath))
-        except (SyntaxError, OSError):
-            return changes
-
-        for node in ast.walk(tree):
-            if isinstance(node, ast.Import):
-                for alias in node.names:
-                    pkg = alias.name.split(".")[0].lower().replace("-", "_")
-                    if pkg in dead_packages:
-                        changes.append(
-                            f"  Would remove: 'import {alias.name}' from {filepath.name}:{node.lineno}"
-                        )
-            elif isinstance(node, ast.ImportFrom) and node.module:
-                pkg = node.module.split(".")[0].lower().replace("-", "_")
-                if pkg in dead_packages:
-                    names = ", ".join(a.name for a in node.names)
-                    changes.append(
-                        f"  Would remove: 'from {node.module} import {names}' from {filepath.name}:{node.lineno}"
-                    )
-
-        return changes
-
-    def _remove_imports_from_file(self, filepath: Path, dead_packages: set[str]) -> list[str]:
-        """Remove import statements for dead packages from a single file."""
-        applied: list[str] = []
-        try:
-            source = filepath.read_text(encoding="utf-8", errors="ignore")
-            tree = ast.parse(source, filename=str(filepath))
-        except (SyntaxError, OSError):
-            return applied
-
-        lines_to_remove: set[int] = set()
-
-        for node in ast.walk(tree):
-            if isinstance(node, ast.Import):
-                for alias in node.names:
-                    pkg = alias.name.split(".")[0].lower().replace("-", "_")
-                    if pkg in dead_packages:
-                        lines_to_remove.add(node.lineno)
-                        applied.append(
-                            f"  Removed: 'import {alias.name}' from {filepath.name}:{node.lineno}"
-                        )
-            elif isinstance(node, ast.ImportFrom) and node.module:
-                pkg = node.module.split(".")[0].lower().replace("-", "_")
-                if pkg in dead_packages:
-                    lines_to_remove.add(node.lineno)
-                    # Handle multi-line imports
-                    if node.end_lineno and node.end_lineno > node.lineno:
-                        for ln in range(node.lineno, node.end_lineno + 1):
-                            lines_to_remove.add(ln)
-                    names = ", ".join(a.name for a in node.names)
-                    applied.append(
-                        f"  Removed: 'from {node.module} import {names}' from {filepath.name}:{node.lineno}"
-                    )
-
-        if lines_to_remove:
-            source_lines = source.splitlines(keepends=True)
-            new_lines = [
-                line for i, line in enumerate(source_lines, start=1) if i not in lines_to_remove
-            ]
-            filepath.write_text("".join(new_lines), encoding="utf-8")
-
-        return applied