sector

A stateful vector implementation that provides different memory management behaviors through Rust traits and state machines.

Table of Contents

• About
• Features
• States
• Usage
• Documentation
• Contributing
• Roadmap
• Licenses

About

sector is a Rust library that provides a stateful vector structure (Sector<State, T>) with choosable memory allocation strategies.
Unlike Vec<T>, it allows developers to control how memory grows/shrinks.

[!NOTE] This library is under active development. Expect changes and optimizations.

Features

• Stateful Memory Management – Control memory allocation behavior dynamically.

• Lightweight & Fast – Minimal overhead while allowing full customization.

• No Std Support (Planned) – Future support for #![no_std] environments.

States

Sector has 6 different states:

• Normal Acts like the normal std::vec::Vec<T>.
• Dynamic Grows the internal capacity by a factor of 2. Shrinks to 3/4 of the original capacity
• Fixed Is not able to grow nor shrink. Returns false if the capacity is full and you try to add elements.
• Locked Does not allow to add or remove elements, regardless of the inner capacity.
• Manual Requires you to grow and shrink the inner capacity manually.
• Tight The inner capacity is exactly as large as the length

[!WARNING] Be careful! Zero Sized Types are treated differently by each state. Refer to the specific documentation of each state

Usage

Add sector as a dependency in your Cargo.toml:

[dependencies]
sector = "0.1"

Basic Example

use sector::{states::Normal, Sector};

fn main() {
    let mut sec: Sector<Normal, _> = Sector::new();
    sec.push(10);
    sec.push(20);

    // Access elements
    println!("First element: {:?}", sec.get(0));
}

Documentation

Generate docs locally:

cargo doc --open

Or visit the documentation online:

docs.rs

Contributing

Contributions are welcome!

Roadmap

• Basic stateful vector implementation
• Capacity management
• no_std support
• Benchmarks & optimizations

License

This project is dual licensed:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)