greenmining 0.1.11__py3-none-any.whl → 1.0.1__py3-none-any.whl

greenmining-1.0.1.dist-info/RECORD

@@ -0,0 +1,36 @@
+greenmining/__init__.py,sha256=c_Vaq_WW6-SkI_es4cQKXpdEtXdfVEnGjIDxACF6bzk,1764
+greenmining/__main__.py,sha256=1RwcSXcwdza6xJX5fRT8-HhZjlnKbkmGY_uxTm-NYZ4,138
+greenmining/__version__.py,sha256=1jisBTMaMLSYH7jCobgcRNneQXzskU1YHLC5Za-5YsQ,66
+greenmining/cli.py,sha256=40eKDEZHNeDVb91xKBG70VfPk45mwb4YjuVCC2efVPA,17458
+greenmining/config.py,sha256=1_puT52zNS589hTxEZ3UCqRC_Qw5Jw2UupUPNbNz_hs,5195
+greenmining/gsf_patterns.py,sha256=Prsk_stnQrfOsk0x0zn-zdevbueAnPfGDM4XNA9PbdA,54664
+greenmining/main.py,sha256=h8J9OcwyGpVJ-gjSFUS2SZExQQlHV0eDMMjAoI_sgAo,952
+greenmining/utils.py,sha256=-pL8yznf1jSazBMk1ugjPQbtFOQI1E9wRI1NJbHl2xs,7941
+greenmining/analyzers/__init__.py,sha256=6emAyka8ifjNjEpqhWOGkWkTJU1SgJy8Xuva-b9XSNY,518
+greenmining/analyzers/code_diff_analyzer.py,sha256=mL8sCpnVo_m8vsgabe2t3gF0b_gNp3MIM-D4v31-zNQ,7682
+greenmining/analyzers/ml_feature_extractor.py,sha256=rbCPA12hD1Xda7CGkLA7vGZgDjZK0r4ev5crDcbg3Jc,17727
+greenmining/analyzers/nlp_analyzer.py,sha256=fBwkHqV0e4rnI-dz2DH2zmrnLZYpcRTkMrAY-zmMBTo,12616
+greenmining/analyzers/qualitative_analyzer.py,sha256=6HU_Rn-mAOBXiwroj7UjV13nmagSboz5rB4eYuiYs6U,17256
+greenmining/analyzers/statistical_analyzer.py,sha256=g_suZ6AAJzTft2kZH5dwSUZ8S06JyuaBy4MPSZidavY,8755
+greenmining/analyzers/temporal_analyzer.py,sha256=-1fmZdkGsNqmukoy8xxEG1v4AdJ5P6Y1C1Q8e-aI1cs,15976
+greenmining/controllers/__init__.py,sha256=y-W1Xnnhm4JnrY2QEo5osK8jQs7hpxXovVbHlE334F0,279
+greenmining/controllers/repository_controller.py,sha256=_DtX0OAm5VUEOPY8SxrvVWNujjQmkoyt-2PpL-R2sQ0,6453
+greenmining/models/__init__.py,sha256=K8udzQW2V5LqPowIm5aCiK07LxJZxCt_oW3gz5Qi-mc,397
+greenmining/models/aggregated_stats.py,sha256=eYyEcKfL8oqqE_hN0tzM7eyXFzc54by20N3-72vcJ7Y,1032
+greenmining/models/analysis_result.py,sha256=-6hwmickqncRXDGWM3aXBEaOGlddM5G6hnmRTyHFcMs,1525
+greenmining/models/commit.py,sha256=OT95QqVzU-0xbXB5l7m7V6J4FXSPIO80M2zYJHJdyOU,2459
+greenmining/models/repository.py,sha256=k1X9UYZYLl0RznohOHx_Y5wur-ZBvLcNyc9vPVArb7E,2876
+greenmining/presenters/__init__.py,sha256=-ukAvhNuTvy1Xpknps0faDZ78HKdPHPySzFpQHABzKM,203
+greenmining/presenters/console_presenter.py,sha256=ykJ9Hgors2dRTqQNaqCTxH4fd49F0AslQTgUOr_csI0,5347
+greenmining/services/__init__.py,sha256=7CJDjHMTrY0bBoqzx22AUzIwEvby0FbAUUKYbjSlNPQ,460
+greenmining/services/commit_extractor.py,sha256=ldwfb6pNMPqaAXEYMIGYyo5yFx-tYcLlAiMpJdKc8Ek,12738
+greenmining/services/data_aggregator.py,sha256=WRYmVoscX0kMyI0CRnYFPhYwOBVI73o573LhibZTcPA,23770
+greenmining/services/data_analyzer.py,sha256=HZDQLFZDCwCUGIzRjypyXC09Fl_-zaxhly74n3siwQc,16325
+greenmining/services/github_fetcher.py,sha256=J47-plM_NKXwHDSWNBuSUZMnZnGP6wXiJyrVfeWT9ug,11360
+greenmining/services/reports.py,sha256=NCNI9SCTnSLeAO8WmkNIdkB0hr-XyVpuzV0sovOoUOM,27107
+greenmining-1.0.1.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
+greenmining-1.0.1.dist-info/METADATA,sha256=BxsHBbcm6_287X-8Cq2Phi-twkwXN7E8OrDDdYemhUw,25694
+greenmining-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+greenmining-1.0.1.dist-info/entry_points.txt,sha256=oHvTWMzNFGf2W3CFEKVVPsG4exeMv0MaQu9YsUoQ9lw,53
+greenmining-1.0.1.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
+greenmining-1.0.1.dist-info/RECORD,,

greenmining-0.1.11.dist-info/METADATA

@@ -1,335 +0,0 @@
-Metadata-Version: 2.4
-Name: greenmining
-Version: 0.1.11
-Summary: Analyze GitHub repositories to identify green software engineering patterns and energy-efficient practices
-Author-email: Your Name <your.email@example.com>
-Maintainer-email: Your Name <your.email@example.com>
-License: MIT
-Project-URL: Homepage, https://github.com/yourusername/greenmining
-Project-URL: Documentation, https://github.com/yourusername/greenmining#readme
-Project-URL: Repository, https://github.com/yourusername/greenmining
-Project-URL: Issues, https://github.com/yourusername/greenmining/issues
-Project-URL: Changelog, https://github.com/yourusername/greenmining/blob/main/CHANGELOG.md
-Keywords: green-software,gsf,sustainability,carbon-footprint,microservices,mining,repository-analysis,energy-efficiency,github-analysis
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-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: Programming Language :: Python :: 3.13
-Classifier: Operating System :: OS Independent
-Classifier: Environment :: Console
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: PyGithub>=2.1.1
-Requires-Dist: PyDriller>=2.5
-Requires-Dist: pandas>=2.2.0
-Requires-Dist: click>=8.1.7
-Requires-Dist: colorama>=0.4.6
-Requires-Dist: tabulate>=0.9.0
-Requires-Dist: tqdm>=4.66.0
-Requires-Dist: matplotlib>=3.8.0
-Requires-Dist: plotly>=5.18.0
-Requires-Dist: python-dotenv>=1.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
-Requires-Dist: black>=23.12.0; extra == "dev"
-Requires-Dist: ruff>=0.1.9; extra == "dev"
-Requires-Dist: mypy>=1.8.0; extra == "dev"
-Requires-Dist: build>=1.0.3; extra == "dev"
-Requires-Dist: twine>=4.0.2; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: sphinx>=7.2.0; extra == "docs"
-Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
-Requires-Dist: myst-parser>=2.0.0; extra == "docs"
-Dynamic: license-file
-
-# greenmining
-
-Green mining for microservices repositories.
-
-[![PyPI](https://img.shields.io/pypi/v/greenmining)](https://pypi.org/project/greenmining/)
-[![Python](https://img.shields.io/pypi/pyversions/greenmining)](https://pypi.org/project/greenmining/)
-[![License](https://img.shields.io/github/license/adam-bouafia/greenmining)](LICENSE)
-
-## Overview
-
-`greenmining` is a Python library and CLI tool for analyzing GitHub repositories to identify green software engineering practices and energy-efficient patterns. It detects 76 sustainable software patterns across cloud, web, AI, database, networking, and general categories.
-
-## Features
-
-- 🔍 **76 Sustainability Patterns**: Detect energy-efficient and environmentally conscious coding practices
-- 📊 **Repository Mining**: Analyze 100+ microservices repositories from GitHub
-- 📈 **Green Awareness Detection**: Identify sustainability-focused commits
-- 📄 **Comprehensive Reports**: Generate analysis reports in multiple formats
-- 🐳 **Docker Support**: Run in containers for consistent environments
-- ⚡ **Fast Analysis**: Parallel processing and checkpoint system
-
-## Installation
-
-### Via pip
-
-```bash
-pip install greenmining
-```
-
-### From source
-
-```bash
-git clone https://github.com/adam-bouafia/greenmining.git
-cd greenmining
-pip install -e .
-```
-
-### With Docker
-
-```bash
-docker pull adambouafia/greenmining:latest
-```
-
-## Quick Start
-
-### CLI Usage
-
-```bash
-# Set your GitHub token
-export GITHUB_TOKEN="your_github_token"
-
-# Run full analysis pipeline
-greenmining pipeline --max-repos 100
-
-# Fetch repositories
-greenmining fetch --max-repos 100 --min-stars 100
-
-# Extract commits
-greenmining extract --max-commits 50
-
-# Analyze for green patterns
-greenmining analyze
-
-# Generate report
-greenmining report
-```
-
-### Python API
-
-#### Basic Pattern Detection
-
-```python
-from greenmining import GSF_PATTERNS, is_green_aware, get_pattern_by_keywords
-
-# Check available patterns
-print(f"Total patterns: {len(GSF_PATTERNS)}")  # 76
-
-# Detect green awareness in commit messages
-commit_msg = "Optimize Redis caching to reduce energy consumption"
-if is_green_aware(commit_msg):
-    patterns = get_pattern_by_keywords(commit_msg)
-    print(f"Matched patterns: {patterns}")
-    # Output: ['Cache Static Data', 'Use Efficient Cache Strategies']
-```
-
-#### Analyze Repository Commits
-
-```python
-from greenmining.services.github_fetcher import GitHubFetcher
-from greenmining.services.commit_extractor import CommitExtractor
-from greenmining.services.data_analyzer import DataAnalyzer
-from greenmining.config import Config
-
-# Initialize services
-config = Config()
-fetcher = GitHubFetcher(config)
-extractor = CommitExtractor(config)
-analyzer = DataAnalyzer(config)
-
-# Fetch repositories
-repos = fetcher.fetch_repositories(max_repos=10, min_stars=100)
-
-# Extract commits from first repo
-commits = extractor.extract_commits(repos[0], max_commits=50)
-
-# Analyze commits for green patterns
-results = []
-for commit in commits:
-    result = analyzer.analyze_commit(commit)
-    if result['green_aware']:
-        results.append(result)
-        print(f"Green commit found: {commit.message[:50]}...")
-        print(f"  Patterns: {result['known_pattern']}")
-```
-
-#### Access Sustainability Patterns Data
-
-```python
-from greenmining import GSF_PATTERNS
-
-# Get all cloud patterns
-cloud_patterns = {
-    pid: pattern for pid, pattern in GSF_PATTERNS.items()
-    if pattern['category'] == 'cloud'
-}
-print(f"Cloud patterns: {len(cloud_patterns)}")
-
-# Get pattern details
-cache_pattern = GSF_PATTERNS['gsf_001']
-print(f"Pattern: {cache_pattern['name']}")
-print(f"Category: {cache_pattern['category']}")
-print(f"Keywords: {cache_pattern['keywords']}")
-print(f"Impact: {cache_pattern['sci_impact']}")
-```
-
-#### Generate Custom Reports
-
-```python
-from greenmining.services.data_aggregator import DataAggregator
-from greenmining.config import Config
-
-config = Config()
-aggregator = DataAggregator(config)
-
-# Load analysis results
-results = aggregator.load_analysis_results()
-
-# Generate statistics
-stats = aggregator.calculate_statistics(results)
-print(f"Total commits analyzed: {stats['total_commits']}")
-print(f"Green-aware commits: {stats['green_aware_count']}")
-print(f"Top patterns: {stats['top_patterns'][:5]}")
-
-# Export to CSV
-aggregator.export_to_csv(results, "output.csv")
-```
-
-#### Batch Analysis
-
-```python
-from greenmining.controllers.repository_controller import RepositoryController
-from greenmining.config import Config
-
-config = Config()
-controller = RepositoryController(config)
-
-# Run full pipeline programmatically
-controller.fetch_repositories(max_repos=50)
-controller.extract_commits(max_commits=100)
-controller.analyze_commits()
-controller.aggregate_results()
-controller.generate_report()
-
-print("Analysis complete! Check data/ directory for results.")
-```
-
-### Docker Usage
-
-```bash
-# Run analysis pipeline
-docker run -v $(pwd)/data:/app/data \
-           adambouafia/greenmining:latest --help
-
-# With custom configuration
-docker run -v $(pwd)/.env:/app/.env:ro \
-           -v $(pwd)/data:/app/data \
-           adambouafia/greenmining:latest pipeline --max-repos 50
-
-# Interactive shell
-docker run -it adambouafia/greenmining:latest /bin/bash
-```
-
-## Configuration
-
-Create a `.env` file or set environment variables:
-
-```bash
-GITHUB_TOKEN=your_github_personal_access_token
-MAX_REPOS=100
-COMMITS_PER_REPO=50
-OUTPUT_DIR=./data
-```
-
-## GSF Pattern Categories
-
-- **Cloud** (40 patterns): Autoscaling, serverless, right-sizing, region selection
-- **Web** (15 patterns): CDN, caching, lazy loading, compression
-- **AI/ML** (8 patterns): Model optimization, pruning, quantization
-- **Database** (6 patterns): Indexing, query optimization, connection pooling
-- **Networking** (4 patterns): Protocol optimization, connection reuse
-- **General** (3 patterns): Code efficiency, resource management
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `fetch` | Fetch microservices repositories from GitHub |
-| `extract` | Extract commit history from repositories |
-| `analyze` | Analyze commits for green patterns |
-| `aggregate` | Aggregate analysis results |
-| `report` | Generate comprehensive report |
-| `pipeline` | Run complete analysis pipeline |
-| `status` | Show current analysis status |
-
-## Output Files
-
-All outputs are saved to the `data/` directory:
-
-- `repositories.json` - Repository metadata
-- `commits.json` - Extracted commit data
-- `analysis_results.json` - Pattern analysis results
-- `aggregated_statistics.json` - Summary statistics
-- `green_analysis_results.csv` - CSV export for spreadsheets
-- `green_microservices_analysis.md` - Final report
-
-## Development
-
-```bash
-# Clone repository
-git clone https://github.com/adam-bouafia/greenmining.git
-cd greenmining
-
-# Install development dependencies
-pip install -e ".[dev]"
-
-# Run tests
-pytest tests/
-
-# Run with coverage
-pytest --cov=greenmining tests/
-
-# Format code
-black greenmining/ tests/
-ruff check greenmining/ tests/
-```
-
-## Requirements
-
-- Python 3.9+
-- PyGithub >= 2.1.1
-- PyDriller >= 2.5
-- pandas >= 2.2.0
-- click >= 8.1.7
-
-## License
-
-MIT License - See [LICENSE](LICENSE) for details.
-
-## Contributing
-
-Contributions are welcome! Please open an issue or submit a pull request.
-
-## Links
-
-- **GitHub**: https://github.com/adam-bouafia/greenmining
-- **PyPI**: https://pypi.org/project/greenmining/
-- **Docker Hub**: https://hub.docker.com/r/adambouafia/greenmining
-- **Documentation**: https://github.com/adam-bouafia/greenmining#readme
-
-

greenmining-0.1.11.dist-info/RECORD

@@ -1,29 +0,0 @@
-greenmining/__init__.py,sha256=5AzBFG0un1yE0v8mKexO8yYnt3DmYwP-gou6rW4ephA,396
-greenmining/__main__.py,sha256=1RwcSXcwdza6xJX5fRT8-HhZjlnKbkmGY_uxTm-NYZ4,138
-greenmining/__version__.py,sha256=Hry6u6QztktMYf7nqf0jPXFaA0b7lmr6pjdAaVRXDaE,66
-greenmining/cli.py,sha256=11DEE9bwKDIzj8CbR4-B8re_1cmywPo1CyLGWVGzF9U,13254
-greenmining/config.py,sha256=jTWEIHIwRiQmdoGV5iCILT_nPTka6ZX1DL5ltTIzWJ0,4004
-greenmining/gsf_patterns.py,sha256=aSyj6XNgfxJlqFAI8I5xd47PQlU9DHFlDkrBFwRt6pM,54516
-greenmining/main.py,sha256=h8J9OcwyGpVJ-gjSFUS2SZExQQlHV0eDMMjAoI_sgAo,952
-greenmining/utils.py,sha256=-pL8yznf1jSazBMk1ugjPQbtFOQI1E9wRI1NJbHl2xs,7941
-greenmining/controllers/__init__.py,sha256=y-W1Xnnhm4JnrY2QEo5osK8jQs7hpxXovVbHlE334F0,279
-greenmining/controllers/repository_controller.py,sha256=q2JO5LtmpWRbNzVrE9lFBhHU0kcDSlkG3TVIB6mYqGY,4278
-greenmining/models/__init__.py,sha256=K8udzQW2V5LqPowIm5aCiK07LxJZxCt_oW3gz5Qi-mc,397
-greenmining/models/aggregated_stats.py,sha256=SysZD7ZeyvOG4Qsq9B_JdMjI5NpKCNKC63sJ6-s2k2M,984
-greenmining/models/analysis_result.py,sha256=-6hwmickqncRXDGWM3aXBEaOGlddM5G6hnmRTyHFcMs,1525
-greenmining/models/commit.py,sha256=9-PbZmHSyorD1ed13rFkrT9u5XOG7SBT5Nowlr82-PE,2399
-greenmining/models/repository.py,sha256=lpe9Pte6KPCcRvx0aOH16v2PiH3NwjPeQRJYxriKnns,2834
-greenmining/presenters/__init__.py,sha256=-ukAvhNuTvy1Xpknps0faDZ78HKdPHPySzFpQHABzKM,203
-greenmining/presenters/console_presenter.py,sha256=jK_8agdEz-_2mqoyMNht-mNA9hXWe9EA8VlAUT_XFxA,5299
-greenmining/services/__init__.py,sha256=7CJDjHMTrY0bBoqzx22AUzIwEvby0FbAUUKYbjSlNPQ,460
-greenmining/services/commit_extractor.py,sha256=XB7Y1HKeQ4OpgEz0yAjKDPdiQcq07QCQ5Xrx9AxGfrM,11814
-greenmining/services/data_aggregator.py,sha256=m3O9Gp1kxR6vZ6kWTBMxfZqhLVSP5K76tXg30fDf6nc,16865
-greenmining/services/data_analyzer.py,sha256=MOQ-soPZRqiuEONB_-9QmWA-2akx1H7T2IFRp3GIizg,12035
-greenmining/services/github_fetcher.py,sha256=9aHSbZoA8BWL1Cp0cCv2NltXf0Jr7W_mO5d_-7TuOvY,9294
-greenmining/services/reports.py,sha256=cE7XvB2ihD5KwrO4W1Uj_I1h5pELBPF85MjgGFzkgOQ,21829
-greenmining-0.1.11.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
-greenmining-0.1.11.dist-info/METADATA,sha256=pDqi4Vpx7sqaXeVHlp6YZcKmJphblD2SvqhgTtAeLp4,9970
-greenmining-0.1.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-greenmining-0.1.11.dist-info/entry_points.txt,sha256=oHvTWMzNFGf2W3CFEKVVPsG4exeMv0MaQu9YsUoQ9lw,53
-greenmining-0.1.11.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
-greenmining-0.1.11.dist-info/RECORD,,