intro.md

Cookin' with Rust

This Rust Cookbook is a collection of simple examples that demonstrate good practices to accomplish common programming tasks, using the crates of the Rust ecosystem.

Read more about Rust Cookbook, including tips for how to read the book, how to use the examples, and notes on conventions.

Contributing

This project is intended to be easy for new Rust programmers to contribute to, and an easy to way get involved with the Rust community. It needs and welcomes help. For details see CONTRIBUTING.md.

Basics

Recipe	Crates	Categories
Read lines of strings from a file
Read and write integers in little-endian byte order
Generate random numbers
Generate random numbers within a range
Generate random number distributions
Generate random values of a custom type
Run an external command and process stdout
Declare lazily evaluated constant
Maintain global mutable state
Access a file randomly using a memory map
Define and operate on a type represented as a bitfield

Encoding

Recipe	Crates	Categories
Serialize and deserialize unstructured JSON
Deserialize a TOML configuration file
Percent-encode a string
Encode a string as application/x-www-form-urlencoded
Encode and decode hex
Encode and decode base64

Concurrency

Recipe	Crates	Categories
Mutate the elements of an array in parallel
Spawn a short-lived thread
Draw fractal dispatching work to a thread pool

Networking

Recipe	Crates	Categories
Parse a URL from a string to a Url type
Create a base URL by removing path segments
Create new URLs from a base URL
Extract the URL origin (scheme / host / port)
Remove fragment identifiers and query pairs from a URL
Make a HTTP GET request after parsing a URL
Download a file to a temporary directory
Query the GitHub API
Consume a paginated RESTful API
Check if an API resource exists
Set custom headers and URL parameters for a REST request
Create and delete Gist with GitHub API
POST a file to paste-rs
Listen on unused port TCP/IP
Extract all links from a webpage

Application development

Recipe	Crates	Categories
Parse command line arguments
Decompress a tarball
Compress a directory into a tarball
Decompress a tarball while removing a prefix from the paths
Find loops for a given path
Recursively find duplicate file names
Recursively find all files with given predicate
Traverse directories while skipping dotfiles
Recursively calculate file sizes at given depth
Find all png files recursively
Find all files with given pattern ignoring filename case

Logging

Recipe	Crates	Categories
Log a debug message to the console
Log an error message to the console
Enable log levels per module
Log to stdout instead of stderr
Log messages with a custom logger
Include timestamp in log messages
Log to the Unix syslog
Log messages to a custom location