GithubTotal 1.0.0__tar.gz

githubtotal-1.0.0/GithubTotal/cli.py

@@ -0,0 +1,333 @@
+import argparse
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+import requests
+from openpyxl import Workbook
+
+__version__ = "1.0.0"
+
+
+def main():
+    parser = argparse.ArgumentParser(description="GithubTotal")
+    parser.add_argument("command", nargs="?", help="Github account name")
+    parser.add_argument(
+        "-o",
+        "--output",
+        metavar="FILENAME.xlsx",
+        help="Output file path",
+    )
+
+    args = parser.parse_args()
+
+    if args.command is None:
+        print(f"Github Total v{__version__}")
+        print("Usage: ght/github-total <username> [--output FILENAME.xlsx]")
+        exit()
+
+    now = datetime.now(ZoneInfo("Asia/Shanghai"))
+    uname = args.command
+
+    try:
+        json = requests.get(
+            f"https://api.github.com/users/{uname}/repos?per_page=100"
+        ).json()
+        if "status" in json:
+            print("无法获取仓库数据:", json["message"])
+            exit()
+    except Exception as e:
+        print("无法获取仓库数据:", e)
+        exit()
+
+    info = {
+        "name": None,
+        "id": None,
+        "created_at": None,
+        "followers": None,
+    }
+
+    try:
+        info = requests.get(f"https://api.github.com/users/{uname}").json()
+        if "status" in info:
+            print("无法获取用户数据:", json["message"])
+    except Exception as e:
+        print("无法获取用户数据:", e)
+
+    wb = Workbook()
+
+    ws = wb.active
+
+    ws.title = "仓库数据"
+
+    ws["A1"] = "仓库名"
+    ws["B1"] = "Fork 状态"
+    ws["C1"] = "协议"
+    ws["D1"] = "发布日期"
+    ws["E1"] = "状态 (按发布)"
+    ws["F1"] = "更新日期"
+    ws["G1"] = "状态 (按更新)"
+    ws["H1"] = "Star"
+    ws["I1"] = "Watcher"
+    ws["J1"] = "Fork"
+    ws["K1"] = "语言"
+
+    total = {
+        "total": 0,
+        "star": 0,
+        "watcher": 0,
+        "fork": 0,
+        "push": {"new": 0, "behind": 0, "old": 0},
+        "upd": {"new": 0, "behind": 0, "old": 0},
+        "is_fork": 0,
+        "not_fork": 0,
+        "license": {},
+        "create_at_year": {},
+        "create_at_weekday": {},
+        "langs": {},
+        "stars": {},
+    }
+
+    for i in json:
+        total["total"] += 1
+
+        name = i["name"]
+
+        is_fork = i["fork"]
+
+        if is_fork:
+            total["is_fork"] += 1
+            is_fork = "是"
+        else:
+            total["not_fork"] += 1
+            is_fork = "否"
+
+        license = i["license"]
+
+        if not license:
+            license = "无"
+        else:
+            license = license["name"]
+
+        if license in total["license"]:
+            total["license"][license] += 1
+        else:
+            total["license"][license] = 1
+
+        created_at = datetime.fromisoformat(
+            i["created_at"].replace("Z", "+00:00")
+        ).astimezone(ZoneInfo("Asia/Shanghai"))
+
+        updated_at = datetime.fromisoformat(
+            i["pushed_at"].replace("Z", "+00:00")
+        ).astimezone(ZoneInfo("Asia/Shanghai"))
+
+        if created_at.year == now.year:
+            if created_at.month == now.month:
+                total["push"]["new"] += 1
+                created_status = "新"
+            else:
+                total["push"]["behind"] += 1
+                created_status = "中"
+        else:
+            total["push"]["old"] += 1
+            created_status = "旧"
+
+        if updated_at.year == now.year:
+            if updated_at.month == now.month:
+                total["upd"]["new"] += 1
+                updated_status = "新"
+            else:
+                total["upd"]["behind"] += 1
+                updated_status = "中"
+        else:
+            total["upd"]["old"] += 1
+            updated_status = "旧"
+
+        created_at_year = created_at.year
+
+        if created_at_year in total["create_at_year"]:
+            total["create_at_year"][created_at_year] += 1
+        else:
+            total["create_at_year"][created_at_year] = 1
+
+        created_at_weekday = created_at.weekday()
+
+        if created_at_weekday in total["create_at_weekday"]:
+            total["create_at_weekday"][created_at_weekday] += 1
+        else:
+            total["create_at_weekday"][created_at_weekday] = 1
+
+        star = i["stargazers_count"]
+
+        total["star"] += star
+
+        total["stars"][name] = star
+
+        watcher = i["watchers_count"]
+
+        total["watcher"] += watcher
+
+        fork = i["forks_count"]
+
+        total["fork"] += fork
+
+        lang = i["language"]
+
+        if lang in total["langs"]:
+            total["langs"][lang] += 1
+        else:
+            total["langs"][lang] = 1
+
+        ws.append(
+            [
+                name,
+                is_fork,
+                license,
+                created_at.strftime("%Y年%m月%d日"),
+                created_status,
+                updated_at.strftime("%Y年%m月%d日"),
+                updated_status,
+                star,
+                watcher,
+                fork,
+                lang,
+            ]
+        )
+
+    ts = wb.create_sheet("统计数据")
+
+    ts["A1"] = "最多显示"
+    ts["B1"] = "仓库数量"
+    ts["C1"] = "新数量 (按发布)"
+    ts["D1"] = "中数量 (按发布)"
+    ts["E1"] = "旧数量 (按发布)"
+    ts["F1"] = "新数量 (按更新)"
+    ts["G1"] = "中数量 (按更新)"
+    ts["H1"] = "旧数量 (按更新)"
+    ts["I1"] = "Fork 数量"
+    ts["J1"] = "非 Fork 数量"
+    ts["K1"] = "使用最多的协议"
+    ts["L1"] = "创建仓库最多的年"
+    ts["M1"] = "创建仓库最多的星期"
+    ts["N1"] = "Star 数量"
+    ts["O1"] = "Watcher 数量"
+    ts["P1"] = "Fork 数量"
+    ts["Q1"] = "使用最多的语言"
+    ts["R1"] = "Star 最多的仓库"
+    ts["S1"] = "今日日期"
+
+    license = total["license"]
+
+    liceense_value = list(license.values())
+
+    max_license_value = max(liceense_value)
+    max_license = [i for i, j in license.items() if j == max_license_value]
+
+    created_at_year = total["create_at_year"]
+
+    created_at_year_value = list(created_at_year.values())
+
+    max_created_at_year_value = max(created_at_year_value)
+    max_created_at_year = [
+        str(i) for i, j in created_at_year.items() if j == max_created_at_year_value
+    ]
+
+    weekday_map = {
+        0: "星期一",
+        1: "星期二",
+        2: "星期三",
+        3: "星期四",
+        4: "星期五",
+        5: "星期六",
+        6: "星期日",
+    }
+
+    created_at_weekday = total["create_at_weekday"]
+
+    created_at_weekday_value = list(created_at_weekday.values())
+
+    max_created_at_weekday_value = max(created_at_weekday_value)
+    max_created_at_weekday = [
+        weekday_map[i]
+        for i, j in created_at_weekday.items()
+        if j == max_created_at_weekday_value
+    ]
+
+    langs = total["langs"]
+
+    langs_value = list(langs.values())
+
+    max_langs_value = max(langs_value)
+    max_langs = [i for i, j in langs.items() if j == max_langs_value]
+
+    stars = total["stars"]
+
+    stars_value = list(stars.values())
+
+    max_stars_value = max(stars_value)
+    max_stars = [i for i, j in stars.items() if j == max_stars_value]
+
+    ts.append(
+        [
+            100,
+            total["total"],
+            total["push"]["new"],
+            total["push"]["behind"],
+            total["push"]["old"],
+            total["upd"]["new"],
+            total["upd"]["behind"],
+            total["upd"]["old"],
+            total["is_fork"],
+            total["not_fork"],
+            ", ".join(max_license),
+            ", ".join(max_created_at_year),
+            ", ".join(max_created_at_weekday),
+            total["star"],
+            total["watcher"],
+            total["fork"],
+            ", ".join(max_langs),
+            ", ".join(max_stars),
+            now.strftime("%Y年%m月%d日"),
+        ]
+    )
+
+    us = wb.create_sheet("用户数据")
+
+    us["A1"] = "用户名"
+    us["B1"] = "ID"
+    us["C1"] = "创建日期"
+    us["D1"] = "粉丝数量"
+
+    name = info["name"] or uname
+
+    uid = info["id"]
+    if uid == None:
+        uid = "未知"
+    else:
+        uid = str(uid)
+
+    ucreated_at = (
+        datetime.fromisoformat(info["created_at"].replace("Z", "+00:00"))
+        .astimezone(ZoneInfo("Asia/Shanghai"))
+        .strftime("%Y年%m月%d日")
+    )
+
+    followers = info["followers"]
+    if followers == None:
+        followers = "未知"
+    else:
+        followers = str(followers)
+
+    us.append(
+        [
+            name,
+            uid,
+            ucreated_at,
+            followers,
+        ]
+    )
+
+    if hasattr(parser, "output"):
+        wb.save(parser.output)
+    else:
+        wb.save("GithubTotal.xlsx")

githubtotal-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 qiufengcute
+
+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.

githubtotal-1.0.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: GithubTotal
+Version: 1.0.0
+Summary: Generate personal GitHub stats report with multi-dimensional analysis.
+License: MIT
+License-File: LICENSE
+Keywords: github,stats,report,excel,cli,analytics,github-api,repository,insights,developer-tools,productivity
+Author: qiufeng
+Author-email: appleidqiufeng@outlook.com
+Requires-Python: >=3.8,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Filesystems
+Requires-Dist: openpyxl (>=3.0.0,<4.0.0)
+Requires-Dist: requests (>=2.28.0,<3.0.0)
+Project-URL: Changelog, https://github.com/qiufengcute/GithubTotal/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/qiufengcute/GithubTotal
+Project-URL: Repository, https://github.com/qiufengcute/GithubTotal
+Description-Content-Type: text/markdown
+
+# GitHub Total
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Version](https://img.shields.io/pypi/v/GithubTotal.svg)]()
+[![Download](https://img.shields.io/pypi/dm/GithubTotal.svg)]()
+
+Generate personal GitHub stats report with multi-dimensional analysis.
+
+## Features
+
+- 📊 Generate Excel report with 3 sheets:
+  - **Repository Data**: All repos with metadata (creation date, update date, language, stars, etc.)
+  - **Statistics**: Summary stats (active repos by period, top language, star leaders, etc.)
+  - **User Info**: Basic profile info
+- 🚀 One command, no config needed
+- 📈 Auto-categorize repos by creation/update time (New(This month)/Mid(This year)/Old(Before this year))
+- ⭐ Track your stars (including self-stars)
+
+## Installation
+
+```bash
+pip install GithubTotal
+```
+
+## Usage
+
+```bash
+ght <username> -o <output.xlsx>
+```
+

githubtotal-1.0.0/README.md

@@ -0,0 +1,30 @@
+# GitHub Total
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Version](https://img.shields.io/pypi/v/GithubTotal.svg)]()
+[![Download](https://img.shields.io/pypi/dm/GithubTotal.svg)]()
+
+Generate personal GitHub stats report with multi-dimensional analysis.
+
+## Features
+
+- 📊 Generate Excel report with 3 sheets:
+  - **Repository Data**: All repos with metadata (creation date, update date, language, stars, etc.)
+  - **Statistics**: Summary stats (active repos by period, top language, star leaders, etc.)
+  - **User Info**: Basic profile info
+- 🚀 One command, no config needed
+- 📈 Auto-categorize repos by creation/update time (New(This month)/Mid(This year)/Old(Before this year))
+- ⭐ Track your stars (including self-stars)
+
+## Installation
+
+```bash
+pip install GithubTotal
+```
+
+## Usage
+
+```bash
+ght <username> -o <output.xlsx>
+```

githubtotal-1.0.0/pyproject.toml

@@ -0,0 +1,40 @@
+[tool.poetry]
+name = "GithubTotal"
+version = "1.0.0"
+description = "Generate personal GitHub stats report with multi-dimensional analysis."
+authors = ["qiufeng <appleidqiufeng@outlook.com>"]
+readme = "README.md"
+license = "MIT"
+keywords = ["github", "stats", "report", "excel", "cli", "analytics", "github-api", "repository", "insights", "developer-tools", "productivity"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Filesystems",
+]
+
+[tool.poetry.scripts]
+ght = "GithubTotal.cli:main"
+github-total = "GithubTotal.cli:main"
+
+[tool.poetry.urls]
+"Homepage" = "https://github.com/qiufengcute/GithubTotal"
+"Repository" = "https://github.com/qiufengcute/GithubTotal"
+"Changelog" = "https://github.com/qiufengcute/GithubTotal/blob/main/CHANGELOG.md"
+
+[tool.poetry.dependencies]
+python = "^3.8"
+requests = "^2.28.0"
+openpyxl = "^3.0.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"