* webui: Move static build output from `tools/server/public` to `build/ui` directory * refactor: Move to `tools/ui` * refactor: rename CMake variables and preprocessor defines - Rename LLAMA_BUILD_WEBUI -> LLAMA_BUILD_UI (old kept as deprecated) - Rename LLAMA_USE_PREBUILT_WEBUI -> LLAMA_USE_PREBUILT_UI (old kept as deprecated) - Backward compat: old vars auto-forward to new ones with DEPRECATION warning - Rename internal vars: WEBUI_SOURCE -> UI_SOURCE, WEBUI_SOURCE_DIR -> UI_SOURCE_DIR, etc. - Rename HF bucket: LLAMA_WEBUI_HF_BUCKET -> LLAMA_UI_HF_BUCKET - Emit both LLAMA_BUILD_WEBUI and LLAMA_BUILD_UI preprocessor defines - Emit both LLAMA_WEBUI_DEFAULT_ENABLED and LLAMA_UI_DEFAULT_ENABLED * refactor: rename CLI flags (--webui -> --ui) with backward compat - Add --ui/--no-ui (old --webui/--no-webui kept as deprecated aliases) - Add --ui-config (old --webui-config kept as deprecated alias) - Add --ui-config-file (old --webui-config-file kept as deprecated alias) - Add --ui-mcp-proxy/--no-ui-mcp-proxy (old --webui-mcp-proxy kept as deprecated) - Add new env vars: LLAMA_ARG_UI, LLAMA_ARG_UI_CONFIG, LLAMA_ARG_UI_CONFIG_FILE, LLAMA_ARG_UI_MCP_PROXY - C++ struct fields: params.ui, params.ui_config_json, params.ui_mcp_proxy added alongside old fields - Backward compat: old fields synced to new ones in g_params_to_internals * refactor: update C++ server internals with backward compat - Rename json_webui_settings -> json_ui_settings (both kept in server_context_meta) - Rename params.webui usage -> params.ui (both synced, old still works) - JSON API emits both "ui"/"ui_settings" and "webui"/"webui_settings" keys - Server routes use params.ui_mcp_proxy || params.webui_mcp_proxy - Preprocessor guards use #if defined(LLAMA_BUILD_UI) || defined(LLAMA_BUILD_WEBUI) * refactor: rename CI/CD workflows, artifacts, and build script - Rename webui-build.yml -> ui-build.yml; artifact webui-build -> ui-build - Rename webui-publish.yml -> ui-publish.yml; var HF_BUCKET_WEBUI_STATIC_OUTPUT -> HF_BUCKET_UI_STATIC_OUTPUT - Rename server-webui.yml -> server-ui.yml; job webui-build/checks -> ui-build/checks - Update server.yml: job/artifact refs webui-build -> ui-build - Update release.yml: all webui-build/publish refs -> ui-build/publish; HF_TOKEN_WEBUI_STATIC_OUTPUT -> HF_TOKEN_UI_STATIC_OUTPUT - Update server-self-hosted.yml: webui-build -> ui-build - Update build-self-hosted.yml: HF_WEBUI_VERSION -> HF_UI_VERSION - Rename webui-download.cmake -> ui-download.cmake (internal refs updated) - Update labeler.yml: server/webui -> server/ui path label * docs: update CODEOWNERS and server README docs - Update CODEOWNERS: team ggml-org/llama-webui -> ggml-org/llama-ui, path /tools/server/webui/ -> /tools/ui/ - Update server README.md: CLI tables show --ui flags with deprecated --webui aliases - Update server README-dev.md: "WebUI" -> "UI", paths updated to tools/ui/ * fix: Small fixes for UI build * fix: CMake.txt syntax * chore: Formatting * fix: `.editorconfig` for llama-ui * chore: Formatting * refactor: Use `APP_NAME` in Error route * refactor: Cleanup * refactor: Single migration service * make llama-ui a linkable target * fix: UI Build output * fix: Missing change * fix: separate llama-ui npm build output into build/tools/ui/dist subfolder + use cmake npm build instead of downloading ui-build.yml artifacts in CI * refactor: UI workflows cleanup --------- Co-authored-by: Xuan Son Nguyen <son@huggingface.co>
126 lines
3.1 KiB
TypeScript
126 lines
3.1 KiB
TypeScript
// Blog Post Content
|
|
export const BLOG_POST_MD = String.raw`
|
|
# Understanding Rust's Ownership System
|
|
|
|
*Published on March 15, 2024 • 8 min read*
|
|
|
|
Rust's ownership system is one of its most distinctive features, enabling memory safety without garbage collection. In this post, we'll explore how ownership works and why it's revolutionary for systems programming.
|
|
|
|
## What is Ownership?
|
|
|
|
Ownership is a set of rules that governs how Rust manages memory. These rules are checked at compile time, ensuring memory safety without runtime overhead.
|
|
|
|
### The Three Rules of Ownership
|
|
|
|
1. **Each value has a single owner**
|
|
2. **There can only be one owner at a time**
|
|
3. **When the owner goes out of scope, the value is dropped**
|
|
|
|
## Memory Management Without GC
|
|
|
|
Traditional approaches to memory management:
|
|
|
|
- **Manual management** (C/C++): Error-prone, leads to bugs
|
|
- **Garbage collection** (Java, Python): Runtime overhead
|
|
- **Ownership** (Rust): Compile-time safety, zero runtime cost
|
|
|
|
## Basic Examples
|
|
|
|
### Variable Scope
|
|
|
|
${'```'}rust
|
|
fn main() {
|
|
let s = String::from("hello"); // s comes into scope
|
|
|
|
// s is valid here
|
|
println!("{}", s);
|
|
|
|
} // s goes out of scope and is dropped
|
|
${'```'}
|
|
|
|
### Move Semantics
|
|
|
|
${'```'}rust
|
|
fn main() {
|
|
let s1 = String::from("hello");
|
|
let s2 = s1; // s1 is moved to s2
|
|
|
|
// println!("{}", s1); // ❌ ERROR: s1 is no longer valid
|
|
println!("{}", s2); // ✅ OK: s2 owns the string
|
|
}
|
|
${'```'}
|
|
|
|
## Borrowing and References
|
|
|
|
Instead of transferring ownership, you can **borrow** values:
|
|
|
|
### Immutable References
|
|
|
|
${'```'}rust
|
|
fn calculate_length(s: &String) -> usize {
|
|
s.len() // s is a reference, doesn't own the String
|
|
}
|
|
|
|
fn main() {
|
|
let s1 = String::from("hello");
|
|
let len = calculate_length(&s1); // Borrow s1
|
|
println!("Length of '{}' is {}", s1, len); // s1 still valid
|
|
}
|
|
${'```'}
|
|
|
|
### Mutable References
|
|
|
|
${'```'}rust
|
|
fn main() {
|
|
let mut s = String::from("hello");
|
|
|
|
let r1 = &mut s;
|
|
r1.push_str(", world");
|
|
println!("{}", r1);
|
|
|
|
// let r2 = &mut s; // ❌ ERROR: cannot borrow twice
|
|
}
|
|
${'```'}
|
|
|
|
## Common Pitfalls
|
|
|
|
### Dangling References
|
|
|
|
${'```'}rust
|
|
fn dangle() -> &String { // ❌ ERROR: missing lifetime specifier
|
|
let s = String::from("hello");
|
|
&s // s will be dropped, leaving a dangling reference
|
|
}
|
|
${'```'}
|
|
|
|
### ✅ Solution
|
|
|
|
${'```'}rust
|
|
fn no_dangle() -> String {
|
|
let s = String::from("hello");
|
|
s // Ownership is moved out
|
|
}
|
|
${'```'}
|
|
|
|
## Benefits
|
|
|
|
- ✅ **No null pointer dereferences**
|
|
- ✅ **No data races**
|
|
- ✅ **No use-after-free**
|
|
- ✅ **No memory leaks**
|
|
|
|
## Conclusion
|
|
|
|
Rust's ownership system eliminates entire classes of bugs at compile time. While it has a learning curve, the benefits in safety and performance are worth it.
|
|
|
|
## Further Reading
|
|
|
|
- [The Rust Book - Ownership](https://doc.rust-lang.org/book/ch04-00-understanding-ownership.html)
|
|
- [Rust by Example - Ownership](https://doc.rust-lang.org/rust-by-example/scope/move.html)
|
|
- [Rustlings Exercises](https://github.com/rust-lang/rustlings)
|
|
|
|
---
|
|
|
|
*Questions? Reach out on [Twitter](https://twitter.com/rustlang) or join the [Rust Discord](https://discord.gg/rust-lang)*
|
|
`;
|