1
0
mirror of https://github.com/google/comprehensive-rust.git synced 2024-12-16 23:08:36 +02:00
comprehensive-rust/src/welcome.md

45 lines
1.9 KiB
Markdown
Raw Normal View History

2022-12-21 17:36:30 +02:00
# Welcome to Comprehensive Rust 🦀
This is a four day Rust course developed by the Android team. The course covers
the full spectrum of Rust, from basic syntax to advanced topics like generics
and error handling. It also includes Android-specific content on the last day.
The goal of the course to teach you Rust. We assume you don't know anything
about Rust and hope to
* Give you a comprehensive understanding of the Rust syntax and language.
* Enable you to modify existing programs and write new programs in Rust.
* Show you common Rust idioms.
On Day 4, we will cover Android-specific things such as
* Building Android components in Rust.
* AIDL servers and clients.
* Interoperability with C, C++, and Java.
## Non-Goals
Rust is a large language and we won't be able to cover all it in a few days.
Some non-goals of this course are:
* Learn how to use async Rust --- we'll only talk a bit about async Rust when
covering traditional concurrency primitives. Please see [Asynchronous
Programming in Rust](https://rust-lang.github.io/async-book/) instead for
details on this topic.
* Learn how to develop macros, please see [Chapter 19.5 in the Rust
Book](https://doc.rust-lang.org/book/ch19-06-macros.html) and [Rust by
Example](https://doc.rust-lang.org/rust-by-example/macros.html) instead.
* Learn the details of how to write unsafe Rust. We will talk about unsafe Rust
on Day 3, but we go into the subtle details. Please see [Chapter 19.1 in the
Rust Book](https://doc.rust-lang.org/book/ch19-01-unsafe-rust.html) and the
[Rustonomicon](https://doc.rust-lang.org/nomicon/) instead.
## Assumptions
The course assumes that you already know how to program. Rust is a statically
typed language and we will sometimes make comparisons with C and C++ to better
explain or contrast the Rust approach.
If you know how to program in a dynamically typed language such as Python or
JavaScript, then you will be able to follow along just fine too.