base on chsrc 全平台通用换源工具与框架. Change Source everywhere for every software <div align="center"> <img alt="chsrc logo" src="image/chsrc.png"/> </div> 全平台通用换源工具与框架 `chsrc`，**目标支持 Linux, Windows (MSYS2, Cygwin), macOS, BSD 等尽可能多的操作系统环境，龙芯、飞腾、RISC-V 等尽可能多的 CPU**。 我们使用 **C99** 来完成上述目标。我们并不使用 Python 或 JS 等解释语言，因为一个简单的换源工具，不应该强行塞给用户一个庞大的解释器和数十、数百 MB 其他文件。 本软件为**自由软件**，SDPX 软件许可证为 `GPL-3.0-or-later and MIT` <br> <table align="center"> <tr> <td> <a href="https://trendshift.io/repositories/10744" target="_blank"><img src="https://trendshift.io/api/badge/repositories/10744" alt="RubyMetric%2Fchsrc | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </td> <td> <a href="https://hellogithub.com/repository/7666ba91e01e4a59be5809b02d9e8ff6" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=7666ba91e01e4a59be5809b02d9e8ff6&claim_uid=H6YVMUy7ulev8R4&theme=dark" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a> </td> </tr> </table> <br> ## 🤝 协作与贡献 > [!TIP] > **`chsrc` 不仅是一个命令行工具，同时也是一个体现了 Ruby on Rails 思想的 MVC 换源框架，它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。** [Write A Recipe Even If You Don't Know C](./doc/02-Write-A-Recipe-Even-If-You-Dont-Know-C.md) > [!NOTE] > **`chsrc` 可换源 60+ 目标。每个人仅仅贡献和维护自己熟悉的部分，回报是得到其他所有领域专家的帮助**。欢迎对 GitHub、Gitee 协作不熟悉的人以此为契机学习参与贡献, 欢迎任何编程初学者参与贡献。[从开发到提交贡献，我们覆盖全流程文档](./doc/) ，另外作者可提供一定的 [贡献指导](https://github.com/RubyMetric/chsrc/discussions/50) > [!IMPORTANT] > [招募 recipe 维护者](https://github.com/RubyMetric/chsrc/issues/130) <br> 可参与的任务与挑战： 1. [提供默认源地址，如Maven等的默认源URL，帮助我们进行 `chsrc reset`](https://github.com/RubyMetric/chsrc/issues/111) 2. [CentOS (Stream) Recipe](https://github.com/RubyMetric/chsrc/issues/48) <br> <details> <summary>已由贡献者完成的挑战</summary> 1. [[Challenge] 编写统一安装的 shell 和 PowerShell 脚本](https://github.com/RubyMetric/chsrc/issues/98) 已由 [@Efterklang] 与 [@wickdynex] 完成 </details> <details> <summary>镜像站可用性</summary> 1. https://github.com/RubyMetric/chsrc/wiki 2. https://github.com/RubyMetric/chsrc/discussions </details> <details> <summary>打包</summary> 想通过 `flatpak`,`snap`,`pacman`,`apt`,`dnf` 等系统包管理工具来安装和更新`chsrc`？若您可提供维护，请访问 [issue#16 on GitHub](https://github.com/RubyMetric/chsrc/issues/16) - [x] `Homebrew` - [x] `Scoop` - [x] `WinGet` - [x] `AUR` - [ ] `Flatpak` - [ ] `snap` - [ ] 缺乏其他平台/包维护者 </details> <br> ## 📌 示例 <div align="center"> <img alt="chsrc set node" src="image/example-set-nodejs.png"/> </div> <br> ## 🚀 安装 <a href="https://repology.org/project/chsrc/versions"> <img src="https://repology.org/badge/vertical-allrepos/chsrc.svg" alt="Packaging status" align="right"> </a> > [!IMPORTANT] > 若通过下述手动方式安装，则会下载到当前目录，可直接通过 `./chsrc` 运行 <details> <summary>Windows</summary> - 可通过 `scoop` 安装，感谢 [@Gn3po4g] 与 [@niheaven] ```bash $ scoop install chsrc ``` <br> - 可通过 `WinGet` 安装，感谢 [@YU-7] ```bash $ winget install RubyMetric.chsrc ``` <br> - 可通过 `PowerShell` 脚本一键下载最新版二进制文件，感谢 [@wickdynex] 若下方链接无法访问，可使用 `https://gitee.com/RubyMetric/chsrc/raw/main/tool/installer.ps1` 替代 ```PowerShell "& { $(iwr -useb https://chsrc.run/windows) } -Version pre" | iex ``` <br> - 或手动下载二进制文件，这是最新版，往往比 `scoop` 提供的更新，适用于修复 Bug、添加新功能后及时使用，以及未安装 `scoop` 时 ```bash # 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> - 支持 `AUR`，可通过 `yay` 安装，感谢 [@Jerry-Terrasse] ```bash # AUR $ yay -S chsrc-bin # Binary from GitHub Release $ yay -S chsrc-git # Build from the latest main branch (stable) $ yay -S chsrc # Build from GitHub Release ``` <br> - 可通过 `shell` 脚本一键安装最新版，感谢 [@Efterklang] 与 [@wickdynex] 若下方链接无法访问，可使用 `https://gitee.com/RubyMetric/chsrc/raw/main/tool/installer.sh` 替代 ```bash # 非root用户默认安装至 ~/.local/bin $ curl https://chsrc.run/posix | bash # root用户默认安装至 /usr/local/bin $ curl https://chsrc.run/posix | sudo bash # 使用 -d 指定目录安装 $ curl https://chsrc.run/posix | bash -s -- -d ./ # 使用 -l en 输出英文 $ curl https://chsrc.run/posix | bash -s -- -l en ``` <br> - 可手动下载二进制文件安装 ```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] ```bash $ brew install chsrc ``` <br> - 可通过 `shell` 脚本安装最新版，感谢 [@Efterklang] 与 [@wickdynex] 若下方链接无法访问，可使用 `https://gitee.com/RubyMetric/chsrc/raw/main/tool/installer.sh` 替代 ```bash # 非root用户默认安装至 ~/.local/bin $ curl https://chsrc.run/posix | bash # root用户默认安装至 /usr/local/bin $ curl https://chsrc.run/posix | sudo bash # 使用 -d 指定目录安装 $ curl https://chsrc.run/posix | bash -s -- -d ./ # 使用 -l en 输出英文 $ curl https://chsrc.run/posix | bash -s -- -l en ``` <br> - 或手动下载二进制文件，这是最新版，往往比 `homebrew` 提供的更新，适用于修复 Bug、添加新功能后及时使用 ```bash # arm64/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> ```bash $ git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc $ clang -Iinclude -Ilib src/chsrc-main.c -o chsrc ``` </details> <details> <summary>其他平台</summary> ```bash $ git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc; make ``` </details> <br> ## 💡 使用 ```bash 使用: chsrc <command> [options] [target] [mirror] help # 打印此帮助，或 h, -h, --help issue # 查看相关issue list (或 ls, 或 l) # 列出可用镜像源，和可换源目标 list mirror/target # 列出可用镜像源，或可换源目标 list os/lang/ware # 列出可换源的操作系统/编程语言/软件 measure <target> # 对该目标所有源测速 cesu <target> list <target> # 查看该目标可用源与支持功能 get <target> # 查看该目标当前源的使用情况 set <target> # 换源，自动测速后挑选最快源 set <target> first # 换源，使用维护团队测速第一的源 set <target> <mirror> # 换源，指定使用某镜像站 (通过list命令查看) set <target> https://url # 换源，用户自定义源URL reset <target> # 重置，使用上游默认使用的源 选项: -dry # Dry Run，模拟换源过程，命令仅打印并不运行 -local # 仅对某项目而非全局换源 (仅部分软件如bundler,pdm支持) -ipv6 # 使用IPv6测速 -en(glish) # 使用英文输出 -no-color # 无颜色输出 ``` <br> ```bash 自动测速，寻找最快者，换源 $ chsrc set ruby 不想自动测速的时候，可使用维护团队测试的最快镜像站 $ chsrc set ruby first 先列出可用的镜像站，然后选择其一，如使用 RubyChina 作为镜像站 $ chsrc ls ruby $ chsrc set ruby rubychina 若您有自己的镜像地址，使用自定义URL $ chsrc set ruby https://gems.ruby-china.com/ 对支持 *项目级* 换源的目标，可以避免全局（*系统级* 或 *用户级*）换源 $ chsrc set -local bundler $ chsrc set -local pdm ``` <br> ## 编程语言开发 ```bash chsrc set ruby|rb|gem|bundler|rubygems chsrc set python | py | pypi # 同时换 pip, poetry, pdm, uv 这4个包管理器，也可以4个独立换源 chsrc set pip chsrc set poetry chsrc set pdm chsrc set uv chsrc set rye chsrc set node | nodejs # 同时换 npm, yarn 和 pnpm 这3个包管理器，也可以3个独立换源 chsrc set npm chsrc set yarn chsrc set pnpm chsrc set nvm chsrc set bun chsrc set perl | cpan chsrc set php | composer chsrc set lua | luarocks chsrc set rust | cargo | crate chsrc set rustup chsrc set go chsrc set java | maven | mvn | gradle chsrc set clojure | clojars chsrc set dart | pub chsrc set flutter chsrc set haskell | hackage | cabal | stack chsrc set ocaml | opam # 同时会为 bioconductor 换源 chsrc set r | cran chsrc set julia ``` <br> ## 操作系统 ```bash 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> ## 软件 ```bash 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> ## 📝 许可证 - `chsrc` 主程序采用 `GPL-3.0-or-later` 许可证，保证该软件的永久自由 - `xy.h` 使用 `MIT` 许可证，保证该库可以在尽可能多的情况下复用 <br> ## ❤️ 致谢 感谢各个镜像站提供的优质免费镜像服务 1. [mirror.c](./src/framework/mirror.c) 包含了通用的镜像站信息 2. 各个recipe内部定义的专用镜像站 另外特别感谢以下组织或项目: 1. [MirrorZ 教育网镜像站](https://help.mirrors.cernet.edu.cn/) 2. [清华大学 Tuna](https://mirrors.tuna.tsinghua.edu.cn/) 3. [上海交通大学软件源镜像服务](https://mirrors.sjtug.sjtu.edu.cn/) 4. [中国科学技术大学 Linux 用户协会](https://github.com/ustclug) 5. [Thanks Mirror 项目](https://github.com/eryajf/Thanks-Mirror) by [@eryajf](https://github.com/eryajf) <br> ## 🚀 赞赏支持 你是否因为使用 `chsrc` 而节省了时间和精力 or whatever? <img src="https://raw.githubusercontent.com/ccmywish/support-my-oss-work/main/wechat.png" alt="wechat-reward" style="width:300px;"/> <br> [@Aaron-212]: https://github.com/Aaron-212 [@chenrui333]: https://github.com/chenrui333 [@niheaven]: https://github.com/niheaven [@Gn3po4g]: https://github.com/Gn3po4g [@Jerry-Terrasse]: https://github.com/Jerry-Terrasse [@ccmywish]: https://github.com/ccmywish [@Efterklang]: https://github.com/Efterklang [@wickdynex]: https://github.com/wickdynex [@YU-7]: https://github.com/YU-7 [issue#98 on GitHub]: https://github.com/RubyMetric/chsrc/issues/98 ", Assign "at most 3 tags" to the expected json: {"id":"10744","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"