Repository navigation
Releases
Releases · ameyachopade/gitlytics
v0.8.0
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, andgitlytics.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 updatedREADME.mdandSECURITY.md.
Security & Reliability Hardening
- Dashboard Bind & Token Safety:
gitlytics dashboardnow requires--public-bindfor all non-loopback hosts (0.0.0.0,::, LAN IPs) while preserving explicit--hostvalues when--public-bindis set.gitlytics dashboardno longer silently promotes ambientGITHUB_TOKENfrom the shell environment into the local web server.
- Principal & Privacy Isolation:
- Scoped
GITLYTICS_DATA_DIRCSV archives inPOST /api/trafficto the authenticated token owner and surfacedTokenExpiredErroras HTTP401. - Added
is:publicfiltering to public repository search lookups (GET/POST /api/username) and dropped all historical rows of private repositories whenexport_public_only=True.
- Scoped
- API & Upload Protections:
- Enforced
GITLYTICS_UPLOAD_KEYchecks beforeOrigin/Refererverification onPOST /api/upload-csv. - Added trusted
Hostallowlist checks (127.0.0.1,localhost,::1, orGITLYTICS_ALLOWED_HOSTS), unconditionalapplication/jsonvalidation on browserPOSTroutes, and blocked/_headersand 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).
- Enforced
- Core Client & Validation:
- Validated
owner/repoidentifiers before URL interpolation inget_deep_repo_stats()andget_repo_traffic(). - Replaced the global operation deadline with a
ContextVarso concurrent threads cannot poison retry budgets.
- Validated
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-auditchecks (lint-security.yml), and Dependabot (dependabot.yml). - Hardened OIDC PyPI Publishing: Isolated
publish.ymlso 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
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 insrc/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 tostderr. 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-Clausespecification inpyproject.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:8000Synchronize Indefinite Traffic Backups:
gitlytics sync --token "ghp_your_token" --data-dir "./data"Useful Links
- PyPI Package: https://pypi.org/project/gitlytics/
- Documentation: https://docs.gitlytics.dev
- Cloud Studio: https://dashboard.gitlytics.dev
- Full Changelog: v0.7.0...v0.7.2
v0.7.0
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 existingPOST /api/usernamein 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.
- Added native
-
Fresh Dashboard Build Embedded:
- Embedded the latest optimized local dashboard bundle inside
gitlytics/static. - Removed deprecated bundle chunks and improved asset caching.
- Embedded the latest optimized local dashboard bundle inside
-
Windows Console & Terminal UTF-8 Hardening:
- Hardened Windows command-line output streams with UTF-8 encoding reconfig to prevent
UnicodeEncodeErroracross Windows PowerShell and Command Prompt.
- Hardened Windows command-line output streams with UTF-8 encoding reconfig to prevent
-
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).
- 183/183 unit tests passing across all modules (
📦 Dependency & Infrastructure Updates
- GitHub Workflows:
- Updated
publish.ymlto useactions/checkout@v7,actions/setup-python@v7, and pinnedpypa/gh-action-pypi-publish@v1.14.3for Trusted Publishing.
- Updated
- Python Backend:
- Pinned
gitlytics==0.7.0inpyproject.toml,requirements.txt, andsrc/gitlytics/__init__.py. - Updated dependencies to modern versions:
pandas>=2.2.3,requests>=2.34.2,croniter>=6.2.4,certifi>=2026.10.23.
- Pinned
🛠️ Installation & Upgrade
Upgrade to v0.7.0 via PyPI:
pip install --upgrade gitlyticsLaunch the local dashboard:
gitlytics dashboardv0.6.3
v0.6.2
v0.6.1
v0.6.0
v0.5.1
📢 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_historyfunction 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 a403 Forbiddenresponse 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
v0.5.0 — GitHub API Restriction Fix & Direct Exports
Key Highlights
- GitHub API Restriction Fix: Gracefully handles GitHub's June 30, 2026
/stargazersrestriction 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.