A modern replacement for ‘ls’.
Go to file
Ben S 4e49b91d23 Parallelise the details view!
This commit removes the threadpool in `main.rs` that stats each command-line argument separately, and replaces it with a *scoped* threadpool in `options/details.rs` that builds the table in parallel! Running this on my machine halves the execution time when tree-ing my entire home directory (which isn't exactly a common occurrence, but it's the only way to give exa a large running time)

The statting will be added back in parallel at a later stage. This was facilitated by the previous changes to recursion that made it easier to deal with.

There's a lot of large sweeping architectural changes. Here's a smattering of them:

- In `main.rs`, the files are now passed around as vectors of files rather than array slices of files. This is because `File`s aren't `Clone`, and the `Vec` is necessary to give away ownership of the files at the appropriate point.
- In the details view, files are now sorted *all* the time, rather than obeying the command-line order. As they're run in parallel, they have no guaranteed order anyway, so we *have* to sort them again. (I'm not sure if this should be the intended behaviour or not!) This means that the `Details` struct has to have the filter *all* the time, not only while recursing, so it's been moved out of the `recurse` field.
- We use `scoped_threadpool` over `threadpool`, a recent addition. It's only safely used on Nightly, which we're using anyway, so that's OK!
- Removed a bunch of out-of-date comments.

This also fixes #77, mainly by accident :)
2015-09-02 23:19:10 +01:00
contrib Update man page with new options 2015-06-07 16:45:58 +01:00
src Parallelise the details view! 2015-09-02 23:19:10 +01:00
.gitignore Upgrade to latest ansi_term 2014-11-26 07:36:09 +00:00
.travis.yml Use a more recent Cmake version on Travis 2015-08-25 19:00:31 +01:00
Cargo.lock Parallelise the details view! 2015-09-02 23:19:10 +01:00
Cargo.toml Parallelise the details view! 2015-09-02 23:19:10 +01:00
LICENCE Update LICENCE 2014-07-02 22:07:09 +01:00
Makefile Makefile: be compatible with BSD and OS X 2015-07-31 13:11:32 +08:00
README.md The beta isn't the only Rust around! 2015-05-20 17:59:00 +01:00
screenshot.png Show off new tree functionality 2015-06-08 21:01:02 +01:00

exa Build status

exa is a replacement for ls written in Rust.

You'll have to use the nightly, rather than Rust 1.0 stable or 1.1 beta. Sorry about that.

Screenshot

Screenshot of exa

Options

exa's options are similar, but not exactly the same, as ls.

Filtering Options

  • -a, --all: show dot files
  • -d, --list-dirs: list directories as regular files
  • --group-directories-first: list directories before other files
  • -L, --level=(depth): maximum depth of recursion
  • -R, --recurse: recurse into subdirectories

View Options

  • -1, --oneline: display one entry per line
  • -r, --reverse: reverse sort order
  • -s, --sort=(field): field to sort by
  • -x, --across: sort multi-column view entries across
  • -T, --tree: recurse into subdirectories in a tree view

You can sort by name, size, ext, inode, modified, created, accessed, or none.

Long Format

  • -b, --binary: use binary (power of two) file sizes
  • -B, --bytes: list file sizes in bytes, without prefixes
  • -g, --group: show group as well as user
  • --git: show git status (depends on libgit2, see below)
  • -h, --header: show a header row
  • -H, --links: show number of hard links column
  • -i, --inode: show inode number column
  • -l, --long: display extended details and attributes
  • -m, --modified: display timestamp of most recent modification
  • -S, --blocks: show number of file system blocks
  • -t, --time=(field): which timestamp to show for a file
  • -u, --accessed: display timestamp of last access for a file
  • -U, --created: display timestamp of creation of a file
  • -@, --extended: display extended attribute keys and sizes

Installation

exa is written in Rust. You'll have to use the nightly -- I try to keep it up to date with the latest version when possible. Once you have it set up, a simple make install will compile exa and install it into /usr/local/bin.

exa depends on libgit2 for certain features. If you're unable to compile libgit2, you can opt out of Git support by passing --no-default-features to Cargo.