gitflow-analytics 1.0.0__py3-none-any.whl

gitflow_analytics-1.0.0.dist-info/METADATA

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: gitflow-analytics
+Version: 1.0.0
+Summary: Analyze Git repositories for developer productivity insights
+Author-email: Bob Matyas <bobmatnyc@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bobmatnyc/gitflow-analytics
+Project-URL: Documentation, https://github.com/bobmatnyc/gitflow-analytics/blob/main/README.md
+Project-URL: Repository, https://github.com/bobmatnyc/gitflow-analytics
+Project-URL: Issues, https://github.com/bobmatnyc/gitflow-analytics/issues
+Keywords: git,analytics,productivity,metrics,development
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: gitpython>=3.1
+Requires-Dist: tqdm>=4.65
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: pandas>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dateutil>=2.8
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Provides-Extra: github
+Requires-Dist: pygithub>=1.58; extra == "github"
+Provides-Extra: all
+Requires-Dist: gitflow-analytics[github]; extra == "all"
+Dynamic: license-file
+
+# GitFlow Analytics
+
+A Python package for analyzing Git repositories to generate comprehensive developer productivity reports. It extracts data directly from Git history and GitHub APIs, providing weekly summaries, productivity insights, and gap analysis.
+
+## Features
+
+- 🚀 **Multi-repository analysis** with project grouping
+- 👥 **Developer identity resolution** and normalization
+- 📊 **Work volume analysis** (absolute vs relative effort)
+- 🎯 **Story point extraction** from commit messages and PR descriptions
+- 🎫 **Multi-platform ticket tracking** (JIRA, GitHub Issues, ClickUp, Linear)
+- 📈 **Weekly CSV reports** with productivity metrics
+- 🔒 **Data anonymization** for external sharing
+- ⚡ **Smart caching** for fast repeated analyses
+- 🔄 **Batch processing** for large repositories
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install gitflow-analytics
+```
+
+### Basic Usage
+
+1. Create a configuration file (`config.yaml`):
+
+```yaml
+version: "1.0"
+
+github:
+  token: "${GITHUB_TOKEN}"
+  owner: "${GITHUB_OWNER}"
+
+repositories:
+  - name: "frontend"
+    path: "~/repos/frontend"
+    github_repo: "myorg/frontend"
+    project_key: "FRONTEND"
+    
+  - name: "backend"
+    path: "~/repos/backend"
+    github_repo: "myorg/backend"
+    project_key: "BACKEND"
+
+analysis:
+  story_point_patterns:
+    - "(?:story\\s*points?|sp|pts?)\\s*[:=]\\s*(\\d+)"
+    - "\\[(\\d+)\\s*(?:sp|pts?)\\]"
+```
+
+2. Set environment variables:
+
+```bash
+export GITHUB_TOKEN=your_github_token
+export GITHUB_OWNER=your_github_org
+```
+
+3. Run the analysis:
+
+```bash
+gitflow-analytics analyze -c config.yaml
+```
+
+## Command Line Interface
+
+### Main Commands
+
+```bash
+# Analyze repositories
+gitflow-analytics analyze -c config.yaml --weeks 12 --output ./reports
+
+# Show cache statistics
+gitflow-analytics cache-stats -c config.yaml
+
+# List known developers
+gitflow-analytics list-developers -c config.yaml
+
+# Merge developer identities
+gitflow-analytics merge-identity -c config.yaml dev1_id dev2_id
+```
+
+### Options
+
+- `--weeks, -w`: Number of weeks to analyze (default: 12)
+- `--output, -o`: Output directory for reports (default: ./reports)
+- `--anonymize`: Anonymize developer information
+- `--no-cache`: Disable caching for fresh analysis
+- `--clear-cache`: Clear cache before analysis
+- `--validate-only`: Validate configuration without running
+
+## Output Reports
+
+The tool generates three CSV reports:
+
+1. **Weekly Metrics** (`weekly_metrics_YYYYMMDD.csv`)
+   - Week-by-week developer productivity
+   - Story points, commits, lines changed
+   - Ticket coverage percentages
+   - Per-project breakdown
+
+2. **Summary Statistics** (`summary_YYYYMMDD.csv`)
+   - Overall project statistics
+   - Platform-specific ticket counts
+   - Top contributors
+
+3. **Developer Report** (`developers_YYYYMMDD.csv`)
+   - Complete developer profiles
+   - Total contributions
+   - Identity aliases
+
+## Story Point Patterns
+
+Configure custom regex patterns to match your team's story point format:
+
+```yaml
+story_point_patterns:
+  - "SP: (\\d+)"           # SP: 5
+  - "\\[([0-9]+) pts\\]"   # [3 pts]
+  - "estimate: (\\d+)"     # estimate: 8
+```
+
+## Ticket Platform Support
+
+Automatically detects and tracks tickets from:
+- **JIRA**: `PROJ-123`
+- **GitHub**: `#123`, `GH-123`
+- **ClickUp**: `CU-abc123`
+- **Linear**: `ENG-123`
+
+## Caching
+
+The tool uses SQLite for intelligent caching:
+- Commit analysis results
+- Developer identity mappings
+- Pull request data
+
+Cache is automatically managed with configurable TTL.
+
+## Developer Identity Resolution
+
+Intelligently merges developer identities across:
+- Different email addresses
+- Name variations
+- GitHub usernames
+
+Manual overrides supported in configuration.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

gitflow_analytics-1.0.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+gitflow_analytics/__init__.py,sha256=Ur3taLHb9eO5P1T-hi2llyCkHTKhk1hLuurxcp9hLQs,639
+gitflow_analytics/_version.py,sha256=l0-c8EmumJVRuJG4Iyn8ezTW00USlPFUPNchN-DwoDs,136
+gitflow_analytics/cli.py,sha256=viyQeAWyf1bdH1iwsy1GHleaMaMhA3PkjAp0VuEF9zA,16707
+gitflow_analytics/config.py,sha256=23CBJS2qiYFbcG4JMFCRUyQ4JpK5sF3Qp4bcvyH3lkU,8421
+gitflow_analytics/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitflow_analytics/core/analyzer.py,sha256=TpzyXuUpAzVpg1WZeB7oRFodn-R69hvhcjWZoCH96wg,7765
+gitflow_analytics/core/branch_mapper.py,sha256=3wh45lu_vaCev9rmXHTMOpqLQTxsjKFXAE6_WpjhOcc,7610
+gitflow_analytics/core/cache.py,sha256=RlfsoEe98kZ4xXe28dbLS7MapMem__XN3EoBU1v4q2c,11691
+gitflow_analytics/core/identity.py,sha256=RKzTNqtFWwqwPCo09ClT65rEanBY8UjXx2rV0mdwZmM,17091
+gitflow_analytics/extractors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitflow_analytics/extractors/base.py,sha256=0I_dmKiLmH7PNXNpDH5FDtOhmkMfnjJJOj4KA-GJuSo,1208
+gitflow_analytics/extractors/story_points.py,sha256=DuMNw78pw2A_k6us9lYfMFLqwVI5Ip6JMBPsSBDFxzU,5038
+gitflow_analytics/extractors/tickets.py,sha256=ghoPhwg1LFXF_h888MBt6nyY_Ni-w4eqakl4JSpeqIE,6230
+gitflow_analytics/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitflow_analytics/integrations/github_integration.py,sha256=qgUIpvtP7hRkshxX4QXQkIEdsrPDVSTDTfwfXvWxE1s,6344
+gitflow_analytics/integrations/orchestrator.py,sha256=3Itdo59LZ65Gjrjo4Fik_yzpcRLfH0DXrSJHLu-BGQo,4331
+gitflow_analytics/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitflow_analytics/metrics/dora.py,sha256=MLpOJX4ZxiBXxxk0jkpvj67Brgj0CcRHWD-cnsTDbL4,12765
+gitflow_analytics/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitflow_analytics/models/database.py,sha256=iE-ERPMpA7HE4livaLaoCmBF_N8L9UFtUzsfOffc5CI,5548
+gitflow_analytics/reports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gitflow_analytics/reports/analytics_writer.py,sha256=yRzZwfYTANp1Glh2S02T6XBcXvTxEVOG1FZnewCs_d8,19054
+gitflow_analytics/reports/csv_writer.py,sha256=9ApngbIbGy9GfXm8EfkRcnSWGhQI-Iz-22F8ogWW3Hs,12611
+gitflow_analytics/reports/narrative_writer.py,sha256=fyQyXbaYG1Bvoec5kdB9JH2NYP4ov3w0NIpu6nORFdQ,12758
+gitflow_analytics-1.0.0.dist-info/licenses/LICENSE,sha256=xwvSwY1GYXpRpmbnFvvnbmMwpobnrdN9T821sGvjOY0,1066
+gitflow_analytics-1.0.0.dist-info/METADATA,sha256=SSoW_ptXcv0m_1ap1eNi1G54lvFnUzgQHfNpDmNfZK0,5765
+gitflow_analytics-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gitflow_analytics-1.0.0.dist-info/entry_points.txt,sha256=a3y8HnfLOvK1QVOgAkDY6VQXXm3o9ZSQRZrpiaS3hEM,65
+gitflow_analytics-1.0.0.dist-info/top_level.txt,sha256=CQyxZXjKvpSB1kgqqtuE0PCRqfRsXZJL8JrYpJKtkrk,18
+gitflow_analytics-1.0.0.dist-info/RECORD,,

gitflow_analytics-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gitflow_analytics-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gitflow-analytics = gitflow_analytics.cli:main

gitflow_analytics-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bob Matyas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gitflow_analytics-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+gitflow_analytics