Coreutils in Rust

An in-progress safe implementation of coreutils aiming for a minimal and yet complete set of utilities. This project aims at the POSIX specification basic requirements, plus common and useful features present in other implementations of the utility.

This project has no intent to be 100% compatible with GNU's coreutils, like Uutils' coreutils, but if it happens to be, it's okay too.

Minimum Rust Version Policy

This project's minimum supported rustc version (MSRV) is 1.58.0.

This will not be conservative until we get to a 1.0 version. So it can be changed at any point in time.

Compilation tests guarantees

The compilation is tested for Rust Tier 1 and Tier 2 x86_64 Unix/Unix-like platforms (except Redox), with CI.

All platforms are tested on MSRV and stable Rust, and Tier 1 platforms are also tested on beta and nightly Rust (Tier 2 and 3 only guarantee stable full capacity).

Also, note that Tier 3 Rust tests can fail before it hits the compilation check, since my only option is to use a Linux system, add the target, and do cargo check --target, and they often are not available as a target for any Tier 1 platforms. If you use one of these platforms and have the right MSRV requirements and it build successfully, let me know, if it fails, open an issue with the compilation error.

Platform	Tier	Manual Status
Linux	Tier 1	Passing (Manjaro Linux 5.3.2 - 2019-10-28) (8695863)
MacOS	Tier 1	-
FreeBSD	Tier 2	Passing (FreeBSD 12.0 - 2019-10-28) (8695863)
NetBSD	Tier 2	- (system without minimal version)
Illumos	Tier 2	- (system without minimal version)
Solaris	Tier 2	- (system without minimal version)
Fuchsia	Tier 2	-
OpenBSD	Tier 3	Passing (OpenBSD 6.6 Current - 2019-10-28) (8695863)
DragonflyBSD	Tier 3	Passing (DragonflyBSD 5.6.2 - 2019-10-28) (8695863)
Haiku	Tier 3	-

Compilation

Since not all targets provide full Unix API coverage (they aren't Unix or lack libc crate support), some can provide a Cargo.toml that have all utilities that should work on the target.

Compilation example for

cp <PLATFORM>.toml Cargo.toml
cargo build --release

Tools

Name	Not Started	Started	Done
basename			X
cat		X
chgrp	X
chmod	X
chown	X
chroot			X
clear			X
comm	X
cp	X
csplit		X
cut			X
date		X
dd	X
df	X
diff	X
dirname			X
du			X
echo			X
env			X
expand			X
expr	X
false			X
groups			X
hash	X
head			X
id			X
install	X
join	X
link			X
ln	X
logname			X
ls			X
mkdir			X
mktemp			X
mkfifo	X
mv			X
nice			X
nl			X
nohup			X
od	X
paste	X
patch	X
printf			X
pwd			X
rm			x
rmdir			X
sed	X
seq		X
sort		X
sleep			X
split	X
stat	X
stty	X
tail		X
tee		X
test	X
time	X
touch		X
tr	X
true			X
tsort	X
tty			X
uname			X
unexpand			X
uniq		X
unlink			X
uptime			X
users			X
wc			X
who			X
whoami			X
yes			X

Licensing

This software is licensed under the Mozilla Public License, v. 2.0 (MPL). If a copy of the MPL was not distributed with this file, you can obtain one at http://mozilla.org/MPL/2.0/.

Contributing

We appreciate contributions, please check CONTRIBUTING.md for guidelines on how to contribute to the project with issue reports, git commits messages, etc.

The document also gives orientation on where to start if you wanna implement a pending tool from scratch.