Teach Rust
"Teach Rust" is free workshop material to use to give a course introducing the Rust programming language. The time for the full course is around three to four days.
The material is created with people with zero Rust experience but with a programming background in mind.
Commercial availability
This course is sponsored and trained by Ferrous Systems in German and English. Get in touch for a custom quote.
The Spanish translation is community-maintained, we gladly refer to trainers.
Overview
The course consists of two parts:
The course presentations is used as an introduction into all basic aspects of Rust. It comes in small parts and ships with integration into the Rust playground for examples as well with a translation structure.
The work examples. The course constructs a small TCP server from ground up.
Along with that, all communication material we used is supplied here.
The presentations
The presentation material is split into many small to medium presentations for every aspect of Rust. Not all are meant to fully cover a topic, but as an introduction of the important points. Chapters covering basic things such as ownership and borrowing should be exhaustive
The presentations are Reveal presentations with plugins for internationalisation and integration into the Rust Playground.
The path through the presentations is not fixed, to allow leeway during holding the course. Examples of the pathes we used can be found in the courses directory. We recommend to create your own while preparing for giving the workshop.
The examples
Currently, the course ships with three examples:
- A simple TCP server that provides a very simple PUT and GET interface to store and remove messages
- The same built with Tokio and Futures
- A Rust library that can be used as a dynamic language
The TCP server is meant to be built from ground up, starting with a fresh crate.
The examples given here are an example of the final state. Before giving this course, you should develop this example by yourself.
The Tasks
There are various tasks which can be found in src/bin/
and can be run with cargo run --bin $TASK"
.
The tasks are as follows:
add-chapter $CHAPTER
- Creates a chapter by the name of$CHAPTER
for each locale.add-code-example $CHAPTER $INDEX
- Appropriately renames all existing code examples (<=$INDEX
are incremented by 1) for$CHAPTER
to make room for a new code example. Also updates the slides to reflect this.build-indices
- Builds the indices inpresentation/toc/
from.md
tohtml
for use in a web browser.extract-code
- Extracts code samples from the slides in all chapters and creates appropriate copies in thepresentation/chapters/shared/code/*/*
, then updates the slides with new elements reflecting the new location, should not need to be regularly used.rename-chapter $OLD $NEW
- Renames chapter$OLD
to$NEW
for all locales.rename-chapters
- Renames chapters with anmd
extension tochapter
. Should not need to be regularly used.
Open issues
Currently, the largest issues are:
- the examples and the presentation lack READMEs
Credits
The development of this course was financed by Asquera for the courses given at Linuxhotel.
They are open sourced as a contribution to the growth of the Rust language.
If you want to fund further development of the course, book a training!
Commercial use
This course is expressively intended for commercial and free use.
Trainers
Want to be on this list: open an issue and we will add you.