Skip to content

Latest commit

 

History

History
137 lines (95 loc) · 4.95 KB

README.md

File metadata and controls

137 lines (95 loc) · 4.95 KB
Raw

ReleaseButler

GPL v2 license

当前项目仍在开发阶段，所以软件会输出很多不必要信息(现在添加了 verbose 这个 option)

ReleaseButler 旨在简化Linux系统上的 Github 上的软件安装过程🤗。 它可以自动检测底层 Linux 发行版，从指定的 GitHub 项目主页获取对应的软件包并安装，同时也支持更新操作。

目前我是想要实现一个类似 BSD 系“类 ports 系统”那样的东西，就像 Arch Linux 的 ABS，或者像是 Gentoo Linux 的 protage。目前想要的甚至还没 ABS 那么复杂，Gentoo Linux 那样标记 USE 变量更是想都没想了。

TODO:

  • 使用JSON格式存储软件包的信息
  • 使用build字段存储一些在install之后执行的工作
  • 使用install字段存储一些install之前的准备工作
  • 我想要实现成如果不提供软件包的名字的话就默认直接clone仓库，准备开始编译它
  • 想要在 GitHub 创建一个仓库存储软件包安装的json文件，这样用户可以直接 import 之后安装
  • 目前使用的是 sudo 安装软件，没做对当前软件的用户权限是否是非 root 用户，并且也没做对 sudo 的检测(准备实现成如果没有sudo就检测是否存在doas)
  • 我想实现成支持很多软件(源码)分发平台，但目前就只是做了对 GitHub 的处理

⚠️: 你必须首先安装sudo而不是open-doas或是其他类似的软件，如果你不想强依赖于sudo可以选择修改源代码😀。或者我后续想起来会尝试添加对sudo或doas的检测。 我已经添加了对 /usr/bin/sudo 和 /usr/bin/doas 的检测。

Note

我这里假设了 sudo 和 doas 会存在于 /usr/bin 目录下

特点:

自动发行版检测： ReleaseButler 确定运行环境的Linux发行版，确保与各种系统的兼容性。

安装和更新：使用单个命令轻松安装软件包。 ReleaseButler 支持更新，使您安装的软件保持最新。

尽量适配各种情况: 尝试引入各种字段以适配各种仓库的安装步骤。

使用方法

安装软件:

$ releasebutler install --package <name> --pakname <package name> --from <url> [--verbose]

--package 字段接受的是要安装的软件的名称，而 packname 字段是这个软件包名，例如 fastfetch-linux-amd64.deb 就是 packname

从命令行安装尚未支持所有字段(如install，build等)。

更新

$ relesebutler --update

解析外部引入的json文件

$ relesebutler --parse <file name>

note: 这个文件需要在 ~/.config/ReleaseButler/ 目录中

Note

ReleaseButler 现在还不支持指定软件包的单独更新。🙃

使用命令行安装的软件是记录在 ~/.config/ReleaseButler/info.json，但是在更新的时候实际上会遍历 ~/.config/ReleaseButler/ 目录下的所有json文件。

我尝试通过这种方式支持引入其他地方来的json文件。但文件名不能叫 package.json，这个文件用来记录已安装软件包的版本，遍历到了这个json文件也会跳过。

调试模式

你可以附加 --verbose 得到更多的调试信息输出

$ relesebutler --verbose

软件包信息文件的字段定义:

{
   "fastfetch": {
      "pakname": "fastfetch-linux-amd64.deb",
      "url": "https://github.com/fastfetch-cli/fastfetch",
      "version": "2.13.2",
      "build" : [
         "touch something",
         "touch haaa"
      ],
      "install" : [
         "echo something > something"
      ],
      "clone": false,
      "download" : false
   }
}
  • pakname 是 Release 页面的软件包名称。
  • build 用于存储一些软件下载前的要执行操作。
  • install 用于存储一些软件安装后要执行的操作。
  • clone 表示是否直接 clone 这个仓库。
  • download 表示是否只是单纯在从Release下载了软件包，而不是下载了之后调用系统软件包管理器安装它。

支持的Linux发行版

  • Debian/Ubuntu/Deepin
  • Fedora

如何编译

如果你在 Debian 发行版下编译该项目:

$ sudo apt install libcurl4-openssl-dev clang cmake
$ git clone https://github.com/suoyuan666/ReleaseButler.git
$ cd ReleaseButler
$ git submodule update --init --recursive
$ cmake -B build -DCMAKE_BUILD_TYPE=Release
$ cmake --build build -j `nproc`

如果是在其他平台下编译，原谅我懒了，自己去寻找 libcurl4-openssl-dev 这个包对应其他发型版的软件包名吧。😛

我尝试在 OpenSUSE Tumbleweed 中编译这个项目，我是用了下边的语句安装了所需的软件

$ sudo zypper install libcurl-devel clang18 llvm18-gold cmake