github-streak 0.1.0__py3-none-any.whl

ghstreak/streak.py

@@ -0,0 +1,111 @@
+from datetime import date, timedelta
+import os
+import requests
+from dotenv import load_dotenv
+
+# Load environment variables from .env file
+load_dotenv()
+
+def get_contributions(username, days=365):
+    # GitHub GraphQL API to get contribution calendar
+    token = os.getenv('GITHUB_TOKEN')
+
+    if not token:
+        print("Warning: No GITHUB_TOKEN found. API rate limits will be very restrictive.")
+        print("To fix this, set your token: export GITHUB_TOKEN=your_token_here")
+        print("You can create a token at: https://github.com/settings/tokens")
+        print()
+
+    from_date = (date.today() - timedelta(days=days)).isoformat() + "T00:00:00Z"
+    to_date = date.today().isoformat() + "T23:59:59Z"
+
+    query = f"""
+    query {{
+      user(login: "{username}") {{
+        contributionsCollection(from: "{from_date}", to: "{to_date}") {{
+          contributionCalendar {{
+            weeks {{
+              contributionDays {{
+                date
+                contributionCount
+              }}
+            }}
+          }}
+        }}
+      }}
+    }}
+    """
+
+    headers = {
+        "Authorization": f"Bearer {token}",
+        "Content-Type": "application/json"
+    } if token else {"Content-Type": "application/json"}
+
+    try:
+        response = requests.post(
+            "https://api.github.com/graphql",
+            json={"query": query},
+            headers=headers
+        )
+        response.raise_for_status()
+        result = response.json()
+
+        if 'errors' in result:
+            raise Exception(f"GraphQL Error: {result['errors']}")
+
+        days_data = []
+        for week in result['data']['user']['contributionsCollection']['contributionCalendar']['weeks']:
+            for day in week['contributionDays']:
+                days_data.append({
+                    "date": day["date"],
+                    "count": day["contributionCount"]
+                })
+        return sorted(days_data, key=lambda x: x["date"], reverse=True)
+
+    except requests.exceptions.HTTPError as e:
+        if e.response.status_code == 403:
+            raise Exception("GitHub API rate limit exceeded. Please set GITHUB_TOKEN environment variable.")
+        raise
+
+def analyze_streaks(days_data):
+    current_streak = 0
+    previous_streak = 0
+    gap_found = False
+    last_active_day = None
+
+    for i, day in enumerate(days_data):
+        if day['count'] > 0:
+            if not gap_found:
+                current_streak += 1
+            else:
+                previous_streak += 1
+        else:
+            if not gap_found:
+                gap_found = True
+                last_active_day = days_data[i-1]["date"] if i > 0 else None
+            elif previous_streak > 0:
+                break
+
+    return {
+        "current_streak": current_streak,
+        "previous_streak": previous_streak,
+        "last_active_day": last_active_day
+    }
+
+def main():
+    import sys
+    if len(sys.argv) != 2:
+        print("Usage: ghstreak <github_username>")
+        sys.exit(1)
+
+    username = sys.argv[1]
+    data = get_contributions(username)
+    result = analyze_streaks(data)
+    print(f"Current streak: {result['current_streak']} days")
+    if result['previous_streak'] > 0:
+        print(f"Previous streak: {result['previous_streak']} days, ended on {result['last_active_day']}")
+    else:
+        print("No previous streak found")
+
+if __name__ == "__main__":
+    main()

github_streak-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: github-streak
+Version: 0.1.0
+Summary: CLI tool to track your GitHub contribution streaks
+Author: Deven Mistry
+Project-URL: Homepage, https://github.com/deven367/github-streak
+Project-URL: Repository, https://github.com/deven367/github-streak
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=0.19.0
+
+# ghstreak
+
+A simple CLI tool to track your GitHub contribution streaks.
+
+## Installation
+
+```bash
+pip install ghstreak
+```
+
+## Usage
+
+```bash
+ghstreak <github_username>
+```
+
+Example:
+
+```bash
+ghstreak deven367
+```
+
+## Authentication
+
+For higher API rate limits, set your GitHub token as an environment variable:
+
+```bash
+export GITHUB_TOKEN=your_token_here
+```
+
+You can create a personal access token at: <https://github.com/settings/tokens>
+
+## Output
+
+The tool displays:
+
+- Your current contribution streak (consecutive days with contributions)
+- Your previous streak (if applicable) and when it ended
+
+## Requirements
+
+- Python >= 3.7
+- requests >= 2.25.0
+- python-dotenv >= 0.19.0

github_streak-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+ghstreak/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ghstreak/streak.py,sha256=gEDgyxN4qJQVjlW42-NJezwhCnGEnW1_Kds75QrurQM,3384
+github_streak-0.1.0.dist-info/METADATA,sha256=-d-G9LB9S2DcROEq8y-9luAAl_8uFj1kBguIuEel_VY,1487
+github_streak-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+github_streak-0.1.0.dist-info/entry_points.txt,sha256=prQ9oElrS68913jpoKqz1OAj0tlIkYvFWQIcOWomjh0,50
+github_streak-0.1.0.dist-info/top_level.txt,sha256=cpbUjQE2f5SeZpD6kgfQC7Z0GMxubFNDjeUIMLTbClY,9
+github_streak-0.1.0.dist-info/RECORD,,

github_streak-0.1.0.dist-info/WHEEL

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

github_streak-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ghstreak = ghstreak.streak:main

github_streak-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ghstreak