Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mike-ward/lsv
lsv - Vlang implementation of ls
https://github.com/mike-ward/lsv
Last synced: about 1 month ago
JSON representation
lsv - Vlang implementation of ls
- Host: GitHub
- URL: https://github.com/mike-ward/lsv
- Owner: mike-ward
- License: mit
- Created: 2024-06-18T23:08:01.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-09-07T15:11:45.000Z (4 months ago)
- Last Synced: 2024-09-07T16:42:09.359Z (4 months ago)
- Language: V
- Homepage:
- Size: 1.59 MB
- Stars: 18
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-v - lsv - `ls` file lister in the spirit of exa, eza, lsd, pls, natls, ls-go and others. (Applications / Command-line)
README
# lsv - Vlang implementation of `ls`
`lsv` is a modern alternative to `ls` in the spirit of `exa, eza, lsd, pls, natls, ls-go` and others.
Border format with header option
## Features
- Single binary with no external dependencies!
- Not written in Rust 😮 (see below)
- Color output based on LS_COLORS
- Table format (long format)
- Column Headers (long format)
- Blocked output (long format)
- Icons
- Checksum (md5, sha1, sha224, sha256, sha512, blake2b)
- Friendly file sizes and dates
- Nearly as fast as GNU `ls`
- Robust recursion. Try `lsv -R /`
- Options similar to `ls`
- Usual other `ls` features
## Installing
### Build `lsv` from source.
- [Install the V compiler](https://docs.vlang.io/installing-v-from-source.html). It takes a minute or less
- `git clone https://github.com/mike-ward/lsv.git`
- `cd lsv`
- `make`
- `bin/lsv`
### Binaries
[Latest Release](https://github.com/mike-ward/lsv/releases/latest)
### Homebrew
I tried several times to submit to Homebrew but could never get past the CI. Please send a pull request to Homebrew if you know how. Thanks.
## Help
```
lsv 2024.4
-----------------------------------------------
Usage: lsv [options] [FILES]
Description: List information about FILES
Options:
-a include files starting with .
-c color the listing
-D append / to directories
-i show file icon (requires nerd fonts)
-m list of files separated by commas
-q enclose files in quotes
-R list subdirectories recursively
--depth limit depth of recursion
-X list files by lines instead of by columns
-1 list one file per line
--width set output width to
Filtering and Sorting Options:
-d list only directories
-f list only files
-g group directories before files
-r reverse the listing order
-s sort by file size, largest first
-t sort by time, newest first
-v sort digits within text as numbers
-w sort by width, shortest first
-x sort by file extension
-u no sorting
Long Listing Options:
-b blank line every 5 rows
-B add borders to long listing format
-k sizes in kibibytes (1024) (e.g. 1k 234m 2g)
-K sizes in Kilobytes (1000) (e.g. 1kb 234mb 2gb)
-l long listing format
-o show octal permissions
-p show relative path
-A show last accessed date
-C show last status changed date
-H show column headers
-I show time in iso format
-J show time in compact format
-N show inodes
-Z do not wrap long lines
--cs show file checksum
(md5, sha1, sha224, sha256, sha512, blake2b)
--no-counts hide file/dir counts
--no-date hide date (modified)
--no-dim hide shading; useful for light backgrounds
--no-group hide group name
--no-hard-links hide hard links count
--no-owner hide owner name
--no-permissions hide permissions
--no-size hide file size
-h, --help display this help and exit
--version output version information and exit
The -c option emits color codes when standard output is
connected to a terminal. Colors are defined in the LS_COLORS
environment variable.
```
## Why?
It started with writing a `ls` implemention for the V Language CoreUtils project.
Coreutils is a reimplementation of the POSIX and GNU utility programs written in the V Language. Everything was going fine until I started having too much fun and down the, "Rabbit Hole" I went.
What's this V language? You can read about it [here](https://vlang.io/), but the short version is it is a simple, fast, safe, compiled language for developing maintainable software. I mentioned `lsv` is not written in Rust. I'm not trashing Rust. Rust is obviously a robust and popular language. However, it's a steep climb to get up to speed and requires a fair bit of cognitive load to use it well.
V is the opposite. It has many of the same safty features of Rust, but without the cognitive over head. It's simple, straightfoward syntax makes it a breeze to write. Builds happen in milliseconds, not minutes and hours. You don't need any special build tools like Gradle.
Finally, take a look at the `lsv` code base. The entire code base is **2K lines** 🧐. Furthermore, the implemention is straightforward. No threading, coroutines or fancy memory management. Even if you don't know V, I'm betting you will understand the code.
## Helping Out
See CONTRIBUTING.md for more information