Skip to content

v0.7.2

Choose a tag to compare

@ameyachopade ameyachopade released this 13 Nov 11:00
· 13 commits to main since this release

What's Changed in Gitlytics v0.7.2

Gitlytics v0.7.2 is a major release featuring the refreshed, standalone React 19 analytics dashboard bundled directly inside the PyPI wheel, standardized CLI stream contracts, full PEP 639 licensing compliance, and resilient stargazer trajectory tracking.


Key Highlights

Embedded React 19 Dashboard (gitlytics dashboard)

  • Zero-Dependency Local Studio: pip install "gitlytics[dashboard]" packages the complete React 19 + Tailwind CSS v4 dashboard in src/gitlytics/static/.
  • Pure Local Mode: Automatically eliminates cloud-only routes when run locally, allowing instant analytics using a GitHub Personal Access Token (PAT) or CSV backup files.
  • Strict Asset Resolution: All static bundle assets are verified with zero external runtime dependencies.

CLI Output Integrity & Standard Streams

  • Strict Stream Separation: Tabular data and fetch summaries route strictly to stdout, while logs, progress indicators, and errors route to stderr. Safe to pipe directly into file redirects or downstream scripts:
    gitlytics fetch --token "$GITHUB_TOKEN" --save-file traffic.csv
  • Standardized Process Exit Codes:
    • 0: Operation succeeded cleanly.
    • 1: Runtime or upstream GitHub API error (rate limits, network timeout).
    • 2: Invalid command-line arguments or syntax.

Resilient Star Trajectories & Caching

  • Fallback Trajectory Engine: Gracefully falls back to milestone estimations when GitHub restricts public stargazer endpoints.
  • Bounded In-Memory Cache: Token-scoped negative caching prevents repeated rate-limit burns on unreachable repositories.

PEP 639 Compliance & Quality Verification

  • Fully compliant LicenseRef-Apache-2.0-with-Commons-Clause specification in pyproject.toml.
  • 381 Unit Tests passing in Python 3.11, 3.12, and 3.13 with zero deprecation warnings (filterwarnings = error).
  • Fully isolated CI workflow without cross-repo dependencies.

Installation & Quickstart

Install via pip:

# Core CLI & Analytics SDK
pip install gitlytics

# With embedded React dashboard
pip install "gitlytics[dashboard]"

Launch Local Studio:

gitlytics dashboard
# Open http://127.0.0.1:8000

Synchronize Indefinite Traffic Backups:

gitlytics sync --token "ghp_your_token" --data-dir "./data"

Useful Links