Skip to content

目标是创建会刷新的ReadMe首页! 在这里,你可以得到Github star/fork总数图标, 项目star历史曲线,star数最多的前N个Repo信息...

License

Notifications You must be signed in to change notification settings

bartdong/GithubTools

 
 

Repository files navigation

Github 工具箱 
源自 ButterAndButterfly
Butter, 寓意宅男; Butterfly, 寓意美好的事物。
美好的世界由我们创造!

功能

  • 统计个人/组织的star总数和fork总数(基于Github graphQL)
  • 统计个人/组织的star数最多的项目信息(基于Github graphQL)
  • 统计项目的star历史数据并绘图(基于Github API v3)
  • 开箱即用】提供完整的静态的图片生成方法,只需要fork后简单修改配置即可转为自己使用(基于Github Actions)
  • 开箱即用】提供现成的动态的图片。(因为Github API的访问频率限制,有可能获取失败。您也可以clone/fork后自己部署在vercel上。)
  • 开箱即用】提供会自动刷新的ReadMe首页。Demo

展示

动态star/fork总数

静态star/fork总数(刷新周期为1天)

动态star历史数

静态star历史数(刷新周期为1天)

使用

最快捷的方法
最实用的方法 - Github静态部署
  • 原理: 使用Github Actions周期(默认每天)查询并保存生成的相关数据,访问静态数据即可。
  • 步骤:
    1. fork本项目,并激活Actions
    2. 修改config.json
    {
        "token":"token", //因为安全需要,最好在项目里面设置,此处可不填
        "tasks":[ // tasks 是一个任务数组,可根据需要删除或增加任务
            {
                "type": "get_total_stars_and_forks", //获取某用户/组织的stars和forks总数
                "name":"nICEnnnnnnnLee",             // 可以是user 或者 organization 或者任意相加,比如nICEnnnnnnnLee+ButterAndButterfly
                "output":"data/total.json"           // 保存的路径
            },{
                "type": "get_stars_history",         //获取某项目的star历史图
                "name":"nICEnnnnnnnLee",             // 可以是user 或者 organization
                "repo":"BilibiliDown",               // repo的名字
                "div":7,                             // 可以增大`div`参数来增加取样点
                "output":"data/stars_history.jpg"    // 保存的路径
            },{
                "type": "get_top_star_repos",
                "name":"ButterAndButterfly",         // 可以是user 或者 organization
                "top":3,                             // 获取star数最多的TOP个
                "output":"data/top/ButterAndButterfly/top4.json"
            },{
                "type": "get_top_star_repos",
                "name":"nICEnnnnnnnLee",
                "top":4,
                "output":"data/top/nICEnnnnnnnLee/top4.json"
            },{
                "type": "render_template",  // 根据前面任务获取的数据来渲染模板,请确认模板里面的变量在前文已经生成,否则会报错
                "template_path":"README_template.md",
                "output":"README.md"  // 可以fork后将配置改为README.md,并将项目名改为你的用户名
            }
        ]
    }
    
    1. 图片和数据会周期性地刷新,接下来是怎样访问的问题了。
      • Github raw:
      https://raw.githubusercontent.com/{owner}/{repo}/master/{path}
      举例: https://raw.githubusercontent.com/ButterAndButterfly/GithubTools/master/data/total.json
      然后由img.shields.io生成图片,样式什么的可以自定义
      
      • jsdelivr CDN:
      https://cdn.jsdelivr.net/gh/{owner}/{repo}@master/{path}
      举例: https://cdn.jsdelivr.net/gh/ButterAndButterfly/Q-Gif-ImgBed@master/2020/8/1/nICEnnnnnnnLee-1596288015648.gif
      
好吧,部署到vercel的方法
  • 简介: 提供现成的Serverless实现和配置
  • 步骤:
    1. [可选0-1]fork本项目,vercel上直接根据现有的项目新建
    2. [可选0-2]克隆项目到本地,命令行cd 到目录后直接vercel(需要本地存在vercel环境)
    3. 生成自己的token,权限不必给多(参考)。点击传送门
    4. 在vercel网页端的项目管理里面,设置环境变量
      • 链接:https://vercel.com/{vercel用户名}/{vercel项目名}/settings/environment-variables
      • nameMY_GITHUB_TOKEN
      • value为刚刚生成的token
    5. 相关接口:
    json信息:{domain}/s/{user}
    某项目的star历史图:{domain}/h/{owner}/{repo}`
    
给开发者
  • 有关数据查询的内容主要在core/github.py里面
  • Star历史折线图绘制在core/github_star_history.py里面
伪代码
from core import github, github_star_history

total_dic = github.query_total(user, token)
total_dic: {"stars":123,"forks":456}

top_repos_list = github.query_top(user, token, 3)
top_repos_list: [{
	"name": "BilibiliDown",
	"stargazerCount": 334,
	"forkCount": 51,
	"description": "xxx"
}, {
	"name": "BilibiliLiveRecorder",
	"stargazerCount": 184,
	"forkCount": 34,
	"description": "xxx"
}, {
	"name": "LiveRecorder",
	"stargazerCount": 56,
	"forkCount": 8,
	"description": "xxx"
}]

history_dic = github.query_star_history(user, repo, token, div = 7)
history_dic: {"2020-01-01":1, "2020-01-02":4, "2020-01-03":6, "2020-01-04":9 }
# key - 日期, value - 当天的star数量

jpg_bytes = github_star_history.draw(history_dic)
jpg_bytes: jpg图片的字节数组

LICENSE

MIT

About

目标是创建会刷新的ReadMe首页! 在这里,你可以得到Github star/fork总数图标, 项目star历史曲线,star数最多的前N个Repo信息...

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 93.0%
  • HTML 7.0%