gitcode-insight 0.1.0__py3-none-any.whl

gitcode_insight/__init__.py

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+"""
+GitCode Insight - GitCode 平台代码洞察工具
+"""
+
+__version__ = "0.1.0"
+__author__ = "GitCode Insight Team"
+
+from .community import GitCodeCommunityStats
+from .issue import GitCodeIssueInsight
+from .pr import GitCodePRInsight
+from .dashboard import generate_dashboard, generate_markdown_file
+from .repo_stats import GitCodeRepoStats
+from .report import GitCodeReport
+
+__all__ = [
+    "GitCodeCommunityStats",
+    "GitCodeIssueInsight",
+    "GitCodePRInsight",
+    "generate_dashboard",
+    "generate_markdown_file",
+    "GitCodeRepoStats",
+    "GitCodeReport",
+]

gitcode_insight/cli.py

@@ -0,0 +1,212 @@
+# -*- coding: utf-8 -*-
+"""
+GitCode Insight 命令行入口
+"""
+
+import argparse
+import os
+import json
+
+from .community import GitCodeCommunityStats
+from .issue import GitCodeIssueInsight
+from .pr import GitCodePRInsight
+from .dashboard import generate_dashboard
+from .repo_stats import GitCodeRepoStats
+from .report import GitCodeReport
+
+
+def get_config_owner(config_file):
+    """从配置文件获取 owner"""
+    if config_file is None:
+        config_file = os.path.join(os.getcwd(), "config", "gitcode.json")
+
+    if os.path.exists(config_file):
+        with open(config_file, 'r', encoding='utf-8') as f:
+            config = json.load(f)
+            return config.get("owner", "")
+    return ""
+
+
+def cmd_community(args):
+    """社区洞察命令"""
+    config_file = args.config
+    output_dir = args.output
+
+    # 创建统计实例
+    stats_crawler = GitCodeCommunityStats(config_file=config_file, output_dir=output_dir)
+
+    # 爬取社区的统计数据
+    stats = stats_crawler.crawl_community_stats()
+
+    # 生成报告
+    stats_crawler.generate_report(stats)
+
+    # 保存到CSV
+    stats_crawler.save_to_csv(stats)
+
+    # 保存详细数据到JSON
+    stats_crawler.save_to_json(stats)
+
+    print("\n\n数据爬取和分析完成！")
+    print("- 详细报告已打印到控制台")
+
+
+def cmd_issue(args):
+    """Issue 洞察命令"""
+    insight = GitCodeIssueInsight(
+        repo=args.repo,
+        token=args.token,
+        owner=args.owner,
+        days=args.days,
+        range_by=args.range_by,
+        output_dir=args.output
+    )
+
+    insight.run()
+
+
+def cmd_pr(args):
+    """PR 洞察命令"""
+    insight = GitCodePRInsight(
+        repo=args.repo,
+        token=args.token,
+        owner=args.owner,
+        days=args.days,
+        output_dir=args.output
+    )
+
+    insight.run()
+
+
+def cmd_repo_stats(args):
+    """仓库统计命令"""
+    stats = GitCodeRepoStats(
+        repo=args.repo,
+        token=args.token,
+        owner=args.owner,
+        days=args.days,
+        output_dir=args.output
+    )
+
+    stats.run()
+
+
+def cmd_dashboard(args):
+    """生成看板命令（自动检测数据是否存在，不存在则先采集）"""
+    config_file = args.config
+    output_dir = args.output
+
+    # 设置默认路径
+    if config_file is None:
+        config_file = os.path.join(os.getcwd(), "config", "gitcode.json")
+    if output_dir is None:
+        output_dir = os.path.join(os.getcwd(), "output")
+
+    # 获取 owner
+    owner = get_config_owner(config_file)
+    if not owner:
+        print("错误: 无法从配置文件获取 owner")
+        return
+
+    # 检测数据文件是否存在
+    json_file = os.path.join(output_dir, f"{owner}_community_stats_detailed.json")
+
+    if not os.path.exists(json_file):
+        print(f"数据文件不存在: {json_file}")
+        print("开始自动采集数据...\n")
+
+        # 自动运行采集
+        stats_crawler = GitCodeCommunityStats(config_file=config_file, output_dir=output_dir)
+        stats = stats_crawler.crawl_community_stats()
+        stats_crawler.generate_report(stats)
+        stats_crawler.save_to_csv(stats)
+        stats_crawler.save_to_json(stats)
+
+        print("\n数据采集完成！\n")
+
+    # 生成看板
+    generate_dashboard(config_file=config_file, output_dir=output_dir)
+
+
+def cmd_report(args):
+    """仓库综合报告命令"""
+    report = GitCodeReport(
+        repo=args.repo,
+        token=args.token,
+        owner=args.owner,
+        days=args.days,
+        output_dir=args.output
+    )
+
+    report.run()
+
+
+def main():
+    """主入口"""
+    parser = argparse.ArgumentParser(
+        prog="gc-insight",
+        description="GitCode 平台代码洞察工具"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="子命令")
+
+    # community 子命令
+    community_parser = subparsers.add_parser("community", help="社区洞察")
+    community_parser.add_argument("--config", default=None, help="配置文件路径，默认使用 ./config/gitcode.json")
+    community_parser.add_argument("--output", default=None, help="输出目录，默认使用 ./output/")
+    community_parser.set_defaults(func=cmd_community)
+
+    # issue 子命令
+    issue_parser = subparsers.add_parser("issue", help="Issue 洞察")
+    issue_parser.add_argument("--repo", required=True, help="仓库名称（path）")
+    issue_parser.add_argument("--token", required=True, help="API 访问令牌")
+    issue_parser.add_argument("--days", type=int, default=30, help="统计天数，默认 30")
+    issue_parser.add_argument("--range-by", dest="range_by", choices=["created", "updated", "active"], default="created", help="统计范围口径：created=近N天创建，updated=近N天更新，active=近N天创建或更新（默认 created）")
+    issue_parser.add_argument("--owner", default=None, help="组织名，默认从配置文件读取")
+    issue_parser.add_argument("--output", default=None, help="输出目录，默认使用 ./output/")
+    issue_parser.set_defaults(func=cmd_issue)
+
+    # pr 子命令
+    pr_parser = subparsers.add_parser("pr", help="PR 洞察")
+    pr_parser.add_argument("--repo", required=True, help="仓库名称（path）")
+    pr_parser.add_argument("--token", required=True, help="API 访问令牌")
+    pr_parser.add_argument("--days", type=int, default=30, help="统计天数，默认 30")
+    pr_parser.add_argument("--owner", default=None, help="组织名，默认从配置文件读取")
+    pr_parser.add_argument("--output", default=None, help="输出目录，默认使用 ./output/")
+    pr_parser.set_defaults(func=cmd_pr)
+
+    # repo-stats 子命令
+    repo_stats_parser = subparsers.add_parser("repo-stats", help="仓库统计")
+    repo_stats_parser.add_argument("--repo", required=True, help="仓库名称（path）")
+    repo_stats_parser.add_argument("--token", required=True, help="API 访问令牌")
+    repo_stats_parser.add_argument("--owner", default=None, help="组织名，默认从配置文件读取")
+    repo_stats_parser.add_argument("--days", type=int, default=30, help="统计天数，默认 30")
+    repo_stats_parser.add_argument("--output", default=None, help="输出目录，默认使用 ./output/")
+    repo_stats_parser.set_defaults(func=cmd_repo_stats)
+
+    # dashboard 子命令
+    dashboard_parser = subparsers.add_parser("dashboard", help="生成看板")
+    dashboard_parser.add_argument("--config", default=None, help="配置文件路径，默认使用 ./config/gitcode.json")
+    dashboard_parser.add_argument("--output", default=None, help="输出目录，默认使用 ./output/")
+    dashboard_parser.set_defaults(func=cmd_dashboard)
+
+    # report 子命令
+    report_parser = subparsers.add_parser("report", help="仓库综合报告")
+    report_parser.add_argument("--repo", required=True, help="仓库名称（path）")
+    report_parser.add_argument("--token", required=True, help="API 访问令牌")
+    report_parser.add_argument("--days", type=int, default=30, help="统计天数，默认 30")
+    report_parser.add_argument("--owner", default=None, help="组织名，默认从配置文件读取")
+    report_parser.add_argument("--output", default=None, help="输出目录，默认使用 ./output/")
+    report_parser.set_defaults(func=cmd_report)
+
+    args = parser.parse_args()
+
+    if args.command is None:
+        parser.print_help()
+        return
+
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()