From 98d07868ccb346e111fdcf1f1af29cbd2dc27a30 Mon Sep 17 00:00:00 2001 From: sharkdp Date: Fri, 2 Nov 2018 17:33:31 +0100 Subject: Rename to `diskus` closes #9 --- .travis.yml | 2 +- Cargo.lock | 2 +- Cargo.toml | 10 +++------- README.md | 28 ++++++++++++++-------------- 4 files changed, 19 insertions(+), 23 deletions(-) diff --git a/.travis.yml b/.travis.yml index 02b9931..1c0812a 100644 --- a/.travis.yml +++ b/.travis.yml @@ -30,7 +30,7 @@ env: # Used as conditional check in the install stage - HOST=x86_64-unknown-linux-gnu # Used on the deployment script - - PROJECT_NAME=dup + - PROJECT_NAME=diskus install: # prevent target re-add error from rustup diff --git a/Cargo.lock b/Cargo.lock index 9278679..fd43e13 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -96,7 +96,7 @@ version = "0.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" [[package]] -name = "du-dup" +name = "diskus" version = "0.2.0" dependencies = [ "clap 2.32.0 (registry+https://github.com/rust-lang/crates.io-index)", diff --git a/Cargo.toml b/Cargo.toml index d27f75f..8f76030 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -2,17 +2,13 @@ authors = ["David Peter "] categories = ["command-line-utilities"] description = "A minimal, fast alternative to 'du -sh'." -homepage = "https://github.com/sharkdp/dup" +homepage = "https://github.com/sharkdp/diskus" license = "MIT/Apache-2.0" -name = "du-dup" +name = "diskus" readme = "README.md" -repository = "https://github.com/sharkdp/dup" +repository = "https://github.com/sharkdp/diskus" version = "0.2.0" -[[bin]] -name = "dup" -path = "src/main.rs" - [dependencies] ignore = "0.4.3" num_cpus = "1.0" diff --git a/README.md b/README.md index 1f33857..2556c0c 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,15 @@ -# dup +# diskus -[![Build Status](https://travis-ci.org/sharkdp/dup.svg?branch=master)](https://travis-ci.org/sharkdp/dup) +[![Build Status](https://travis-ci.org/sharkdp/diskus.svg?branch=master)](https://travis-ci.org/sharkdp/diskus) *A minimal, fast alternative to `du -sh`.* -`dup` is a very simple program that computes the total size of the current directory. It is a +`diskus` is a very simple program that computes the total size of the current directory. It is a parallelized version of `du -sh`. On my 8-core laptop, it is about nine times faster than `du` for a cold disk cache and more than twice as fast on a warm disk cache. ``` bash -> dup +> diskus 14.56 GB (14556806983 bytes) ``` @@ -19,9 +19,9 @@ The following benchmarks have been performed with [hyperfine](https://github.com a moderately large folder (15GB, 100k directories, 400k files). Smaller folders are not really of any interest since all programs would finish in a reasonable time that would not interrupt your workflow. -In addition to `du` and `dup`, we also add [tin-summer](https://github.com/vmchale/tin-summer) (`sn`) and +In addition to `du` and `diskus`, we also add [tin-summer](https://github.com/vmchale/tin-summer) (`sn`) and [`dust`](https://github.com/bootandy/dust) in our comparison. Both are also written in Rust and provide -much more features than `dup` (check them out!). The optimal number of threads for `sn` (`-j` option) was +much more features than `diskus` (check them out!). The optimal number of threads for `sn` (`-j` option) was determined via `hyperfine --parameter-scan`. ### Cold disk cache @@ -29,14 +29,14 @@ determined via `hyperfine --parameter-scan`. ```bash sudo -v hyperfine --prepare 'sync; echo 3 | sudo tee /proc/sys/vm/drop_caches' \ - 'dup' 'sn p -d0 -j8' 'du -sb' 'dust -d0' + 'diskus' 'sn p -d0 -j8' 'du -sb' 'dust -d0' ``` (the `sudo`/`sync`/`drop_caches` commands are a way to [clear the filesystem caches between benchmarking runs](https://github.com/sharkdp/hyperfine#io-heavy-programs)) | Command | Mean [s] | Min…Max [s] | |:---|---:|---:| -| `dup` | 1.729 ± 0.012 | 1.717…1.756 | +| `diskus` | 1.729 ± 0.012 | 1.717…1.756 | | `sn p -d0 -j8` | 9.778 ± 0.098 | 9.587…9.904 | | `du -sb` | 16.016 ± 0.067 | 15.923…16.147 | | `dust -d0` | 19.845 ± 0.466 | 19.428…20.948 | @@ -45,12 +45,12 @@ hyperfine --prepare 'sync; echo 3 | sudo tee /proc/sys/vm/drop_caches' \ On a warm disk cache, the differences are smaller: ```bash -hyperfine --warmup 5 'dup' 'sn p -d0 -j8' 'du -sb' 'dust -d0' +hyperfine --warmup 5 'diskus' 'sn p -d0 -j8' 'du -sb' 'dust -d0' ``` | Command | Mean [ms] | Min…Max [ms] | |:---|---:|---:| -| `dup` | 465.9 ± 14.7 | 446.5…487.4 | +| `diskus` | 465.9 ± 14.7 | 446.5…487.4 | | `sn p -d0 -j8` | 596.4 ± 12.2 | 579.2…615.9 | | `du -sb` | 1100.3 ± 20.5 | 1086.9…1153.0 | | `dust -d0` | 3560.1 ± 27.8 | 3521.7…3612.8 | @@ -60,16 +60,16 @@ hyperfine --warmup 5 'dup' 'sn p -d0 -j8' 'du -sb' 'dust -d0' ### On Debian-based systems ``` bash -wget "https://github.com/sharkdp/dup/releases/download/v0.2.0/dup_0.2.0_amd64.deb" -sudo dpkg -i dup_0.2.0_amd64.deb +wget "https://github.com/sharkdp/diskus/releases/download/v0.2.0/diskus_0.2.0_amd64.deb" +sudo dpkg -i diskus_0.2.0_amd64.deb ``` ### On other distrubutions -Check out the [release page](https://github.com/sharkdp/dup/releases) for binary builds. +Check out the [release page](https://github.com/sharkdp/diskus/releases) for binary builds. ### Via cargo ``` -cargo install du-dup +cargo install diskus ``` -- cgit v1.2.3