A Github Project Rank Command Line Tool


Keywords
cli, github, hacktoberfest, hacktoberfest2018, python3
License
GPL-3.0
Install
pip install Grank==1.0.4

Documentation

Grank - Github 项目活跃度分析工具

All Contributors

PyPI - Python Version PyPI GitHub tag GitHub GitHub last commit

Travis (.com) GitHub issues GitHub pull requests

特性

  • 读取 Commit 信息分析
    • 支持抓取特定时间段的 commit 数据
  • 使用 GraphQL 进行数据的抓取
  • 分析结果自动排行,并生成活跃度折线图
    • 提供所有项目的活跃度、社区化排行
    • 提供单个项目的活跃度、社区化整合图像

样例图片展示

多项目活跃度

多项目社区化

单项目社区化及活跃度

安装需求

Python 3.4 +

使用方法

  1. 使用 pip 安装项目 pip install grank
  2. 获取 Github 的 Personal Access Token
  3. 使用 grank login 设置 Token
  4. 使用 grank config 设置社区化企业关键词
  5. 使用 grank analy [mode] <owner> [<repository>] 来分析特定用户/组织和项目,比如 grank analy lctt grank,分析结果可以在执行命令目录的 result 目录中找到。
  6. 使用命令行模式操作,如 grank --token=XXXX --start=2018-01-01 --stop=2018-05-21 --askrule=0 --rule=inc analy <owner> <repository> 其中 token 必须指定,其他可以使用缺省设置

命令列表

  1. grank checklogin 显示当前 Token 的登录用户
  2. grank login 设置用户 Token
  3. grank config 设置关键词,用于社区化分析
  4. grank analy [mode] 分析组织名下或用户名下项目的活跃度或社区化程度,mode 的默认值为all,可设定为socialactivity。调用方法 grank analy lctt / grank analy --social lctt grank
  5. grank clean 清空当前目录下的临时文件和结果,调用方法 grank clean

配置文件说明

[login]
token = xxx #personal access token

[social]
askrule = 1 # 设置为1时将提醒用户设置规则
rule = corp|inc # 进行社区化分析时的正则表达式规则

[time]
start_time = 2017-01-01 # 分析的开始时间
end_time = 2018-10-01 # 分析的结束时间

[rank]
top = 3 # 绘图时绘制折线的项目数量

贡献项目

在您进行项目贡献前,请查看 CONTRIBUTING.md

开源协议

GPL-3.0

Contributors

Thanks goes to these wonderful people (emoji key):


Bestony

💻 📖 💡 📦 👀 ⚠️ 🔧

Xingyu.Wang

💬 🐛 💻 👀 📢

LuMing

💻 📖 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!