Hok logo

Hok Chawye Hsu

Use this command to install Hok:
winget install --id=ChawyeHsu.Hok -e

A CLI implementation of Scoop in Rust

Hok is a command-line tool designed to manage software installations on Windows efficiently. Built in Rust as a reimplementation of Scoop, Hok offers a modern alternative with improved performance and reliability.

Key Features:

  • Fast and efficient package management powered by Rust.
  • Compatibility with existing Scoop commands for seamless integration into workflows.
  • Enhanced performance through optimized code execution.
  • Support for core operations like installing, updating, and managing packages.

Audience & Benefit:
Ideal for developers, system administrators, and users familiar with Scoop who seek a faster and more reliable tool for package management on Windows. Hok provides an efficient way to manage software installations while maintaining compatibility with existing workflows. It can be installed via winget, ensuring easy access for users seeking performance improvements in their software management tasks.

README

hok

> Hok is a CLI implementation of Scoop in Rust

cicd release crates-svg license downloads docs-svg

简体中文

Install

🚧 CAVEAT: Under heavy development, interfaces may change without notice.

Assuming you have the original Scoop installed, simply run:

scoop bucket add dorado https://github.com/chawyehsu/dorado
scoop install dorado/hok

Note this will add the dorado bucket I maintain to install Hok. Hok is experimental and it's currently only available in that bucket.

Commands

The command line interface is similar to Scoop.

$ hok help
Hok is a CLI implementation of Scoop in Rust

Usage: hok.exe 

Commands:
  bucket     Manage manifest buckets
  cache      Package cache management
  cat        Inspect the manifest of a package
  cleanup    Cleanup apps by removing old versions
  config     Configuration management
  hold       Hold package(s) to disable changes
  home       Browse the homepage of a package
  info       Show package(s) basic information
  install    Install package(s)
  list       List installed package(s)
  search     Search available package(s)
  unhold     Unhold package(s) to enable changes
  uninstall  Uninstall package(s)
  update     Fetch and update subscribed buckets
  upgrade    Upgrade installed package(s)
  help       Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Type 'hok help ' to get help for a specific command.

Development

Prerequisites: Git, Rust

# clone the repo
git clone https://github.com/chawyehsu/hok
cd hok
# build
cargo build
# run and test
cargo run -- help

Performance

Hok (also the libscoop backend) aims to provide a faster yet powerful alternative to the original Scoop. Here are some random benchmarks captured in the Windows Sandbox environment on my PC (AMD Ryzen 5 2600, 32G RAM, Windows 10).

# versions:
hok/dorado 0.1.0-beta.6
scoop-search/main 1.5.0
sfsu/extras 1.14.0
# Benchmarking scoop bucket list
Benchmark 1: scoop bucket list
  Time (mean ± σ):      5.610 s ±  0.627 s    [User: 6.573 s, System: 3.520 s]
  Range (min … max):    4.784 s …  7.063 s    10 runs

Benchmark 2: hok bucket list
  Time (mean ± σ):     159.4 ms ±  28.3 ms    [User: 86.4 ms, System: 175.2 ms]
  Range (min … max):   140.0 ms … 252.1 ms    18 runs

Summary
  hok bucket list ran
   35.19 ± 7.38 times faster than scoop bucket list
# Benchmarking scoop list
Benchmark 1: scoop list
  Time (mean ± σ):      3.577 s ±  0.043 s    [User: 4.919 s, System: 2.142 s]
  Range (min … max):    3.524 s …  3.678 s    10 runs

Benchmark 2: sfsu list
  Time (mean ± σ):      58.3 ms ±  30.8 ms    [User: 18.8 ms, System: 44.2 ms]
  Range (min … max):    39.1 ms … 234.1 ms    50 runs

Benchmark 3: hok list
  Time (mean ± σ):      48.7 ms ±  53.2 ms    [User: 13.4 ms, System: 41.7 ms]
  Range (min … max):    31.8 ms … 412.4 ms    62 runs

Summary
  hok list ran
    1.20 ± 1.45 times faster than sfsu list
   73.39 ± 80.11 times faster than scoop list
# Benchmarking scoop search (sqlite_cache enabled)
Benchmark 1: scoop search google
  Time (mean ± σ):      3.771 s ±  0.031 s    [User: 5.134 s, System: 2.085 s]
  Range (min … max):    3.725 s …  3.830 s    10 runs

Benchmark 2: scoop-search google
  Time (mean ± σ):     178.5 ms ±  14.2 ms    [User: 210.8 ms, System: 850.4 ms]
  Range (min … max):   149.4 ms … 206.8 ms    17 runs

Benchmark 3: sfsu search google
  Time (mean ± σ):      73.7 ms ±  30.1 ms    [User: 49.3 ms, System: 85.0 ms]
  Range (min … max):    52.6 ms … 202.3 ms    36 runs

Benchmark 4: hok search google
  Time (mean ± σ):      73.0 ms ±  10.2 ms    [User: 44.9 ms, System: 93.4 ms]
  Range (min … max):    63.0 ms … 109.3 ms    25 runs

Summary
  hok search google ran
    1.01 ± 0.44 times faster than sfsu search google
    2.44 ± 0.39 times faster than scoop-search google
   51.63 ± 7.25 times faster than scoop search google

You may run the benchmarks yourself using provided benchmark scripts in the scripts directory. Results may vary on different environments, feel free to share yours to help us improve the project.

License

hok © Chawye Hsu. Released under the Apache-2.0 license. For licenses of sub crates, see COPYING.

> Blog · GitHub @chawyehsu · Twitter @chawyehsu

Versions
0.1.0-beta.7
0.1.0-beta.6
0.1.0-beta.5
0.1.0-beta.4
0.1.0-beta.3
Website
License