https://github.com/kyclark/command-line-rust

Code for Command-Line Rust (O'Reilly, 2024, ISBN 9781098109417)
https://github.com/kyclark/command-line-rust

cli command-line programming-language rust

Last synced: about 1 month ago
JSON representation

Code for Command-Line Rust (O'Reilly, 2024, ISBN 9781098109417)

• Host: GitHub
• URL: https://github.com/kyclark/command-line-rust
• Owner: kyclark
• License: mit
• Created: 2020-03-05T15:24:50.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-08-06T22:36:40.000Z (3 months ago)
• Last Synced: 2024-10-01T18:22:01.711Z (about 2 months ago)
• Topics: cli, command-line, programming-language, rust
• Language: Rust
• Homepage: https://learning.oreilly.com/library/view/command-line-rust/9781098109424/
• Size: 44.5 MB
• Stars: 1,512
• Watchers: 13
• Forks: 251
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Command-Line Rust: A Project-Based Primer for Writing Rust CLIs

This is the code repository for the [_Command-Line Rust_](https://learning.oreilly.com/library/view/command-line-rust/9781098109424/) (O'Reilly, 2022/2024, ISBN 9781098109417) 

## Author

Ken Youens-Clark 

## Synopsis

For several consecutive years, Rust has been voted "most loved programming language" in Stack Overflow's annual developer survey. This open source systems programming language is now used for everything from game engines and operating systems to browser components and virtual reality simulation engines. But Rust is also an incredibly complex language with a notoriously difficult learning curve.

Rather than focus on the language as a whole, this guide teaches Rust using a single small, complete, focused program in each chapter. Author Ken Youens-Clark shows you how to start, write, and test each of these programs to create a finished product. You'll learn how to handle errors in Rust, read and write files, and use regular expressions, Rust types, structs, and more.

Discover how to:

* Use Rust's standard libraries and data types to create command-line programs

* Write and test Rust programs and functions

* Read and write files, including stdin, stdout, and stderr

* Document and validate command-line arguments

* Write programs that fail gracefully

* Parse raw and delimited text

* Use and control randomness

## Git Branches

The book was originally published in 2022, when the `clap` (command-line argument parser) crate was a v2.33.

The book was updated in 2024 to use `clap` v4, which has two patterns for parsing, _builder_ (similar to the original v2.33 code) and _derive_.

The branches are organized as follows:

* `main`: Contains the `clap` v4 _derive_ pattern

* `clap_v4_builder`: Contains the `clap` v4 _builder_ pattern

* `clap_v2`: Contains the original programs from the 2022 version of the book that use `clap` v2.33

![Rust](rust.jpg)