exa/README.md

42 lines
1.9 KiB
Markdown
Raw Normal View History

2014-12-12 15:15:35 +00:00
# exa [![Build status](https://travis-ci.org/ogham/exa.svg)](https://travis-ci.org/ogham/exa)
2014-05-22 12:55:11 +00:00
2015-02-21 21:35:31 +00:00
[exa](http://bsago.me/exa) is a replacement for `ls` written in Rust.
2014-06-28 11:20:50 +00:00
2015-04-03 21:19:06 +00:00
**You'll have to use the nightly, rather than Rust beta. Sorry about that.**
2014-06-28 11:20:50 +00:00
2014-12-12 15:15:35 +00:00
## Screenshot
2014-05-22 12:55:11 +00:00
![Screenshot of exa](https://raw.githubusercontent.com/ogham/exa/master/screenshot.png)
2014-06-28 11:20:50 +00:00
2014-12-12 15:15:35 +00:00
## Options
2014-06-28 11:20:50 +00:00
- **-1**, **--oneline**: display one entry per line
2014-06-28 11:20:50 +00:00
- **-a**, **--all**: show dot files
- **-b**, **--binary**: use binary (power of two) file sizes
2014-12-18 07:04:31 +00:00
- **-B**, **--bytes**: list file sizes in bytes, without prefixes
- **-d**, **--list-dirs**: list directories as regular files
2014-06-28 11:20:50 +00:00
- **-g**, **--group**: show group as well as user
2015-03-10 18:06:03 +00:00
- **--git**: show git status (depends on libgit2, see below)
2014-06-28 11:20:50 +00:00
- **-h**, **--header**: show a header row
- **-H**, **--links**: show number of hard links column
2014-06-28 11:20:50 +00:00
- **-i**, **--inode**: show inode number column
- **-l**, **--long**: display extended details and attributes
2014-06-28 11:20:50 +00:00
- **-r**, **--reverse**: reverse sort order
- **-R**, **--recurse**: recurse into subdirectories
2014-07-22 20:27:36 +00:00
- **-s**, **--sort=(field)**: field to sort by
2014-06-28 11:20:50 +00:00
- **-S**, **--blocks**: show number of file system blocks
2015-02-09 16:36:51 +00:00
- **-t**, **--time**: which timestamp to show for a file
2015-02-09 16:49:31 +00:00
- **-T**, **--tree**: recurse into subdirectories in a tree view
2014-07-07 18:18:09 +00:00
- **-x**, **--across**: sort multi-column view entries across
2014-06-28 11:20:50 +00:00
You can sort by **name**, **size**, **ext**, **inode**, **modified**, **created**, **accessed**, or **none**.
2014-07-22 20:27:36 +00:00
2014-12-12 15:15:35 +00:00
## Installation
2014-06-28 11:20:50 +00:00
exa is written in [Rust](http://www.rust-lang.org). 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`.
2015-01-27 15:59:22 +00:00
exa depends on [libgit2](https://github.com/alexcrichton/git2-rs) for certain features. If you're unable to compile libgit2, you can opt out of Git support by passing `--no-default-features` to Cargo.