Skip to content

Gandalf-/coreutils

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

coreutils

Unix core utilities implemented in Haskell.

Goals are:

  • Idiomatic implementations
  • Fast, lazy IO
  • Feature parity with BSD utils
  • Fully tested
  • Platform independent
Utility Idiomatic Fast Lazy Tests Complete
addrinfo - - 80
awk 40
basename - -
cat
cmp 50
cut 75 90 90
dirname - -
echo - -
env - -
exit - -
false - -
head
ls - 50
mkdir - -
nl
nologin - - -
paste ✓✓
pwd - - -
random - -
realpath - -
rev
seq 75
sleep - -
split
sponge -
strings 80
sum
tac 90
tee
test
tr 75
truncate -
true - -
uniq
wc
which - - -
whoami - - -
yes -
Symbol Meaning
✓✓ Superior
Complete
% % Partial
- Not applicable

Usage

This project compiles to a single executable which detects which utility to call depending on the name of the binary.

make release

or

stack install --flag coreutils:release

Platform Independent

With utils on your path, you can call any utility by name, using the name as the first argument.

I leaf@elm ~> utils echo hello | utils rev
olleh
C:\Users\leaf>utils echo hello | utils rev
olleh

This is the best option for trying things out without committing your entire shell to these implementations. The testing done is mostly thorough, but there's some crazy usage of the coreutils out in the wild; like cat - - - in build scripts. Who needs to read stdin three separate times? The standard Haskell IO libraries make some sane assumptions that things like this don't happen, so this project has balance ugly workarounds with idomatic behavior. Where reasonable, idomatic is preferred. Further, this project relies on the Haskell IO libraries for platform independence - where they decided to simplify (permissions, file types), this project does also.

Linux, FreeBSD, MacOS

If you do want to commit, symlink the utilities you'd like to expose to your $PATH variable. If ~/.local/bin/ has precedence over /bin/ and /usr/bin/, these are the versions your shell will use.

cd ~/.local/bin/
ln -s utils cat
ln -s utils sleep
ln -s utils rev
...
I leaf@elm ~> which which
/home/leaf/.local/bin/which

On Windows

Symlinking doesn't appear to change the name reported by System.Environment.getProgName, so you'll need to create copies of the binary with different names.

PS C:\> cd (Split-Path -Parent (Get-Command utils.exe).Path)
PS C:\Users\leaf\AppData\Roaming\local\bin> cp utils.exe which.exe
PS C:\Users\leaf\AppData\Roaming\local\bin> cd C:\
PS C:\> which calc.exe
C:\WINDOWS\system32\calc.exe
PS C:\> which which.exe
C:\Users\leaf\AppData\Roaming\local\bin\which.exe

About

Unix core utilities implemented in Haskell

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published