bityard Wiki

Trace:
A word from our sponsors

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
prog:rust:intro [2024/06/24 06:09] – created Frank Fegertprog:rust:intro [2024/06/24 12:48] (current) – Frank Fegert
Line 1: Line 1:
 ====== Introduction ====== ====== Introduction ======
  
-FIXME+[[wp>Rust_(programming_language)|Rust]] is a multi-paradigm, general-purpose programming language that emphasizes performance, type safety, and concurrency. It enforces memory safety-meaning that all references point to valid memory-without a garbage collector. To simultaneously enforce memory safety and prevent data races, its "borrow checker" tracks the object lifetime of all references in a program during compilation.
  
-====== Links ======+Rust was influenced by ideas from functional programming, including immutability, higher-order functions, and algebraic data types. It is popular for systems programming.
  
-FIXME+Software developer Graydon Hoare created Rust as a personal project while working at Mozilla Research in 2006. Mozilla officially sponsored the project in 2009. In the years following the first stable release in May 2015, Rust was adopted by companies including Amazon, Discord, Dropbox, Google (Alphabet), Meta, and Microsoft. In December 2022, it became the first language other than C and assembly to be supported in the development of the Linux kernel. 
 + 
 +Rust has been noted for its rapid adoption, and has been studied in programming language theory research. 
 + 
 +====== Links ======
  
 ===== General ===== ===== General =====
  
-FIXME+[[https://www.rust-lang.org/]]\\ 
 +https://www.rust-lang.org/learn|Rust Documentation - Learning Rust]]\\ 
 +[[https://www.rust-lang.org/learn/get-started|Rust Documentation - Getting started]]\\ 
 +[[https://crates.io|The Rust community’s crate registry]]\\
  
 /* [[]]\\ */ /* [[]]\\ */
Line 16: Line 23:
  
 FIXME FIXME
 +
 +====== Articles ======
 +
 +[[https://www.linux-magazin.de/ausgaben/2023/01/planet-rust-folge-1/|Linux-Magazin 01/2023 - Page ?? - Planet Rust – Episode 1: Einstieg in Rust]]\\
  
 ====== Files and Directories ====== ====== Files and Directories ======
Line 30: Line 41:
  
 ====== Getting Help ====== ====== Getting Help ======
- 
-FIXME 
  
 Manual pages:  Manual pages: 
  
 <cli> <cli>
-user@host:~$ +user@host:~$ man 1 rustc 
 +user@host:~$ man 1 rustdoc 
 +user@host:~$ man 1 cargo 
 +user@host:~$ man 1 cargo-<SUBCOMMAND> 
 +</cli> 
 + 
 +Builtin //Cargo// help:  
 + 
 +<cli> 
 +user@host:~$ cargo help 
 +user@host:~$ cargo help <SUBCOMMAND> 
 +user@host:~$ cargo <SUBCOMMAND> --help
 </cli> </cli>
  
 ====== Install ====== ====== Install ======
  
-FIXME+To install //Rust// and its build toolchain and package manager //Cargo// on Debian: 
 + 
 +<cli> 
 +root@host:~$ apt-get -y install rustc cargo 
 +</cli> 
  
-To install //// on Debian: +To install //Rust// and its build toolchain and package manager //Cargo// from a more recent version on Debian:
  
 <cli> <cli>
-root@host:~$ +root@host:~$ apt-get -y install rustc-mozilla cargo-mozilla
 </cli>  </cli> 
  
Line 54: Line 78:
  
 ====== Usage ====== ====== Usage ======
 +
 +===== Creating a new project =====
 +
 +<cli>
 +user@host:~$ cargo new hello_world
 +</cli> 
 +
 +===== Compile and run a project =====
 +
 +Compile and run a project *with* debugging information:
 +
 +<cli>
 +user@host:~$ cd hello_world
 +user@host:~/hello_world$ cargo run
 +user@host:~/hello_world$ du -sm target/debug/hello_world
 +</cli> 
 +
 +Compile and run a project *optimized* and *without* debugging information:
 +
 +<cli>
 +user@host:~/hello_world$ cargo run --release
 +</cli> 
 +
 +===== Clean a project =====
 +
 +Clean a project from the artefacts of a previous compile and run:
 +
 +<cli>
 +user@host:~/hello_world$ cargo clean
 +</cli> 
 +
 +===== Add a dependency to a project =====
 +
 +Add a external library dependency to a project. E.g. ''ferris-says'':
 +
 +<cli>
 +user@host:~/hello_world$ cargo add ferris-says
 +</cli> 
 +
 +Manually add a external library dependency to a project. E.g. ''ferris-says'':
 +
 +<cli>
 +user@host:~/hello_world$ vi Cargo.toml
 +</cli> 
 +
 +File contents:
 +
 +<file config hello_world/Cargo.toml>
 +[...]
 +
 +[dependencies]
 +ferris-says = "0.2.1"
 +</file>
 +
 +Update the projects main code:
 +
 +<cli>
 +user@host:~/hello_world$ vi src/main.rs
 +</cli> 
 +
 +File contents:
 +
 +<file config hello_world/src/main.rs>
 +use ferris_says::say;
 +use std::io::{stdout, BufWriter};
 +
 +fn main() {
 +    let stdout = stdout();
 +    let message = b"Hello fellow Rustaceans!";
 +    let width = 24;
 +
 +    let mut writer = BufWriter::new(stdout.lock());
 +    say(message, width, &mut writer).unwrap();
 +}
 +</file>
 +
 +Compile and run the updated project:
 +
 +<cli>
 +user@host:~/hello_world$ cargo run
 +</cli> 
 +
 +===== Set a dependency to a specific version in a project =====
 +
 +Set a first and second level dependency to a specific version in a project:
 +
 +<cli>
 +user@host:~/hello_world$ cargo update -p unicode-width --precise 0.1.7 
 +user@host:~/hello_world$ cargo update -p smawk --precise 0.3.0
 +</cli> 
  
 FIXME FIXME

Page Tools

prog/rust/intro.1719209362.txt.gz · Last modified: 2024/06/24 06:09 by Frank Fegert
CC Attribution-Noncommercial-Share Alike 4.0 International Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International