praborrow-logistics 0.9.2

Zero-copy buffer abstraction. Handles raw byte streams without allocation overhead.
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# Praborrow Logistics


Zero-copy data abstraction layer for the "Hilirisasi" pipeline. Handles the refinement of raw byte streams into downstream-ready resources without unnecessary cloning or allocation overhead.

## RawResource


Provides a stable pointer/length view into a byte vector. Uses `ManuallyDrop` to ensure the underlying buffer is not deallocated while the resource is active, strictly adhering to zero-copy principles during refinement.

### Usage


```rust
use praborrow_logistics::RawResource;

let data = vec![0xDE, 0xAD, 0xBE, 0xEF];
let resource = RawResource::refine(data);

// Access via safe getters
assert_eq!(resource.len(), 4);

// Access raw bytes (unsafe)
unsafe {
    let slice = resource.as_slice();
    assert_eq!(slice[0], 0xDE);
}
```

### Safety


This crate facilitates raw pointer manipulation. The caller is responsible for ensuring the lifetime of the `RawResource` does not violate memory safety guarantees of the consumptive system.

---

# Praborrow Logistics (Bahasa Indonesia)


Layer abstraksi data zero-copy untuk pipeline "Hilirisasi". Menangani pemurnian (refinement) aliran byte mentah (raw byte streams) menjadi sumber daya yang siap digunakan di hilir tanpa overhead cloning atau alokasi yang tidak perlu.

## RawResource


Menyediakan tampilan pointer/panjang yang stabil ke dalam vektor byte. Menggunakan `ManuallyDrop` untuk memastikan buffer yang mendasarinya tidak dialokasikan kembali saat sumber daya sedang aktif, dengan ketat mematuhi prinsip zero-copy selama proses pemurnian.

### Penggunaan (Usage)


```rust
use praborrow_logistics::RawResource;

let data = vec![0xDE, 0xAD, 0xBE, 0xEF];
let resource = RawResource::refine(data);

// Akses melalui getter yang aman
assert_eq!(resource.len(), 4);

// Akses byte mentah (unsafe)
unsafe {
    let slice = resource.as_slice();
    assert_eq!(slice[0], 0xDE);
}
```

### Keamanan (Safety)


Crate ini memfasilitasi manipulasi pointer mentah. Pemanggil bertanggung jawab untuk memastikan masa pakai (lifetime) dari `RawResource` tidak melanggar jaminan keamanan memori dari sistem konsumtif.