Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/instrumentisto/rust-incubator

Learning Rust step-by-step.
https://github.com/instrumentisto/rust-incubator

Last synced: 6 days ago
JSON representation

Learning Rust step-by-step.

Awesome Lists containing this project

README 

        
Rust Incubator

==============



> It wasn’t always so clear, but the Rust programming language is fundamentally about _empowerment_: no matter what kind of code you are writing now, Rust empowers you to reach farther, to program with confidence in a wider variety of domains than you did before.

_
Rust Book's Foreword
_



This project represents a hard-way step-by-step [Rust] learning course from language basics to a capability of web backend development.



## Prerequisites



### Toolchain



- [rustup] for installing [Rust] toolchain and keeping it up-to-date.

- [CLion]/[IntelliJ IDEA] + [IntelliJ Rust] + [Toml][IntelliJ Toml] plugins as development environment (or any other on your choice).



### Bookshelf



- [Rust Book] teaches and explains [Rust] basics.

- [Rust By Example] teaches you [Rust] basics using editable examples.

- [Rust Reference] is not a formal spec, but is more detailed and comprehensive than the [Rust Book].

- [Cheats.rs] and [Rust SVG Cheatsheet] for quick reference.

- [Rust Edition Guide] for considering improvements of [Rust 2018] and [Rust 2021].

- [Rust std lib] documentation.

- [Cargo Book] is a guide to [Cargo], [Rust]'s build tool and dependency manager.

- [Rustdoc Book] is a guide to `rustdoc` documentation tool.

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

- [Rust Design Patterns] is an open source repository of [Rust] design patterns and idioms.

- [Effective Rust] is a collection of guidelines that had been learned from real world experience of creating software in [Rust].

- [Rust API Guidelines] is a set of recommendations on how to design and present APIs for [Rust].

- [Rust FAQ] answers common question about [Rust].

- [Rust Playground] allows to share and check runnable [Rust] code snippets online.

- [Awesome Rust] is a curated list of [Rust] code and resources.

- [This Week in Rust] represents handpicked and subscribable [Rust] weekly updates.

- [Baby Steps] blog of [Nicholas Matsakis](https://github.com/nikomatsakis) shares useful [Rust] patterns, ideas and design decisions.

- [Learning Material for Idiomatic Rust] is a curated list of resources to help you write ergonomic and idiomatic [Rust] code.



## Steps



### Before you start



[Create][1] a new [GitHub repository] for yourself using this one [as template][11].



> __NOTE__: __This learning course is constantly improving and evolving over time.__ 

>

> To be up-to-date with the recent changes in your own copy of this repository, attach the upstream history with the following commands:

> ```bash

> git remote add upstream https://github.com/instrumentisto/rust-incubator.git

> git fetch upstream main

> git merge upstream/main --allow-unrelated-histories

> ```

> And then, whenever you want to grab some new changes, do the following:

> ```bash

> git fetch upstream main

> git merge upstream/main

> ```

> Additionally, to be aware about new changes, you may either [watch this repository on GitHub][2], or even track it via [RSS subscription].



### Schedule



Each step must be performed as a separate [PR (pull request)][PR] with an appropriate name and check-marked here in README's schedule after completion. Each step is a [Cargo workspace member][13], so you can run/test it from the project root (i.e. `cargo run -p step_1_8`). __Consider to use [rustfmt] and [Clippy] when you're writing [Rust] code.__



- [ ] [0. Become familiar with Rust basics][Step 0] (3 days)

- [ ] [1. Concepts][Step 1] (2 days, after all sub-steps)

    - [ ] [1.1. Default values, cloning and copying][Step 1.1] (1 day)

    - [ ] [1.2. Boxing and pinning][Step 1.2] (1 day)

    - [ ] [1.3. Shared ownership and interior mutability][Step 1.3] (1 day)

    - [ ] [1.4. Clone-on-write][Step 1.4] (1 day)

    - [ ] [1.5. Conversions, casting and dereferencing][Step 1.5] (1 day)

    - [ ] [1.6. Static and dynamic dispatch][Step 1.6] (1 day)

    - [ ] [1.7. `Sized` and `?Sized` types][Step 1.7] (1 day)

    - [ ] [1.8. Thread safety][Step 1.8] (1 day)

    - [ ] [1.9. Phantom types][Step 1.9] (1 day)

- [ ] [2. Idioms][Step 2] (2 days, after all sub-steps)

    - [ ] [2.1. Rich types ensure correctness][Step 2.1] (1 day)

    - [ ] [2.2. Swapping values with `mem::replace`][Step 2.2] (1 day)

    - [ ] [2.3. Bound behavior, not data][Step 2.3] (1 day)

    - [ ] [2.4. Abstract type in, concrete type out][Step 2.4] (1 day)

    - [ ] [2.5. Exhaustivity][Step 2.5] (1 day)

    - [ ] [2.6. Sealing][Step 2.6] (1 day)

- [ ] [3. Common ecosystem][Step 3] (2 days, after all sub-steps)

    - [ ] [3.1. Testing and mocking][Step 3.1] (1 day)

    - [ ] [3.2. Declarative and procedural macros][Step 3.2] (1 day)

    - [ ] [3.3. Date and time][Step 3.3] (1 day)

    - [ ] [3.4. Regular expressions and custom parsers][Step 3.4] (1 day)

    - [ ] [3.5. Collections and iterators][Step 3.5] (1 day)

    - [ ] [3.6. Serialization and deserialization][Step 3.6] (1 day)

    - [ ] [3.7. Randomness and cryptography][Step 3.7] (1 day)

    - [ ] [3.8. Logging and tracing][Step 3.8] (1 day)

    - [ ] [3.9. Command-line arguments, environment variables and configs][Step 3.9] (1 day)

    - [ ] [3.10. Multithreading and parallelism][Step 3.10] (1 day)

    - [ ] [3.11. Async I/O, futures and actors][Step 3.11] (2 days)

- [ ] [4. Backend ecosystem][Step 4] (3 days, after all sub-steps)

    - [ ] [4.1. Databases, connection pools and ORMs][Step 4.1] (1 day)

    - [ ] [4.2. HTTP servers and clients][Step 4.2] (1 day)

    - [ ] [4.3. API servers, clients and tools][Step 4.3] (1 day)



## More practice



- [rustlings] are small exercises to get you used to reading and writing [Rust] code.

- [Rust on Exercism] provides coding exercises with mentoring.

- [Rust Quiz] is medium to hard [Rust] questions with explanations.



[Step 0]: 0_basics

[Step 1]: 1_concepts

[Step 1.1]: 1_concepts/1_1_default_clone_copy

[Step 1.2]: 1_concepts/1_2_box_pin

[Step 1.3]: 1_concepts/1_3_rc_cell

[Step 1.4]: 1_concepts/1_4_cow

[Step 1.5]: 1_concepts/1_5_convert_cast_deref

[Step 1.6]: 1_concepts/1_6_dispatch

[Step 1.7]: 1_concepts/1_7_sized

[Step 1.8]: 1_concepts/1_8_thread_safety

[Step 1.9]: 1_concepts/1_9_phantom

[Step 2]: 2_idioms

[Step 2.1]: 2_idioms/2_1_type_safety

[Step 2.2]: 2_idioms/2_2_mem_replace

[Step 2.3]: 2_idioms/2_3_bound_impl

[Step 2.4]: 2_idioms/2_4_generic_in_type_out

[Step 2.5]: 2_idioms/2_5_exhaustivity

[Step 2.6]: 2_idioms/2_6_sealing

[Step 3]: 3_ecosystem

[Step 3.1]: 3_ecosystem/3_1_testing

[Step 3.2]: 3_ecosystem/3_2_macro

[Step 3.3]: 3_ecosystem/3_3_date_time

[Step 3.4]: 3_ecosystem/3_4_regex_parsing

[Step 3.5]: 3_ecosystem/3_5_collections

[Step 3.6]: 3_ecosystem/3_6_serde

[Step 3.7]: 3_ecosystem/3_7_rand_crypto

[Step 3.8]: 3_ecosystem/3_8_log

[Step 3.9]: 3_ecosystem/3_9_cmd_env_conf

[Step 3.10]: 3_ecosystem/3_10_threads

[Step 3.11]: 3_ecosystem/3_11_async

[Step 4]: 4_backend

[Step 4.1]: 4_backend/4_1_db

[Step 4.2]: 4_backend/4_2_http

[Step 4.3]: 4_backend/4_3_api



[Awesome Rust]: https://github.com/rust-unofficial/awesome-rust

[Baby Steps]: http://smallcultfollowing.com/babysteps

[Cargo]: https://github.com/rust-lang/cargo

[Cargo Book]: https://doc.rust-lang.org/cargo

[Cheats.rs]: https://cheats.rs

[CLion]: https://www.jetbrains.com/clion

[Clippy]: https://github.com/rust-lang/rust-clippy

[Effective Rust]: https://www.lurklurk.org/effective-rust

[GitHub repository]: https://help.github.com/articles/github-glossary/#repository

[IntelliJ IDEA]: https://www.jetbrains.com/idea

[IntelliJ Rust]: https://intellij-rust.github.io

[IntelliJ Toml]: https://plugins.jetbrains.com/plugin/8195-toml

[Learning Material for Idiomatic Rust]: https://corrode.dev/blog/idiomatic-rust-resources

[PR]: https://help.github.com/articles/github-glossary/#pull-request

[RSS subscription]: https://github.com/instrumentisto/rust-incubator/commits/main.atom

[Rust]: https://www.rust-lang.org

[Rust 2018]: https://doc.rust-lang.org/edition-guide/rust-2018/index.html

[Rust 2021]: https://doc.rust-lang.org/edition-guide/rust-2021/index.html

[Rust API Guidelines]: https://rust-lang.github.io/api-guidelines

[Rust Book]: https://doc.rust-lang.org/book

[Rust By Example]: https://doc.rust-lang.org/rust-by-example

[Rust Cookbook]: https://rust-lang-nursery.github.io/rust-cookbook

[Rust Design Patterns]: https://rust-unofficial.github.io/patterns

[Rust Edition Guide]: https://doc.rust-lang.org/edition-guide

[Rust FAQ]: https://prev.rust-lang.org/faq.html

[Rust on Exercism]: https://exercism.org/tracks/rust/exercises

[Rust Playground]: https://play.rust-lang.org

[Rust Quiz]: https://github.com/dtolnay/rust-quiz

[Rust Reference]: https://doc.rust-lang.org/reference

[Rust std lib]: https://doc.rust-lang.org/std

[Rust SVG Cheatsheet]: https://www.breakdown-notes.com/make/load/rust_cs_canvas/true

[Rustdoc Book]: https://doc.rust-lang.org/rustdoc

[rustfmt]: https://github.com/rust-lang/rustfmt

[rustlings]: https://rustlings.cool

[rustup]: https://rustup.rs

[This Week in Rust]: https://this-week-in-rust.org



[1]: https://github.com/instrumentisto/rust-incubator/generate

[2]: https://github.com/instrumentisto/rust-incubator/subscription

[11]: https://help.github.com/en/articles/creating-a-repository-from-a-template

[13]: https://doc.rust-lang.org/book/ch14-03-cargo-workspaces.html