Skip to content

Releases

v0.8.0

Choose a tag to compare

@ameyachopade ameyachopade released this 19 Nov 09:35
2bfcce4

What's New in v0.8.0

Architecture & Packaging

  • Modular 5-Subpackage Layout: Reorganized the package into gitlytics.core, gitlytics.io, gitlytics.automation, gitlytics.api, and gitlytics.cli (with backwards-compatible shims and centralized exceptions).
  • Local-Mode Dashboard Bundle: Shipped an optimized local-mode React build with cloud-only chunks excluded and PDF export vendors split for faster loading.
  • Zero-Warning Test & Build Pipeline: Migrated dev test client dependencies to httpx2, formatted the codebase with Ruff, and updated README.md and SECURITY.md.

Security & Reliability Hardening

  • Dashboard Bind & Token Safety:
    • gitlytics dashboard now requires --public-bind for all non-loopback hosts (0.0.0.0, ::, LAN IPs) while preserving explicit --host values when --public-bind is set.
    • gitlytics dashboard no longer silently promotes ambient GITHUB_TOKEN from the shell environment into the local web server.
  • Principal & Privacy Isolation:
    • Scoped GITLYTICS_DATA_DIR CSV archives in POST /api/traffic to the authenticated token owner and surfaced TokenExpiredError as HTTP 401.
    • Added is:public filtering to public repository search lookups (GET/POST /api/username) and dropped all historical rows of private repositories when export_public_only=True.
  • API & Upload Protections:
    • Enforced GITLYTICS_UPLOAD_KEY checks before Origin/Referer verification on POST /api/upload-csv.
    • Added trusted Host allowlist checks (127.0.0.1, localhost, ::1, or GITLYTICS_ALLOWED_HOSTS), unconditional application/json validation on browser POST routes, and blocked /_headers and dotfiles in the SPA fallback.
    • Stream-capped multipart upload bodies (5 MiB) before form parsing and enforced CSV limits (50,000 rows, 2,000 unique repositories).
  • Core Client & Validation:
    • Validated owner/repo identifiers before URL interpolation in get_deep_repo_stats() and get_repo_traffic().
    • Replaced the global operation deadline with a ContextVar so concurrent threads cannot poison retry budgets.

CI & Release Supply Chain

  • Cross-Platform Python 3.11–3.14 Matrix: Added dedicated CI workflows across Linux, Windows, and macOS (linux.yml, windows.yml, macos.yml), packaging/base-install verification (packaging.yml), Ruff + pip-audit checks (lint-security.yml), and Dependabot (dependabot.yml).
  • Hardened OIDC PyPI Publishing: Isolated publish.yml so builds and tests run in an unprivileged job and only the verified artifact is promoted for attested PyPI Trusted Publishing.

Installation

pip install --upgrade gitlytics
# Or with the local web dashboard:
pip install --upgrade "gitlytics[dashboard]"

v0.7.2

Choose a tag to compare

@ameyachopade ameyachopade released this 13 Nov 11:00

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

v0.7.0

Choose a tag to compare

@ameyachopade ameyachopade released this 01 Nov 14:22

Gitlytics v0.7.0 delivers a major upgrade to the public username lookup engine, fixes route handling in the FastAPI dashboard server, refreshes all backend dependencies to their latest stable releases, and enhances Windows terminal compatibility.


🚀 Highlights & What's New

  • Seamless Public Username Resolution:

    • Added native GET /api/username/{username} endpoint alongside existing POST /api/username in FastAPI to support both standard URL patterns and JSON payloads.
    • Enhanced error handling: specific error messages from the backend (such as invalid usernames or GitHub rate limits) are now surfaced clearly instead of generic 404 warnings.
  • Fresh Dashboard Build Embedded:

    • Embedded the latest optimized local dashboard bundle inside gitlytics/static.
    • Removed deprecated bundle chunks and improved asset caching.
  • Windows Console & Terminal UTF-8 Hardening:

    • Hardened Windows command-line output streams with UTF-8 encoding reconfig to prevent UnicodeEncodeError across Windows PowerShell and Command Prompt.
  • Full Verification Suite:

    • 183/183 unit tests passing across all modules (pytest).
    • 57/57 function checks passing in the verification suite (run_all_functions_check.py).

📦 Dependency & Infrastructure Updates

  • GitHub Workflows:
    • Updated publish.yml to use actions/checkout@v7, actions/setup-python@v7, and pinned pypa/gh-action-pypi-publish@v1.14.3 for Trusted Publishing.
  • Python Backend:
    • Pinned gitlytics==0.7.0 in pyproject.toml, requirements.txt, and src/gitlytics/__init__.py.
    • Updated dependencies to modern versions: pandas>=2.2.3, requests>=2.34.2, croniter>=6.2.4, certifi>=2026.10.23.

🛠️ Installation & Upgrade

Upgrade to v0.7.0 via PyPI:

pip install --upgrade gitlytics

Launch the local dashboard:

gitlytics dashboard

v0.6.3

Choose a tag to compare

@ameyachopade ameyachopade released this 25 Jul 09:53

Bug Fix

v0.6.2

Choose a tag to compare

@ameyachopade ameyachopade released this 25 Jul 09:34

Bug Fix

v0.6.1

Choose a tag to compare

@ameyachopade ameyachopade released this 25 Jul 09:22

Bug Fixes

v0.6.0

Choose a tag to compare

@ameyachopade ameyachopade released this 14 Jul 10:35

Bug fix and New features and UI.

v0.5.1

Choose a tag to compare

@ameyachopade ameyachopade released this 07 Jul 10:46

📢 Important Note on Star History Deprecation

  • Stargazers Endpoint Restrictions: Due to recent GitHub API policy adjustments restricting stargazer detailed lists to repository owners and collaborators, the fetch_star_history function and local server endpoints have been updated.
  • Graceful Restriction Handling: Attempting to query star history for repositories you do not own or collaborate on will now raise a clean, specific StargazersRestrictedError (returning a 403 Forbidden response in the web API and displaying a descriptive restriction message in the CLI) instead of raising generic/internal server errors.

🛠️ Improvements & Bug Fixes

  • Layout Enhancements: Adjusted dashboard grid spacing for the customizer panels, layout columns, and metrics grid to prevent overlapping labels or text clipping.
  • Security & Cleanups: Improved internal error mapping on REST API routes and cleaned up CLI subcommand arguments.

v0.5.0

Choose a tag to compare

@ameyachopade ameyachopade released this 04 Jul 10:49

v0.5.0 — GitHub API Restriction Fix & Direct Exports

Key Highlights

  • GitHub API Restriction Fix: Gracefully handles GitHub's June 30, 2026 /stargazers restriction with specific error classes, access restrictions, and descriptive fallback SVGs.
  • Interactive Multi-Repo Star Chart: Upgrades Star History in Token/Cloud modes to a cumulative line chart showing multiple repositories in distinct colors with toggle checkbox pills.
  • Direct Downloads with Loading State: Adds quick PNG/SVG export buttons to charts (hidden for badges) that display a spinner animation and text feedback during compilation.

v0.4.8

Choose a tag to compare

@ameyachopade ameyachopade released this 04 Jul 07:44

Star generator bug fix