chsrc
不仅是一个命令行工具,同时也是一个换源框架,它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。
我鼓励你为新的软件添加换源支持,因为通过 chsrc
这将非常简单,你的贡献也将非常有价值。理论上每一个 recipe
都需要有专人长时间维护。
-
本项目采用
GPLv3+
协议,是真正的自由软件,而非仅仅是开源软件 -
代码规范灵活遵循
GNU
标准(若标准干扰了可维护性,则并不采纳) -
高度模块化,目录结构清晰易懂
-
极小依赖,极易构建,只需要
GCC
或Clang
即可编译 -
易于将
shell
脚本转换为等价的recipe
-
已有大量
recipe
可提供参考,并提供了 recipe template 供直接使用 -
提供持续关注镜像站可用性的协作平台:
成功案例:
若有任何问题,可在 GitHub discussions 中询问和讨论
-
target
: 所要换源的目标 -
category
: 是target category
的简写,即target
所属的类别,可以是 编程语言,操作系统,软件 三类之一- 在目录中,三者分别为
lang
,os
,ware
- 在代码中,三者前缀分别为
pl
,os
,wr
- 在目录中,三者分别为
-
mirror
: 是mirror site
的简写,指镜像站,如清华大学开源软件镜像站 -
source
: 该target
所能换的具体的源,由mirror
提供服务,往往一个mirror
会提供许多source
-
recipe
: 是为一个target
定义的具体换源方法,请参考src
目录中的recipe
目录 -
feature
: 一个target
可以支持的功能,比如能否重置回上游默认源等 -
镜像源: 为了方便,偶尔我们将直接称
mirror
和/或source
为镜像源,这只是一种方便性的称呼,可以统称二者,也可以根据上下文指代二者之一
-
务必使用
dev
分支 -
在
recipe
目录中根据类别添加新文件,该文件可基于其它recipe
或 recipe template -
最好的参照物是 ruby.c recipe
-
在各大镜像站寻找可用源;可以额外补充镜像站
并创建或更新对应
target
的镜像站可用状态Wiki页: https://github.com/RubyMetric/chsrc/wiki -
可以使用这些函数:
framework/core.c
中以chsrc_
开头的所有函数或宏xy.h
中以xy_
开头的所有函数或宏
-
在
recipe/menu.c
中添加用户可以使用的target
别名 -
构建并运行
chsrc set <target>
测试,若无问题可提交 Pull Request
-
代码高度可移植
-
Convention over Configuration
-
NO UFO 原则: 不要乱丢文件到$HOME等目录,尤其是使用各种隐晦的文件名
chsrc
主程序不提供配置文件,不提供数据文件,干净无污染。那么在实现recipe
的时候,除了备份文件外,也不要污染用户环境。