https://github.com/timclicks/notcoreutils

Learn Rust by needlessly implementing GNU coreutils
https://github.com/timclicks/notcoreutils

Last synced: 3 days ago
JSON representation

Learn Rust by needlessly implementing GNU coreutils

• Host: GitHub
• URL: https://github.com/timclicks/notcoreutils
• Owner: timClicks
• Created: 2015-11-02T09:17:34.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-11-04T09:09:36.000Z (about 9 years ago)
• Last Synced: 2025-01-19T11:15:19.688Z (7 days ago)
• Language: Rust
• Homepage:
• Size: 148 KB
• Stars: 3
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# notcoreutils

Learn Rust by needlessly implementing GNU `coreutils`

## About

This text is intended as a bit of a choose your own adventure walkthrough of the Rust

programming language. There are (well, will be) dozens of small projects in here

that explore different parts of the language. By project two, we already touch

upon one of Rust's specialties: conditional compilation depending on which

operating system we're dealing with.

If you're not sure what conditional compilation might mean, don't let that scare

you off though. We start easy and all of the projects are well documented.

This book is written by a Python programmer learning Rust. That means that

it's unlikely that you'll find perfectly idiomatic code. Still, I hope you find

reading worthwhile. If you find something that should be improved, you are

very welcome to submit a pull request to get it fixed!

## Reading

The easiest way to read this text is by clicking through the `text` directory.

The reading order is available in `text/SUMMARY.md`.

At some stage – when there's a little more content &ndash I'll get a

rendered book online.

## Building

You will need `rustbook` to build the HTML. The easiest way is to clone

https://github.com/steveklabnik/rustbook.

## Legalese

Text content is copyright Tim McNamara .

I assert my moral rights to the work. Content released under CC-BY 4.0 NZ.

To satisfy the attribution requirement of this licence,

you should add a URL to this repository in your derivative work.


Source code is copyright Tim McNamara ,

released under the [MIT/X11 licence](https://opensource.org/licenses/MIT).


If you rely on the source code for personal reasons, you may have

protections under New Zealand's

[Consumer Guarantees Act 1993](http://www.legislation.govt.nz/act/public/1993/0091/latest/DLM311053.html).

(I personally doubt it, as I don't think `git clone` satisfies goods being

supplied [in trade](http://www.legislation.govt.nz/act/public/1993/0091/latest/DLM312857.html#DLM312857)).

Please be aware that the source code in this repository or any binaries produced from

it *should not* be relied upon for any purpose. I am learning a new programming language. There will be mistakes.