rust-development

name	rust_development
description	Rust systems programming, memory safety, Axum/Tokio ve WebAssembly rehberi.

🦀 Rust Development

Rust systems programming rehberi.

---

📋 Temel Syntax

// Variables
let x = 5;           // Immutable
let mut y = 10;      // Mutable

// Functions
fn add(a: i32, b: i32) -> i32 {
    a + b  // No semicolon = return
}

// Structs
struct User {
    name: String,
    age: u32,
}

// Enums
enum Status {
    Active,
    Inactive,
    Pending(String),
}

---

🔒 Ownership & Borrowing

// Ownership
let s1 = String::from("hello");
let s2 = s1;  // s1 moved to s2

// Borrowing
fn print(s: &String) {
    println!("{}", s);
}

// Mutable borrow
fn append(s: &mut String) {
    s.push_str(" world");
}

---

⚡ Axum Web Framework

use axum::{routing::get, Router, Json};
use serde::Serialize;

#[derive(Serialize)]
struct User { name: String }

async fn get_user() -> Json<User> {
    Json(User { name: "John".into() })
}

#[tokio::main]
async fn main() {
    let app = Router::new()
        .route("/user", get(get_user));
    
    axum::serve(listener, app).await.unwrap();
}

---

🔄 Async with Tokio

use tokio;

#[tokio::main]
async fn main() {
    let result = fetch_data().await;
}

async fn fetch_data() -> String {
    tokio::time::sleep(Duration::from_secs(1)).await;
    "data".to_string()
}

---

🎯 Error Handling

use anyhow::Result;
use thiserror::Error;

#[derive(Error, Debug)]
enum AppError {
    #[error("Not found: {0}")]
    NotFound(String),
}

fn find_user(id: &str) -> Result<User> {
    // Returns Result with anyhow
    Ok(user)
}

---

Rust Development v1.1 - Enhanced

🔄 Workflow

Kaynak: Rust API Guidelines & Zero To Production in Rust

Aşama 1: Project Setup & Structure

• Workspace: Büyük projeler için Cargo Workspace yapısını kur (Monorepo).
• Linter: clippy'yi en sıkı modda (-D warnings) çalıştıracak şekilde CI pipeline'ına ekle.
• Dependency Management: cargo-deny ile lisans ve güvenlik kontrolü yap.

Aşama 2: Implementation Patterns

• Error Handling: Kütüphaneler için thiserror, uygulamalar için anyhow kullan. Asla unwrap() kullanma (testler hariç).
• Async Runtime: Web sunucuları için tokio ve axum (veya actix-web) standartını benimse.
• Type Safety: "Newtype Pattern" kullanarak primitive obsession'dan kaçın (struct UserId(Uuid)).

Aşama 3: Performance & Reliability

• Tracing: tracing ve tracing-subscriber ile structured logging kur. println! kullanma.
• Benchmarks: Kritik fonksiyonlar için criterion ile benchmark testleri yaz.
• Release Profile: Production build için Cargo.toml içinde lto = true ve codegen-units = 1 ayarlarını yap.

Kontrol Noktaları

Aşama	Doğrulama
1	cargo clippy hatasız geçiyor mu? ve cargo fmt uygulandı mı?
2	Tüm public API'ler dökümante edildi mi? (/// doc comments).
3	Docker imajı distroless veya alpine tabanlı optimize edildi mi?