praborrow-core 1.2.2

Core primitives for PraBorrow. Implements Sovereign<T> for distributed ownership enforcement.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# Praborrow Core (Bahasa Indonesia)


[English](./README.md) | Indonesia

Primitif inti untuk framework sistem terdistribusi PraBorrow. Crate ini menyediakan tipe dasar untuk menegakkan semantik kepemilikan kedaulatan (sovereign ownership) lintas batas jaringan.

## Sovereign<T>


Wrapper `Sovereign<T>` mengimplementasikan state machine yang berbeda untuk kepemilikan data:
- **Domestic (Domestik)**: Data bersifat lokal dan dapat diakses melalui `Deref`.
- **Exiled (Diasingkan)**: Data telah dipindahkan ke node jarak jauh (remote). Upaya akses akan memicu panic (atau mengembalikan `Err` dengan `try_get`).

### Penggunaan (Usage)


```rust
use praborrow_core::{Sovereign, SovereigntyError};

let data = Sovereign::new(42);

// Akses diizinkan (Domestic)
assert_eq!(*data, 42);

// Akses aman dengan penanganan error (v0.5+)
assert!(data.try_get().is_ok());

// Transisi status
data.annex().expect("Gagal melakukan aneksasi sumber daya");

// Penanganan error yang anggun alih-alih panic
match data.try_get() {
    Ok(_) => unreachable!(),
    Err(SovereigntyError::ForeignJurisdiction) => println!("Diasingkan (Exiled)!"),
}
```

### Keamanan Thread (Thread Safety)


Menggunakan `AtomicU8` untuk pelacakan status, memastikan kepatuhan `Send + Sync` di mana `T: Send + Sync`.