How m-ahmed-elbeskeri/starguard works
Project type and purpose
• StarGuard is an open-source, Python-based CLI tool for automated due-diligence on GitHub repositories. It collects public metadata, runs a series of analyzers and parsers, computes a composite “trust score,” and emits reports (JSON, Markdown, badges, plots).
File structure
• Top level:
• .github/workflows/publish.yml – CI job to publish to PyPI.
• pyproject.toml – build metadata, dependencies, entry point.
• starguard.py – the single-file codebase containing:
– CLI argument parsing
– GitHub API/GraphQL client
– Collector modules (stars, forks, issues, traffic)
– Analyzer modules (BurstDetector, UserProfiler)
– Dependency & licence parsers
– Scoring engine (ScoreCombiner)
– Output generators (text, JSON, Markdown, plot, badges)
• README.md & LICENSE
README for architectural insights
GH API → Collectors → Analyzers + Parser → ScoreCombiner → Output
• Key components are described in prose (BurstDetector, UserProfiler, Scoring Engine, etc.)