github-monitor 2.1__py3-none-any.whl → 2.2.1__py3-none-any.whl

{github_monitor-2.1.dist-info → github_monitor-2.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github_monitor
-Version: 2.1
+Version: 2.2.1
 Summary: Tool implementing real-time tracking of Github users activities including profile and repositories changes
 Author-email: Michal Szymanski <misiektoja-pypi@rm-rf.ninja>
 License-Expression: GPL-3.0-or-later
@@ -39,6 +39,7 @@ OSINT tool for real-time monitoring of GitHub users' activities, including profi
    - added/removed public repositories
    - changes in user name, email, location, company, bio and blog URL
    - changes in profile visibility (public to private and vice versa)
+   - changes in user's daily contributions
    - detection when a user blocks or unblocks you
    - detection of account metadata changes (such as account update date)
 - Email notifications for different events (new GitHub events, changed followings, followers, repositories, user name, email, location, company, bio, blog URL etc.)
@@ -86,8 +87,8 @@ OSINT tool for real-time monitoring of GitHub users' activities, including profi
 
 Tested on:
 
-* **macOS**: Ventura, Sonoma, Sequoia
-* **Linux**: Raspberry Pi OS (Bullseye, Bookworm), Ubuntu 24, Rocky Linux 8.x/9.x, Kali Linux 2024/2025
+* **macOS**: Ventura, Sonoma, Sequoia, Tahoe
+* **Linux**: Raspberry Pi OS (Bullseye, Bookworm, Trixie), Ubuntu 24/25, Rocky Linux 8.x/9.x, Kali Linux 2024/2025
 * **Windows**: 10, 11
 
 It should work on other versions of macOS, Linux, Unix and Windows as well.
@@ -298,6 +299,12 @@ By default, only user-owned repos are tracked. To include forks and collaboratio
 github_monitor github_username -j -a
 ```
 
+If you want to track user's daily contributions then use the `-m` flag:
+
+```sh
+github_monitor github_username -m
+```
+
 If for any reason you do not want to monitor GitHub events for the user (e.g. new pushes, PRs, issues, forks, releases etc.), then use the `-k` flag:
 
 ```sh
@@ -379,7 +386,7 @@ To get email notifications when changes in user repositories are detected (e.g.
 - or use the `-q` flag
 
 ```sh
-github_monitor github_username -q
+github_monitor github_username -j -q
 ```
 
 To be informed whenever changes in the update date of user repositories are detected:
@@ -387,11 +394,21 @@ To be informed whenever changes in the update date of user repositories are dete
 - or use the `-u` flag
 
 ```sh
-github_monitor github_username -u
+github_monitor github_username -j -u
 ```
 
 The last two options (`-q` and `-u`) only work if tracking of repositories changes is enabled (`-j`).
 
+To be informed about user's daily contributions:
+- set `CONTRIB_NOTIFICATION` to `True`
+- or use the `-y` flag
+
+```sh
+github_monitor github_username -m -y
+```
+
+The `-y` only works if tracking of daily contributions is enabled (`-m`).
+
 To disable sending an email on errors (enabled by default):
 - set `ERROR_NOTIFICATION` to `False`
 - or use the `-e` flag

github_monitor-2.2.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+github_monitor.py,sha256=y-KCw1m1Z_ck3dy81Wu0WGtmJY5wJXRtOKJhaVFp-rI,138012
+github_monitor-2.2.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+github_monitor-2.2.1.dist-info/METADATA,sha256=TBFgooDz_els2Fgm4wMNoP1dcNMirFtq61DnbGAi6ls,17461
+github_monitor-2.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+github_monitor-2.2.1.dist-info/entry_points.txt,sha256=hV03y00u1L16S5BwBSLQvFsZcL2WGRtjzlrmu9U9SN0,55
+github_monitor-2.2.1.dist-info/top_level.txt,sha256=HDN2988ydvH9JZT32PushzqrcD05Q5qg960vgHGIaI8,15
+github_monitor-2.2.1.dist-info/RECORD,,

github_monitor.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 Author: Michal Szymanski <misiektoja-github@rm-rf.ninja>
-v2.1
+v2.2.1
 
 OSINT tool implementing real-time tracking of GitHub users activities including profile and repositories changes:
 https://github.com/misiektoja/github_monitor/
@@ -16,7 +16,7 @@ tzlocal (optional)
 python-dotenv (optional)
 """
 
-VERSION = "2.1"
+VERSION = "2.2.1"
 
 # ---------------------------
 # CONFIGURATION SECTION START
@@ -76,6 +76,7 @@ EVENT_NOTIFICATION = False
 
 # Whether to send an email when user's repositories change (stargazers, watchers, forks, issues,
 # PRs, description etc., except for update date)
+# Requires TRACK_REPOS_CHANGES to be enabled
 # Can also be enabled via the -q flag
 REPO_NOTIFICATION = False
 
@@ -83,6 +84,11 @@ REPO_NOTIFICATION = False
 # Can also be enabled via the -u flag
 REPO_UPDATE_DATE_NOTIFICATION = False
 
+# Whether to send an email when user's daily contributions count changes
+# Requires TRACK_CONTRIB_CHANGES to be enabled
+# Can also be enabled via the -y flag
+CONTRIB_NOTIFICATION = False
+
 # Whether to send an email on errors
 # Can also be disabled via the -e flag
 ERROR_NOTIFICATION = True
@@ -126,6 +132,14 @@ EVENTS_TO_MONITOR = [
 # any events older than the most recent EVENTS_NUMBER will be missed
 EVENTS_NUMBER = 30  # 1 page
 
+# If True, track user's repository changes (changed stargazers, watchers, forks, description, update date etc.)
+# Can also be enabled using the -j flag
+TRACK_REPOS_CHANGES = False
+
+# If True, disable event monitoring
+# Can also be disabled using the -k flag
+DO_NOT_MONITOR_GITHUB_EVENTS = False
+
 # If True, fetch all user repos (owned, forks, collaborations); otherwise, fetch only owned repos
 GET_ALL_REPOS = False
 
@@ -133,6 +147,10 @@ GET_ALL_REPOS = False
 # In listing mode (-r), blocked repos are always shown
 BLOCKED_REPOS = False
 
+# If True, track and log user's daily contributions count changes
+# Can also be enabled using the -m flag
+TRACK_CONTRIB_CHANGES = False
+
 # How often to print a "liveness check" message to the output; in seconds
 # Set to 0 to disable
 LIVENESS_CHECK_INTERVAL = 43200  # 12 hours
@@ -200,13 +218,17 @@ PROFILE_NOTIFICATION = False
 EVENT_NOTIFICATION = False
 REPO_NOTIFICATION = False
 REPO_UPDATE_DATE_NOTIFICATION = False
+CONTRIB_NOTIFICATION = False
 ERROR_NOTIFICATION = False
 GITHUB_CHECK_INTERVAL = 0
 LOCAL_TIMEZONE = ""
 EVENTS_TO_MONITOR = []
 EVENTS_NUMBER = 0
+TRACK_REPOS_CHANGES = False
+DO_NOT_MONITOR_GITHUB_EVENTS = False
 GET_ALL_REPOS = False
 BLOCKED_REPOS = False
+TRACK_CONTRIB_CHANGES = False
 LIVENESS_CHECK_INTERVAL = 0
 CHECK_INTERNET_URL = ""
 CHECK_INTERNET_TIMEOUT = 0
@@ -234,9 +256,6 @@ LIVENESS_CHECK_COUNTER = LIVENESS_CHECK_INTERVAL / GITHUB_CHECK_INTERVAL
 stdout_bck = None
 csvfieldnames = ['Date', 'Type', 'Name', 'Old', 'New']
 
-TRACK_REPOS_CHANGES = False
-DO_NOT_MONITOR_GITHUB_EVENTS = False
-
 CLI_CONFIG_PATH = None
 
 # to solve the issue: 'SyntaxError: f-string expression part cannot include a backslash'
@@ -252,7 +271,7 @@ if sys.version_info < (3, 10):
 import time
 import string
 import os
-from datetime import datetime, timezone
+from datetime import datetime, timezone, date
 from dateutil import relativedelta
 from dateutil.parser import isoparse
 import calendar
@@ -278,6 +297,7 @@ import re
 import ipaddress
 try:
     from github import Github, Auth, GithubException, UnknownObjectException
+    from github.GithubException import RateLimitExceededException
     from github.GithubException import BadCredentialsException
 except ModuleNotFoundError:
     raise SystemExit("Error: Couldn't find the PyGitHub library !\n\nTo install it, run:\n    pip3 install PyGithub\n\nOnce installed, re-run this tool. For more help, visit:\nhttps://github.com/PyGithub/PyGithub")
@@ -288,7 +308,9 @@ import socket
 from typing import Any, Callable
 import shutil
 from pathlib import Path
-
+from typing import Optional
+import datetime as dt
+import requests
 
 NET_ERRORS = (
     req.exceptions.RequestException,
@@ -566,6 +588,11 @@ def now_local_naive():
     return datetime.now(pytz.timezone(LOCAL_TIMEZONE)).replace(microsecond=0, tzinfo=None)
 
 
+# Returns today's date in LOCAL_TIMEZONE (naive date)
+def today_local() -> dt.date:
+    return now_local_naive().date()
+
+
 # Returns the current date/time in human readable format; eg. Sun 21 Apr 2024, 15:08:45
 def get_cur_ts(ts_str=""):
     return (f'{ts_str}{calendar.day_abbr[(now_local_naive()).weekday()]}, {now_local_naive().strftime("%d %b %Y, %H:%M:%S")}')
@@ -635,6 +662,11 @@ def get_short_date_from_ts(ts, show_year=False, show_hour=True, show_weekday=Tru
         ts_rounded = int(round(ts))
         ts_new = datetime.fromtimestamp(ts_rounded, tz)
 
+    elif isinstance(ts, date):
+        ts = datetime.combine(ts, datetime.min.time())
+        ts = pytz.utc.localize(ts)
+        ts_new = ts.astimezone(tz)
+
     else:
         return ""
 
@@ -840,6 +872,34 @@ def gh_call(fn: Callable[..., Any], retries=NET_MAX_RETRIES, backoff=NET_BASE_BA
         for i in range(1, retries + 1):
             try:
                 return fn(*args, **kwargs)
+            except RateLimitExceededException as e:
+                headers = getattr(e, "headers", None)
+
+                reset_str = None
+                if headers:
+                    val = headers.get("X-RateLimit-Reset")
+                    if isinstance(val, str):
+                        reset_str = val
+
+                sleep_for: int
+                if reset_str is not None and reset_str.isdigit():
+                    reset_epoch = int(reset_str)
+                    sleep_for = max(0, reset_epoch - int(time.time()) + 1)
+                else:
+                    retry_after_str = None
+                    if headers:
+                        ra = headers.get("Retry-After")
+                        if isinstance(ra, str):
+                            retry_after_str = ra
+                    if retry_after_str is not None and retry_after_str.isdigit():
+                        sleep_for = int(retry_after_str)
+                    else:
+                        sleep_for = int(backoff * i)
+
+                print(f"* {fn.__name__} rate limited, sleeping {sleep_for}s (retry {i}/{retries})")
+                time.sleep(sleep_for)
+                continue
+
             except NET_ERRORS as e:
                 print(f"* {fn.__name__} error: {e} (retry {i}/{retries})")
                 time.sleep(backoff * i)
@@ -1138,6 +1198,13 @@ def format_body_block(content, indent="    "):
     return f"\n{indented}"
 
 
+# Returns the base web URL for GitHub or GHE (e.g. https://github.com or https://ghe.example.com)
+def github_web_base() -> str:
+    if "api.github.com" in GITHUB_API_URL:
+        return "https://github.com"
+    return GITHUB_API_URL.replace("/api/v3", "").rstrip("/")
+
+
 # Prints details about passed GitHub event
 def github_print_event(event, g, time_passed=False, ts: datetime | None = None):
 
@@ -1158,19 +1225,33 @@ def github_print_event(event, g, time_passed=False, ts: datetime | None = None):
     st += print_v(f"Event type:\t\t\t{event.type}")
 
     if event.repo.id:
-        repo_name = event.repo.name
-        repo_url = event.repo.url.replace("https://api.github.com/repos/", "https://github.com/")
-        st += print_v(f"\nRepo name:\t\t\t{repo_name}")
-        st += print_v(f"Repo URL:\t\t\t{repo_url}")
-
         try:
             desc_len = 80
             repo = g.get_repo(event.repo.name)
-            desc = repo.description or ''
+
+            # For ForkEvent, prefer the source repo if available
+            if event.type == "ForkEvent" and repo is not None:
+                try:
+                    parent = gh_call(lambda: getattr(repo, "parent", None))()
+                    if parent:
+                        repo = parent
+                except Exception:
+                    pass
+
+            repo_name = getattr(repo, "full_name", event.repo.name)
+
+            api_prefix = GITHUB_API_URL.rstrip("/") + "/repos/"
+            repo_url = getattr(repo, "html_url", event.repo.url.replace(api_prefix, github_web_base() + "/"))
+
+            st += print_v(f"\nRepo name:\t\t\t{repo_name}")
+            st += print_v(f"Repo URL:\t\t\t{repo_url}")
+
+            desc = (repo.description or "") if repo else ""
             cleaned = desc.replace('\n', ' ')
             short_desc = cleaned[:desc_len] + '...' if len(cleaned) > desc_len else cleaned
             if short_desc:
                 st += print_v(f"Repo description:\t\t{short_desc}")
+
         except UnknownObjectException:
             repo = None
             st += print_v("\nRepository not found or has been removed")
@@ -1198,6 +1279,7 @@ def github_print_event(event, g, time_passed=False, ts: datetime | None = None):
     if event.payload.get("action"):
         st += print_v(f"\nAction:\t\t\t\t{event.payload.get('action')}")
 
+    # Prefer commits from payload when present (older API behavior)
     if event.payload.get("commits"):
         commits = event.payload["commits"]
         commits_total = len(commits)
@@ -1208,7 +1290,7 @@ def github_print_event(event, g, time_passed=False, ts: datetime | None = None):
 
             commit_details = None
             if repo:
-                commit_details = repo.get_commit(commit["sha"])
+                commit_details = gh_call(lambda: repo.get_commit(commit["sha"]))()
 
             if commit_details:
                 commit_date = commit_details.commit.author.date
@@ -1244,6 +1326,81 @@ def github_print_event(event, g, time_passed=False, ts: datetime | None = None):
             st += print_v(f"\n - Commit message:\t\t'{commit['message']}'")
             st += print_v("." * HORIZONTAL_LINE1)
 
+    # Fallback for new Events API where PushEvent no longer includes commit summaries
+    elif event.type == "PushEvent" and repo:
+        before_sha = event.payload.get("before")
+        head_sha = event.payload.get("head") or event.payload.get("after")
+        size_hint = event.payload.get("size")
+
+        # Debug when payload has no commits
+        # st += print_v("\n[debug] PushEvent payload has no 'commits' array; using compare API")
+        # st += print_v(f"[debug] before:\t\t\t{before_sha}")
+        # st += print_v(f"[debug] head/after:\t\t{head_sha}")
+        # if size_hint is not None:
+        #     st += print_v(f"[debug] size (hint):\t\t{size_hint}")
+
+        if before_sha and head_sha and before_sha != head_sha:
+            try:
+                compare = gh_call(lambda: repo.compare(before_sha, head_sha))()
+            except Exception as e:
+                compare = None
+                st += print_v(f"* Error using compare({before_sha[:12]}...{head_sha[:12]}): {e}")
+
+            if compare:
+                commits = list(compare.commits)
+                commits_total = len(commits)
+                short_repo = getattr(repo, "full_name", repo_name)
+                compare_url = f"{github_web_base()}/{short_repo}/compare/{before_sha[:12]}...{head_sha[:12]}"
+                st += print_v(f"\nNumber of commits:\t\t{commits_total}")
+                st += print_v(f"Compare URL:\t\t\t{compare_url}")
+
+                for commit_count, c in enumerate(commits, start=1):
+                    st += print_v(f"\n=== Commit {commit_count}/{commits_total} ===")
+                    st += print_v("." * HORIZONTAL_LINE1)
+
+                    commit_sha = getattr(c, "sha", None) or getattr(c, "id", None)
+                    commit_details = gh_call(lambda: repo.get_commit(commit_sha))() if (repo and commit_sha) else None
+
+                    if commit_details:
+                        commit_date = commit_details.commit.author.date
+                        st += print_v(f" - Commit date:\t\t\t{get_date_from_ts(commit_date)}")
+
+                    if commit_sha:
+                        st += print_v(f" - Commit SHA:\t\t\t{commit_sha}")
+
+                    author_name = None
+                    if commit_details and commit_details.commit and commit_details.commit.author:
+                        author_name = commit_details.commit.author.name
+                    st += print_v(f" - Commit author:\t\t{author_name or 'N/A'}")
+
+                    if commit_details and commit_details.author:
+                        st += print_v(f" - Commit author URL:\t\t{commit_details.author.html_url}")
+
+                    if commit_details:
+                        st += print_v(f" - Commit URL:\t\t\t{commit_details.html_url}")
+                        st += print_v(f" - Commit raw patch URL:\t{commit_details.html_url}.patch")
+
+                        stats = getattr(commit_details, "stats", None)
+                        additions = stats.additions if stats else 0
+                        deletions = stats.deletions if stats else 0
+                        stats_total = stats.total if stats else 0
+                        st += print_v(f"\n - Additions/Deletions:\t\t+{additions} / -{deletions} ({stats_total})")
+
+                        try:
+                            file_count = sum(1 for _ in commit_details.files)
+                        except Exception:
+                            file_count = "N/A"
+                        st += print_v(f" - Files changed:\t\t{file_count}")
+                        if file_count and file_count != "N/A":
+                            st += print_v(" - Changed files list:")
+                            for f in commit_details.files:
+                                st += print_v(f"     • '{f.filename}' - {f.status} (+{f.additions} / -{f.deletions})")
+
+                        st += print_v(f"\n - Commit message:\t\t'{commit_details.commit.message}'")
+                        st += print_v("." * HORIZONTAL_LINE1)
+        else:
+            st += print_v("\nNo compare range available (forced push, tag push, or identical before/after)")
+
     if event.payload.get("commits") == []:
         st += print_v("\nNo new commits (forced push, tag push, branch reset or other ref update)")
 
@@ -1700,9 +1857,11 @@ def handle_profile_change(label, count_old, count_new, list_old, raw_list, user,
     if removed_items:
         print(f"Removed {label.lower()}:\n")
         removed_mbody = f"\nRemoved {label.lower()}:\n\n"
+        web_base = github_web_base()
         for item in removed_items:
-            item_url = (f"https://github.com/{item}/" if label.lower() in ["followers", "followings", "starred repos"]
-                        else f"https://github.com/{user}/{item}/")
+            item_url = (f"{web_base}/{item}/" if label.lower() in ["followers", "followings", "starred repos"]
+                        else f"{web_base}/{user}/{item}/")
+
             print(f"- {item} [ {item_url} ]")
             removed_list_str += f"- {item} [ {item_url} ]\n"
             try:
@@ -1715,9 +1874,10 @@ def handle_profile_change(label, count_old, count_new, list_old, raw_list, user,
     if added_items:
         print(f"Added {label.lower()}:\n")
         added_mbody = f"\nAdded {label.lower()}:\n\n"
+        web_base = github_web_base()
         for item in added_items:
-            item_url = (f"https://github.com/{item}/" if label.lower() in ["followers", "followings", "starred repos"]
-                        else f"https://github.com/{user}/{item}/")
+            item_url = (f"{web_base}/{item}/" if label.lower() in ["followers", "followings", "starred repos"]
+                        else f"{web_base}/{user}/{item}/")
             print(f"- {item} [ {item_url} ]")
             added_list_str += f"- {item} [ {item_url} ]\n"
             try:
@@ -1789,7 +1949,7 @@ def check_repo_list_changes(count_old, count_new, list_old, list_new, label, rep
             print(f"{removal_text} {label.lower()}:\n")
             removed_mbody = f"\n{removal_text} {label.lower()}:\n\n"
             for item in removed_items:
-                item_line = f"- {item} [ https://github.com/{item}/ ]" if label.lower() in ["stargazers", "watchers", "forks"] else f"- {item}"
+                item_line = f"- {item} [ {github_web_base()}/{item}/ ]" if label.lower() in ["stargazers", "watchers", "forks"] else f"- {item}"
                 print(item_line)
                 removed_list_str += item_line + "\n"
                 try:
@@ -1804,7 +1964,7 @@ def check_repo_list_changes(count_old, count_new, list_old, list_new, label, rep
             print(f"Added {label.lower()}:\n")
             added_mbody = f"\nAdded {label.lower()}:\n\n"
             for item in added_items:
-                item_line = f"- {item} [ https://github.com/{item}/ ]" if label.lower() in ["stargazers", "watchers", "forks"] else f"- {item}"
+                item_line = f"- {item} [ {github_web_base()}/{item}/ ]" if label.lower() in ["stargazers", "watchers", "forks"] else f"- {item}"
                 print(item_line)
                 added_list_str += item_line + "\n"
                 try:
@@ -1983,6 +2143,97 @@ def is_profile_public(g: Github, user, new_account_days=30):
 
     return False
 
+
+# Returns a dict mapping 'YYYY-MM-DD' -> int contribution count for the range
+def get_daily_contributions(username: str, start: Optional[dt.date] = None, end: Optional[dt.date] = None, token: Optional[str] = None) -> dict:
+    if token is None:
+        raise ValueError("GitHub token is required")
+
+    today = dt.date.today()
+    if start is None:
+        start = today
+    if end is None:
+        end = today
+
+    url = GITHUB_API_URL.rstrip("/") + "/graphql"
+    headers = {"Authorization": f"Bearer {token}"}
+
+    start_iso = dt.datetime.combine(start, dt.time.min).isoformat()
+    to_exclusive = end + dt.timedelta(days=1)
+    end_iso = dt.datetime.combine(to_exclusive, dt.time.min).isoformat()
+
+    query = """
+    query($login: String!, $from: DateTime!, $to: DateTime!) {
+      user(login: $login) {
+        contributionsCollection(from: $from, to: $to) {
+          contributionCalendar {
+            weeks {
+              contributionDays {
+                date
+                contributionCount
+              }
+            }
+          }
+        }
+      }
+    }"""
+
+    variables = {"login": username, "from": start_iso, "to": end_iso}
+    r = requests.post(url, json={"query": query, "variables": variables}, headers=headers, timeout=30)
+    r.raise_for_status()
+    data = r.json()
+
+    days = data["data"]["user"]["contributionsCollection"]["contributionCalendar"]["weeks"]
+    out = {}
+    for w in days:
+        for d in w["contributionDays"]:
+            date = d["date"]
+            if start <= dt.date.fromisoformat(date) <= end:
+                out[date] = d["contributionCount"]
+    return out
+
+
+# Return contribution count for a single day
+def get_daily_contributions_count(username: str, day: dt.date, token: str) -> int:
+    data = get_daily_contributions(username, day, day, token)
+    return next(iter(data.values()), 0)
+
+
+# Checks count for today and decides whether to notify based on stored state.
+def check_daily_contribs(username: str, token: str, state: dict, min_delta: int = 1, fail_threshold: int = 3) -> tuple[bool, int, bool]:
+    day = today_local()
+
+    try:
+        curr = get_daily_contributions_count(username, day, token=token)
+        state["consecutive_failures"] = 0
+        state["last_error"] = None
+    except Exception as e:
+        state["consecutive_failures"] = state.get("consecutive_failures", 0) + 1
+        state["last_error"] = f"{type(e).__name__}: {e}"
+        error_notify = state["consecutive_failures"] >= fail_threshold
+        return False, state.get("count", 0), error_notify
+
+    prev_day = state.get("day")
+    prev_cnt = state.get("count")
+
+    # New day -> reset baseline silently
+    if prev_day != day:
+        state["day"] = day
+        state["count"] = curr
+        state["prev_count"] = curr
+        return False, curr, False  # no notify on rollover
+
+    # Same day -> notify if change >= threshold
+    if prev_cnt is not None and abs(curr - prev_cnt) >= min_delta:
+        state["prev_count"] = prev_cnt
+        state["count"] = curr
+        return True, curr, False
+
+    # No change
+    state["count"] = curr
+    return False, curr, False
+
+
 # Monitors activity of the specified GitHub user
 def github_monitor_user(user, csv_file_name):
 
@@ -2002,6 +2253,8 @@ def github_monitor_user(user, csv_file_name):
     event_date: datetime | None = None
     blocked = None
     public = False
+    contrib_state = {}
+    contrib_curr = 0
 
     print("Sneaking into GitHub like a ninja ...")
 
@@ -2044,6 +2297,14 @@ def github_monitor_user(user, csv_file_name):
         public = is_profile_public(g, user)
         blocked = is_blocked_by(user) if public else None
 
+        if TRACK_CONTRIB_CHANGES:
+            contrib_curr = get_daily_contributions_count(user, today_local(), token=GITHUB_TOKEN)
+            contrib_state = {
+                "day": today_local(),
+                "count": contrib_curr,
+                "prev_count": contrib_curr
+            }
+
         if not DO_NOT_MONITOR_GITHUB_EVENTS:
             events = list(islice(g_user.get_events(), EVENTS_NUMBER))
             available_events = len(events)
@@ -2124,6 +2385,8 @@ def github_monitor_user(user, csv_file_name):
     print(f"Followings:\t\t\t{followings_count}")
     print(f"Repositories:\t\t\t{repos_count}")
     print(f"Starred repos:\t\t\t{starred_count}")
+    if TRACK_CONTRIB_CHANGES:
+        print(f"Today's contributions:\t\t{contrib_curr}")
 
     if not DO_NOT_MONITOR_GITHUB_EVENTS:
         print(f"Available events:\t\t{available_events}{'+' if available_events == EVENTS_NUMBER else ''}")
@@ -2242,6 +2505,36 @@ def github_monitor_user(user, csv_file_name):
             starred_count = starred_raw.totalCount
             starred_old, starred_old_count = handle_profile_change("Starred Repos", starred_old_count, starred_count, starred_old, starred_list, user, csv_file_name, field="full_name")
 
+        # Changed contributions in a day
+        if TRACK_CONTRIB_CHANGES:
+            contrib_notify, contrib_curr, contrib_error_notify = check_daily_contribs(user, GITHUB_TOKEN, contrib_state, min_delta=1, fail_threshold=3)
+            if contrib_error_notify and ERROR_NOTIFICATION:
+                failures = contrib_state.get("consecutive_failures", 0)
+                last_err = contrib_state.get("last_error", "Unknown error")
+                err_msg = f"Error: GitHub daily contributions check failed {failures} times. Last error: {last_err}\n"
+                print(err_msg)
+                send_email(f"GitHub monitor errors for {user}", err_msg + get_cur_ts(nl_ch + "Timestamp: "), "", SMTP_SSL)
+
+            if contrib_notify:
+                contrib_old = contrib_state.get("prev_count")
+                print(f"* Daily contributions changed for user {user} on {get_short_date_from_ts(contrib_state['day'], show_hour=False)} from {contrib_old} to {contrib_curr}!\n")
+
+                try:
+                    if csv_file_name:
+                        write_csv_entry(csv_file_name, now_local_naive(), "Daily Contribs", user, contrib_old, contrib_curr)
+                except Exception as e:
+                    print(f"* Error: {e}")
+
+                m_subject = f"GitHub user {user} daily contributions changed from {contrib_old} to {contrib_curr}!"
+                m_body = (f"GitHub user {user} daily contributions changed on {get_short_date_from_ts(contrib_state['day'], show_hour=False)} from {contrib_old} to {contrib_curr}\n\nCheck interval: {display_time(GITHUB_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - GITHUB_CHECK_INTERVAL, int(time.time()), short=True)}){get_cur_ts(nl_ch + 'Timestamp: ')}")
+
+                if CONTRIB_NOTIFICATION:
+                    print(f"Sending email notification to {RECEIVER_EMAIL}")
+                    send_email(m_subject, m_body, "", SMTP_SSL)
+
+                print(f"Check interval:\t\t\t{display_time(GITHUB_CHECK_INTERVAL)} ({get_range_of_dates_from_tss(int(time.time()) - GITHUB_CHECK_INTERVAL, int(time.time()), short=True)})")
+                print_cur_ts("Timestamp:\t\t\t")
+
         # Changed bio
         bio = gh_call(lambda: g_user.bio)()
         if bio is not None and bio != bio_old:
@@ -2652,7 +2945,7 @@ def github_monitor_user(user, csv_file_name):
 
 
 def main():
-    global CLI_CONFIG_PATH, DOTENV_FILE, LOCAL_TIMEZONE, LIVENESS_CHECK_COUNTER, GITHUB_TOKEN, GITHUB_API_URL, CSV_FILE, DISABLE_LOGGING, GITHUB_LOGFILE, PROFILE_NOTIFICATION, EVENT_NOTIFICATION, REPO_NOTIFICATION, REPO_UPDATE_DATE_NOTIFICATION, ERROR_NOTIFICATION, GITHUB_CHECK_INTERVAL, SMTP_PASSWORD, stdout_bck, DO_NOT_MONITOR_GITHUB_EVENTS, TRACK_REPOS_CHANGES, GET_ALL_REPOS
+    global CLI_CONFIG_PATH, DOTENV_FILE, LOCAL_TIMEZONE, LIVENESS_CHECK_COUNTER, GITHUB_TOKEN, GITHUB_API_URL, CSV_FILE, DISABLE_LOGGING, GITHUB_LOGFILE, PROFILE_NOTIFICATION, EVENT_NOTIFICATION, REPO_NOTIFICATION, REPO_UPDATE_DATE_NOTIFICATION, ERROR_NOTIFICATION, GITHUB_CHECK_INTERVAL, SMTP_PASSWORD, stdout_bck, DO_NOT_MONITOR_GITHUB_EVENTS, TRACK_REPOS_CHANGES, GET_ALL_REPOS, CONTRIB_NOTIFICATION, TRACK_CONTRIB_CHANGES
 
     if "--generate-config" in sys.argv:
         print(CONFIG_BLOCK.strip("\n"))
@@ -2759,6 +3052,13 @@ def main():
         default=None,
         help="Email when user's repositories update date changes"
     )
+    notify.add_argument(
+        "-y", "--notify-daily-contribs",
+        dest="notify_daily_contribs",
+        action="store_true",
+        default=None,
+        help="Email when user's daily contributions count changes"
+    )
     notify.add_argument(
         "-e", "--no-error-notify",
         dest="notify_errors",
@@ -2858,6 +3158,13 @@ def main():
         default=None,
         help="Disable logging to github_monitor_<username>.log"
     )
+    opts.add_argument(
+        "-m", "--track-contribs-changes",
+        dest="track_contribs_changes",
+        action="store_true",
+        default=None,
+        help="Track user's daily contributions count and log changes"
+    )
 
     args = parser.parse_args()
 
@@ -3047,12 +3354,18 @@ def main():
     if args.notify_repo_update_date is True:
         REPO_UPDATE_DATE_NOTIFICATION = True
 
+    if args.notify_daily_contribs is True:
+        CONTRIB_NOTIFICATION = True
+
     if args.notify_errors is False:
         ERROR_NOTIFICATION = False
 
     if args.track_repos_changes is True:
         TRACK_REPOS_CHANGES = True
 
+    if args.track_contribs_changes is True:
+        TRACK_CONTRIB_CHANGES = True
+
     if args.no_monitor_events is True:
         DO_NOT_MONITOR_GITHUB_EVENTS = True
 
@@ -3060,6 +3373,9 @@ def main():
         REPO_NOTIFICATION = False
         REPO_UPDATE_DATE_NOTIFICATION = False
 
+    if not TRACK_CONTRIB_CHANGES:
+        CONTRIB_NOTIFICATION = False
+
     if DO_NOT_MONITOR_GITHUB_EVENTS:
         EVENT_NOTIFICATION = False
 
@@ -3068,12 +3384,14 @@ def main():
         PROFILE_NOTIFICATION = False
         REPO_NOTIFICATION = False
         REPO_UPDATE_DATE_NOTIFICATION = False
+        CONTRIB_NOTIFICATION = False
         ERROR_NOTIFICATION = False
 
     print(f"* GitHub polling interval:\t[ {display_time(GITHUB_CHECK_INTERVAL)} ]")
-    print(f"* Email notifications:\t\t[profile changes = {PROFILE_NOTIFICATION}] [new events = {EVENT_NOTIFICATION}]\n*\t\t\t\t[repos changes = {REPO_NOTIFICATION}] [repos update date = {REPO_UPDATE_DATE_NOTIFICATION}]\n*\t\t\t\t[errors = {ERROR_NOTIFICATION}]")
+    print(f"* Email notifications:\t\t[profile changes = {PROFILE_NOTIFICATION}] [new events = {EVENT_NOTIFICATION}]\n*\t\t\t\t[repos changes = {REPO_NOTIFICATION}] [repos update date = {REPO_UPDATE_DATE_NOTIFICATION}]\n*\t\t\t\t[contrib changes = {CONTRIB_NOTIFICATION}] [errors = {ERROR_NOTIFICATION}]")
     print(f"* GitHub API URL:\t\t{GITHUB_API_URL}")
     print(f"* Track repos changes:\t\t{TRACK_REPOS_CHANGES}")
+    print(f"* Track contrib changes:\t{TRACK_CONTRIB_CHANGES}")
     print(f"* Monitor GitHub events:\t{not DO_NOT_MONITOR_GITHUB_EVENTS}")
     print(f"* Get owned repos only:\t\t{not GET_ALL_REPOS}")
     print(f"* Liveness check:\t\t{bool(LIVENESS_CHECK_INTERVAL)}" + (f" ({display_time(LIVENESS_CHECK_INTERVAL)})" if LIVENESS_CHECK_INTERVAL else ""))

github_monitor-2.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-github_monitor.py,sha256=TwfAtvASFyS-SFWZryolvv81Q0yoPhz_FBNjw2xXkBA,124098
-github_monitor-2.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-github_monitor-2.1.dist-info/METADATA,sha256=kTwOp_S9Gq9baD6Gzl9k8s-0BGwVbU9MWuD3Zi7lkdM,17039
-github_monitor-2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-github_monitor-2.1.dist-info/entry_points.txt,sha256=hV03y00u1L16S5BwBSLQvFsZcL2WGRtjzlrmu9U9SN0,55
-github_monitor-2.1.dist-info/top_level.txt,sha256=HDN2988ydvH9JZT32PushzqrcD05Q5qg960vgHGIaI8,15
-github_monitor-2.1.dist-info/RECORD,,