11 releases

new 0.2.6	Jan 12, 2025
0.2.5	Jan 11, 2025
0.1.3	Jan 7, 2025

#286 in Web programming

774 downloads per month

MIT/Apache

80KB
1K SLoC

Homebrew Rust Package

Homebrew 在 Rust 中的封装

安装
使用
info
- --eval-all
services
- list
- info
- stop
- start
- restart
- run
- kill
- cleanup
update
install
- --cask
uninstall
upgrade
reinstall
config

安装

cargo add homebrew

使用

通过 examples 来了解 homebrew-rs 的使用

info

查看软件详情，就像运行 brew info [name] --json=v2

extern crate homebrew as brew;

fn main() {
    let pkg = brew::info("wget").unwrap();
    let json = serde_json::to_string_pretty(&pkg).unwrap();
    println!("package name: {}", pkg.name);
    println!("package is_installed: {}", pkg.is_installed());
    println!("{json}");
}

结果输出

package name: wget
package is_installed: true
{
  "casks": [],
  "formulae": [
    {
      "name": "wget",
      "full_name": "wget",
      "tap": "homebrew/core",
      "oldnames": [],
      "aliases": [],
      "versioned_formulae": [],
      "desc": "Internet file retriever",
      "license": "GPL-3.0-or-later",
      "homepage": "https://www.gnu.org/software/wget/",
      "versions": {
        "stable": "1.25.0",
        "head": "HEAD",
        "bottle": true
      },
      "urls": {
        "stable": {
          "url": "https://ftp.gnu.org/gnu/wget/wget-1.25.0.tar.gz",
          "branch": null,
          "tag": null,
          "revision": null,
          "using": null,
          "checksum": "766e48423e79359ea31e41db9e5c289675947a7fcf2efdcedb726ac9d0da3784"
        },
        "head": {
          "url": "https://git.savannah.gnu.org/git/wget.git",
          "branch": "master",
          "tag": null,
          "revision": null,
          "using": null,
          "checksum": null
        }
      },
      "revision": 0,
      "version_scheme": 0,
      "bottle": {
        "stable": {
          "rebuild": 0,
          "root_url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles",
          "files": {
            "x86_64_linux": {
              "cellar": "/home/linuxbrew/.linuxbrew/Cellar",
              "url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/wget-1.25.0.x86_64_linux.bottle.tar.gz",
              "sha256": "ab5f3c1c60bef4e2a4781e9b29af8afb48ead837136c419edd7febdf44b59058"
            },
            "arm64_sonoma": {
              "cellar": "/opt/homebrew/Cellar",
              "url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/wget-1.25.0.arm64_sonoma.bottle.tar.gz",
              "sha256": "4d180cd4ead91a34e2c2672189fc366b87ae86e6caa3acbf4845b272f57c859a"
            },
            "ventura": {
              "cellar": "/usr/local/Cellar",
              "url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/wget-1.25.0.ventura.bottle.tar.gz",
              "sha256": "78cee523a9b58a7b824b51767935f68c9838e9f673e70d001982858001e766ff"
            },
            "arm64_sequoia": {
              "cellar": "/opt/homebrew/Cellar",
              "url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/wget-1.25.0.arm64_sequoia.bottle.tar.gz",
              "sha256": "a93dd95c5d63036e026b526e000d33fae7fb44d9a8fda5afc89bff112438c6b3"
            },
            "sonoma": {
              "cellar": "/usr/local/Cellar",
              "url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/wget-1.25.0.sonoma.bottle.tar.gz",
              "sha256": "5650778a8e7a60c2dea9412dd21d2f5e8ff4f224dbefbdf54924b99012062edc"
            },
            "arm64_ventura": {
              "cellar": "/opt/homebrew/Cellar",
              "url": "https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/wget-1.25.0.arm64_ventura.bottle.tar.gz",
              "sha256": "7fce09705a52a2aff61c4bdd81b9d2a1a110539718ded2ad45562254ef0f5c22"
            }
          }
        }
      },
      "pour_bottle_only_if": null,
      "keg_only": false,
      "keg_only_reason": null,
      "options": [],
      "build_dependencies": [
        "pkgconf"
      ],
      "dependencies": [
        "libidn2",
        "openssl@3",
        "gettext",
        "libunistring"
      ],
      "test_dependencies": [],
      "recommended_dependencies": [],
      "optional_dependencies": [],
      "uses_from_macos": [
        "zlib"
      ],
      "uses_from_macos_bounds": [
        {
          "since": null
        }
      ],
      "requirements": [],
      "conflicts_with": [],
      "conflicts_with_reasons": [],
      "link_overwrite": [],
      "caveats": null,
      "installed": [
        {
          "version": "1.25.0",
          "used_options": [],
          "built_as_bottle": true,
          "poured_from_bottle": true,
          "time": 1734795904,
          "runtime_dependencies": [
            {
              "full_name": "libunistring",
              "version": "1.3",
              "revision": 0,
              "pkg_version": "1.3",
              "declared_directly": true
            },
            {
              "full_name": "gettext",
              "version": "0.23",
              "revision": 0,
              "pkg_version": "0.23",
              "declared_directly": true
            },
            {
              "full_name": "libidn2",
              "version": "2.3.7",
              "revision": 0,
              "pkg_version": "2.3.7",
              "declared_directly": true
            },
            {
              "full_name": "ca-certificates",
              "version": "2024-11-26",
              "revision": 0,
              "pkg_version": "2024-11-26",
              "declared_directly": false
            },
            {
              "full_name": "openssl@3",
              "version": "3.4.0",
              "revision": 0,
              "pkg_version": "3.4.0",
              "declared_directly": true
            }
          ],
          "installed_as_dependency": false,
          "installed_on_request": true
        }
      ],
      "linked_keg": "1.25.0",
      "pinned": false,
      "outdated": false,
      "deprecated": false,
      "deprecation_date": null,
      "deprecation_reason": null,
      "deprecation_replacement": null,
      "disabled": false,
      "disable_date": null,
      "disable_reason": null,
      "disable_replacement": null,
      "post_install_defined": false,
      "service": null,
      "tap_git_head": "bcbeee8ae56945a92cdebec76da6bfa1cd96d38f",
      "ruby_source_path": "Formula/w/wget.rb",
      "ruby_source_checksum": {
        "sha256": "3dec91401db7bff6591a5065a21859565b8c9588a6baf1b1aa56692775df11ff"
      },
      "head_dependencies": {
        "build_dependencies": [
          "autoconf",
          "automake",
          "xz",
          "pkgconf"
        ],
        "dependencies": [
          "libidn2",
          "openssl@3",
          "gettext",
          "libunistring"
        ],
        "test_dependencies": [],
        "recommended_dependencies": [],
        "optional_dependencies": [],
        "uses_from_macos": [
          "zlib"
        ],
        "uses_from_macos_bounds": [
          {
            "since": null
          }
        ]
      }
    }
  ]
}

--eval-all

获取全部包(包括 formula 和 cask，下载和没下载的)

就像执行 brew info --eval-all --json=v2 命令

extern crate homebrew as brew;

fn main() {
    let pkg = brew::info_all().unwrap();
    let mut formula_count = 0;
    for p in pkg.formulae().iter() {
        if p.is_installed() {
            formula_count += 1;
        }
    }
    println!("Formula package total: {} installed:\t {formula_count}", pkg.formulae().len());

    let mut cask_count = 0;
    for cask in pkg.casks().iter() {
        if cask.is_installed() {
            cask_count += 1;
        }
    }
    println!("Cask package total: {} installed:\t {cask_count}", pkg.casks().len());
}

Formula package total: 7393 installed:   251
Cask package total: 7289 installed:      13

services

list

列出所有服务，就像运行 brew services

use homebrew;

let out = homebrew::services().unwrap();
println!("{out:#?}")

结果输出

[
    Service {
        name: "mongodb-community@7.0",
        status: None,
        user: Some(
            "wxnacy",
        ),
        file: "/Users/wxnacy/Library/LaunchAgents/homebrew.mxcl.mongodb-community@7.0.plist",
        exit_code: None,
    },
    Service {
        name: "mpd",
        status: Started,
        user: Some(
            "wxnacy",
        ),
        file: "/Users/wxnacy/Library/LaunchAgents/homebrew.mxcl.mpd.plist",
        exit_code: Some(
            0,
        ),
    },
    Service {
        name: "postgresql@14",
        status: Started,
        user: Some(
            "wxnacy",
        ),
        file: "/Users/wxnacy/Library/LaunchAgents/homebrew.mxcl.postgresql@14.plist",
        exit_code: Some(
            0,
        ),
    },
    Service {
        name: "redis",
        status: Started,
        user: Some(
            "wxnacy",
        ),
        file: "/Users/wxnacy/Library/LaunchAgents/homebrew.mxcl.redis.plist",
        exit_code: Some(
            0,
        ),
    },
    Service {
        name: "unbound",
        status: None,
        user: None,
        file: "/opt/homebrew/opt/unbound/homebrew.mxcl.unbound.plist",
        exit_code: None,
    },
]

info

查询服务详情，就像运行 brew services info [name] --json

use homebrew;

let out = homebrew::services_info("unbound").unwrap();
println!("{out:#?}")

ServiceInfo {
    name: "unbound",
    service_name: "homebrew.mxcl.unbound",
    running: false,
    loaded: false,
    schedulable: false,
    pid: None,
    exit_code: None,
    user: None,
    status: None,
    file: "/opt/homebrew/opt/unbound/homebrew.mxcl.unbound.plist",
    command: "/opt/homebrew/opt/unbound/sbin/unbound -d -c /opt/homebrew/etc/unbound/unbound.conf",
    working_dir: None,
    root_dir: None,
    log_path: None,
    error_log_path: None,
    interval: None,
    cron: None,
}