2014-06-12 13:48:41 +00:00
|
|
|
uutils coreutils [![Build Status](https://api.travis-ci.org/uutils/coreutils.svg?branch=master)](https://travis-ci.org/uutils/coreutils)
|
2013-08-02 17:24:20 +00:00
|
|
|
================
|
|
|
|
|
|
|
|
uutils is an attempt at writing universal (as in cross-platform) CLI
|
|
|
|
utils in [Rust](http://rust-lang.org). This repo is to aggregate the GNU
|
|
|
|
coreutils rewrites.
|
|
|
|
|
|
|
|
Why?
|
|
|
|
----
|
|
|
|
|
2014-02-19 01:52:47 +00:00
|
|
|
Many GNU, Linux and other utils are pretty awesome, and obviously
|
2013-08-02 17:24:20 +00:00
|
|
|
[some](http://gnuwin32.sourceforge.net) [effort](http://unxutils.sourceforge.net)
|
2014-02-19 01:52:47 +00:00
|
|
|
has been spent in the past to port them to Windows. However, those projects
|
2014-02-06 05:18:03 +00:00
|
|
|
are either old, abandoned, hosted on CVS, written in platform-specific C, etc.
|
2013-08-02 17:24:20 +00:00
|
|
|
|
2014-02-19 01:52:47 +00:00
|
|
|
Rust provides a good, platform-agnostic way of writing systems utils that are easy
|
2013-08-02 17:24:20 +00:00
|
|
|
to compile anywhere, and this is as good a way as any to try and learn it.
|
|
|
|
|
2013-12-27 21:32:56 +00:00
|
|
|
Build Instructions
|
|
|
|
------------------
|
|
|
|
|
|
|
|
To simply build all available utilities:
|
|
|
|
```
|
|
|
|
make
|
|
|
|
```
|
|
|
|
|
|
|
|
To build all but a few of the available utilities:
|
|
|
|
```
|
|
|
|
make DONT_BUILD='UTILITY_1 UTILITY_2'
|
|
|
|
```
|
|
|
|
|
|
|
|
To build only a few of the available utilities:
|
|
|
|
```
|
|
|
|
make BUILD='UTILITY_1 UTILITY_2'
|
|
|
|
```
|
|
|
|
|
2014-07-20 08:27:47 +00:00
|
|
|
To build with LTO and stripping:
|
|
|
|
```
|
|
|
|
make ENABLE_LTO=y ENABLE_STRIP=y
|
|
|
|
```
|
|
|
|
|
2014-06-13 02:14:56 +00:00
|
|
|
Installation Instructions
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
To install all available utilities:
|
|
|
|
```
|
|
|
|
make install
|
|
|
|
```
|
|
|
|
|
|
|
|
To install all but a few of the available utilities:
|
|
|
|
```
|
|
|
|
make DONT_INSTALL='UTILITY_1 UTILITY_2' install
|
|
|
|
```
|
|
|
|
|
|
|
|
To install only a few of the available utilities:
|
|
|
|
```
|
|
|
|
make INSTALL='UTILITY_1 UTILITY_2' install
|
|
|
|
```
|
|
|
|
|
2014-06-25 16:47:34 +00:00
|
|
|
To install every program with a prefix:
|
2014-06-13 02:14:56 +00:00
|
|
|
```
|
|
|
|
make PROG_PREFIX=PREFIX_GOES_HERE install
|
|
|
|
```
|
|
|
|
|
2014-07-01 08:07:16 +00:00
|
|
|
To install the multicall binary:
|
|
|
|
```
|
|
|
|
make install-multicall
|
|
|
|
```
|
|
|
|
|
2014-06-13 02:14:56 +00:00
|
|
|
Uninstallation Instructions
|
|
|
|
---------------------------
|
|
|
|
|
2014-06-13 02:49:00 +00:00
|
|
|
To uninstall all utilities:
|
|
|
|
```
|
|
|
|
make uninstall
|
|
|
|
```
|
|
|
|
|
2014-06-25 16:47:34 +00:00
|
|
|
To uninstall every program with a set prefix:
|
2014-06-13 02:49:00 +00:00
|
|
|
```
|
|
|
|
make PROG_PREFIX=PREFIX_GOES_HERE uninstall
|
|
|
|
```
|
2014-06-13 02:14:56 +00:00
|
|
|
|
2014-07-01 08:07:16 +00:00
|
|
|
To uninstall the multicall binary:
|
|
|
|
```
|
|
|
|
make uninstall-multicall
|
|
|
|
```
|
|
|
|
|
2013-12-27 21:32:56 +00:00
|
|
|
Test Instructions
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
To simply test all available utilities:
|
|
|
|
```
|
|
|
|
make test
|
|
|
|
```
|
|
|
|
|
|
|
|
To test all but a few of the available utilities:
|
|
|
|
```
|
|
|
|
make DONT_TEST='UTILITY_1 UTILITY_2' test
|
|
|
|
```
|
|
|
|
|
|
|
|
To test only a few of the available utilities:
|
|
|
|
```
|
|
|
|
make TEST='UTILITY_1 UTILITY_2' test
|
|
|
|
```
|
|
|
|
|
2013-11-30 23:07:22 +00:00
|
|
|
Contribute
|
|
|
|
----------
|
|
|
|
|
2014-02-24 07:14:02 +00:00
|
|
|
Contributions are very welcome, and should target Rust's master branch until
|
|
|
|
Rust 1.0 is released. You may *claim* an item on the to-do list by following
|
2013-12-15 19:04:49 +00:00
|
|
|
these steps:
|
2013-11-30 23:07:22 +00:00
|
|
|
|
|
|
|
1. Open an issue named "Implement [the utility of your choice]", e.g. "Implement ls"
|
|
|
|
2. State that you are working on this utility.
|
|
|
|
3. Develop the utility.
|
2014-06-25 09:05:23 +00:00
|
|
|
4. Add the reference to your utility into uutils/uutils.rs (required for multibinary).
|
|
|
|
5. Remove utility from the to-do list on this README.
|
|
|
|
6. Submit a pull request and close the issue.
|
2013-11-30 23:07:22 +00:00
|
|
|
|
|
|
|
The steps above imply that, before starting to work on a utility, you should search the issues to make sure no one else is working on it.
|
|
|
|
|
2013-08-02 17:24:20 +00:00
|
|
|
To do
|
|
|
|
-----
|
|
|
|
|
|
|
|
- chcon
|
|
|
|
- chgrp
|
|
|
|
- chmod
|
|
|
|
- chown
|
|
|
|
- copy
|
2014-06-13 02:14:56 +00:00
|
|
|
- cp (not much done)
|
2013-08-02 17:24:20 +00:00
|
|
|
- csplit
|
|
|
|
- date
|
|
|
|
- dd
|
|
|
|
- df
|
|
|
|
- dircolors
|
|
|
|
- expr
|
|
|
|
- getlimits
|
|
|
|
- install
|
|
|
|
- join
|
|
|
|
- libstdbuf
|
|
|
|
- ln
|
|
|
|
- ls
|
|
|
|
- mknod
|
|
|
|
- mktemp
|
|
|
|
- mv
|
|
|
|
- nice
|
|
|
|
- nproc
|
|
|
|
- numfmt
|
|
|
|
- od
|
|
|
|
- pathchk
|
|
|
|
- pinky
|
|
|
|
- pr
|
|
|
|
- printf
|
|
|
|
- ptx
|
|
|
|
- readlink
|
|
|
|
- remove
|
|
|
|
- runcon
|
|
|
|
- setuidgid
|
|
|
|
- shred
|
|
|
|
- sort
|
|
|
|
- split
|
|
|
|
- stat
|
|
|
|
- stdbuf
|
2014-06-25 23:12:49 +00:00
|
|
|
- stty
|
2014-06-12 21:27:37 +00:00
|
|
|
- tail (not all features implemented)
|
2014-07-12 01:12:29 +00:00
|
|
|
- test (not all features implemented)
|
2013-11-29 19:40:54 +00:00
|
|
|
- uniq (in progress)
|
2013-08-02 17:24:20 +00:00
|
|
|
- who
|
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
2014-02-16 20:44:50 +00:00
|
|
|
uutils is licensed under the MIT License - see the `LICENSE` file for details
|