全平台命令行换源工具，目标支持尽可能多的操作系统，包括Linux、Windows、macOS、BSD等，以及尽可能多的CPU架构，如龙芯、飞腾、RISC-V等。

我们使用C99来实现上述目标。我们不使用Python或JS等解释型语言，因为一个简单的换源工具不应该强制用户安装一个庞大的解释器和数十、数百MB的其他文件。

本软件为自由软件，SPDX软件许可证为GPL-3.0-or-later and MIT

<br>

🤝 贡献

[!TIP] chsrc不仅是一个命令行工具，同时也是一个换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。

立即为一个新软件添加换源方法！即使不懂C也能编写Recipe

案例：Armbian
挑战：CentOS (Stream) Recipe 挑战！

开发准则：

约定优于配置
NO UFO 原则：不要乱丢文件到$HOME等目录，尤其是使用各种隐晦的文件名

[!NOTE] 想通过flatpak、yay、pacman、apt、dnf等系统包管理工具来安装和更新chsrc？如果您可以提供维护，请访问GitHub上的issue#16

<br>

📌 示例

🚀 安装

[!IMPORTANT] 如果通过以下手动方式安装，将会下载到当前目录，可以直接通过./chsrc运行

<details> <summary>Windows</summary>

可以通过scoop安装，感谢@Gn3po4g和@niheaven

$ scoop install chsrc

或者手动下载二进制文件，这是最新版，通常比scoop提供的更新，适用于修复Bug、添加新功能后及时使用，以及未安装scoop的情况

# x64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-windows.exe -o chsrc.exe

x86

curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x86-windows.exe -o chsrc.exe

</details>

<details>
<summary>Linux</summary>

```bash
# x64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-linux -o chsrc; chmod +x ./chsrc

# aarch64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-aarch64-linux -o chsrc; chmod +x ./chsrc

# riscv64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-riscv64-linux -o chsrc; chmod +x ./chsrc

# armv7
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-armv7-linux -o chsrc; chmod +x ./chsrc

</details> <details> <summary>macOS</summary>

可通过 homebrew 安装，感谢 @Aaron-212 和 @chenrui333

$ brew install chsrc

或手动下载二进制文件，这是最新版，往往比 homebrew 提供的更新，适用于修复 Bug、添加新功能后及时使用

# arm/aarch64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-aarch64-macos -o chsrc; chmod +x ./chsrc

# x64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-macos -o chsrc; chmod +x ./chsrc

</details> <details> <summary>BSD</summary>

git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc
clang -Iinclude src/chsrc.c -o chsrc

</details> <details> <summary>其他平台</summary>

git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc; make

</details> <br>

💡 使用

用法: chsrc <命令> [选项] [目标] [镜像]

help                      # 打印此帮助，或 h, -h, --help
issue                     # 查看相关问题

list (或 ls, 或 l)        # 列出可用镜像源和可换源目标
list mirror/target        # 列出可用镜像源或可换源目标
list os/lang/ware         # 列出可换源的操作系统/编程语言/软件

measure <目标>            # 对该目标所有源测速
cesu    <目标>

list <目标>               # 查看该目标可用源与支持功能
get  <目标>               # 查看该目标当前源的使用情况

set  <目标>               # 换源，自动测速后选择最快源
set  <目标>  first        # 换源，使用维护团队测速第一的源
set  <目标> <镜像>        # 换源，指定使用某镜像站（通过list命令查看）
set  <目标> https://url   # 换源，用户自定义源URL
reset <目标>              # 重置，使用上游默认使用的源

选项:
-dry                      # 模拟运行，模拟换源过程，命令仅打印不执行
-ipv6                     # 使用IPv6测速
-local                    # 仅对某项目而非全局换源（仅部分软件如bundler,pdm支持）

当你不想自动测速时，你可以直接指定某镜像站、源URL，以及指定维护团队已测试的最快镜像站。

chsrc set ruby           # 测速，选择最快的源，并切换
# 或
chsrc ls ruby            # 列出可用的镜像站
chsrc set ruby rubychina # 使用 RubyChina 作为镜像站
# 或者如果您有自己的镜像地址
chsrc set ruby https://gems.ruby-china.com/ # 使用自定义URL
# 或
chsrc set ruby first     # 使用维护团队测试的最快镜像站

对于支持项目级换源的目标，可以避免全局（系统级或用户级）换源。

chsrc set -local bundler
chsrc set -local pdm

<br>

编程语言开发

chsrc set ruby    或 gem
chsrc set python  或 pip / poetry / pdm # 同时更换pip、poetry和pdm这3个
chsrc set node    或 npm / nodejs / yarn / pnpm # 同时更换npm、yarn和pnpm这3个
chsrc set perl    或 cpan
chsrc set php     或 composer
chsrc set lua     或 luarocks

chsrc set go
chsrc set rust    或 cargo / crate
chsrc set java    或 maven / mvn / gradle
chsrc set clojure 或 clojars
chsrc set dart    或 pub / flutter # 同时会为flutter换源
chsrc set haskell 或 hackage/cabal/stack
chsrc set ocaml   或 opam

# 同时会为 bioconductor 换源
chsrc set r       或 cran
chsrc set julia

<br>

操作系统

sudo chsrc set ubuntu
sudo chsrc set linuxmint 或 mint
sudo chsrc set debian
sudo chsrc set fedora
sudo chsrc set suse  或 opensuse
sudo chsrc set kali
sudo chsrc set arch
sudo chsrc set archlinuxcn
sudo chsrc set manjaro
sudo chsrc set gentoo
sudo chsrc set rocky 或 rockylinux
sudo chsrc set alma  或 almalinux
sudo chsrc set alpine
sudo chsrc set void  或 voidlinux
sudo chsrc set solus
sudo chsrc set ros   或 ros2
sudo chsrc set trisquel
sudo chsrc set lite  或 linuxlite
sudo chsrc set raspi 或 raspberrypi
sudo chsrc set armbian
sudo chsrc set openwrt

sudo chsrc set openeuler
sudo chsrc set openanolis 或 anolis
sudo chsrc set openkylin
sudo chsrc set deepin

chsrc set msys2 或 msys

# BSD
sudo chsrc set freebsd
sudo chsrc set openbsd
sudo chsrc set netbsd

<br>

软件

chsrc set winget
chsrc set brew      或 homebrew
chsrc set cocoapods 或 cocoa / pod
chsrc set dockerhub 或 docker
chsrc set flathub   或 flatpak
chsrc set nix
chsrc set guix
chsrc set emacs  或 elpa
chsrc set tex    或 ctan / latex / texlive / miktex
chsrc set conda  或 anaconda

<br>

🛠️ 开发

请确保已安装 gcc或clang 以及 make 和 curl

# 使用 dev 分支进行开发
git clone https://gitee.com/RubyMetric/chsrc.git -b dev

make          # 默认使用 cc 编译
make CC=clang # 使用 clang 编译
make CC=gcc   # 使用 gcc   编译

make test    # 运行测试命令
make test-xy # 测试 xy.h
make clean