Struct PositionManager 

pub struct PositionManager { /* private fields */ }

Owns all positions and provides indexed access.

Implementations

impl PositionManager

pub fn new() -> Self

pub fn add(&mut self, position: Position)

Insert a position. Overwrites if the id already exists.

pub fn add_checked( &mut self, position: Position, ) -> Result<(), PositionManagerError>

Atomically insert a position after rejecting a duplicate non-empty trade ID.

Validation happens before any primary or secondary index mutation. The legacy Self::add API remains available for callers that require its historical last-write-wins behavior.

pub fn remove(&mut self, id: &str) -> Option<Position>

Remove a position by id.

pub fn get(&self, id: &str) -> Option<&Position>

Immutable lookup.

pub fn get_mut(&mut self, id: &str) -> Option<&mut Position>

Mutable lookup.

pub fn len(&self) -> usize

Total number of tracked positions (all statuses).

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> impl Iterator<Item = (&PositionId, &Position)>

Iterate over all positions.

pub fn iter_mut(&mut self) -> impl Iterator<Item = (&PositionId, &mut Position)>

Iterate mutably over all positions.

pub fn position_ids_sorted(&self) -> Vec<PositionId>

All position IDs in stable lexicographic order.

pub fn ids_by_symbol_status( &self, symbol: &str, status: PositionStatus, ) -> Vec<PositionId>

Collect ids of positions matching the given status and symbol.

pub fn ids_by_symbol_status_sorted( &self, symbol: &str, status: PositionStatus, ) -> Vec<PositionId>

Stable lexicographic variant of Self::ids_by_symbol_status.

pub fn ids_by_status(&self, status: PositionStatus) -> Vec<PositionId>

Collect ids of all positions with the given status.

pub fn ids_by_status_sorted(&self, status: PositionStatus) -> Vec<PositionId>

Stable lexicographic variant of Self::ids_by_status.

pub fn ids_by_symbol_side(&self, symbol: &str, side: Side) -> Vec<PositionId>

Collect ids of open positions on a given symbol with a given side.

pub fn ids_by_symbol_side_sorted( &self, symbol: &str, side: Side, ) -> Vec<PositionId>

Stable lexicographic variant of Self::ids_by_symbol_side.

pub fn open_positions(&self) -> Vec<&Position>

All open (active) positions.

pub fn pending_positions(&self) -> Vec<&Position>

All pending (unfilled) positions.

pub fn closed_positions(&self) -> Vec<&Position>

All closed positions.

pub fn open_ids_by_symbol(&self, symbol: &str) -> Vec<PositionId>

Collect ids of all open positions on a given symbol.

pub fn open_ids_by_symbol_sorted(&self, symbol: &str) -> Vec<PositionId>

Stable lexicographic variant of Self::open_ids_by_symbol.

pub fn pending_ids_by_symbol(&self, symbol: &str) -> Vec<PositionId>

Collect ids of all pending positions on a given symbol.

pub fn pending_ids_by_symbol_sorted(&self, symbol: &str) -> Vec<PositionId>

Stable lexicographic variant of Self::pending_ids_by_symbol.

pub fn ids_for_symbol(&self, symbol: &str) -> Vec<PositionId>

All position IDs for a symbol (any status), via the symbol index.

pub fn ids_for_symbol_sorted(&self, symbol: &str) -> Vec<PositionId>

Stable lexicographic variant of Self::ids_for_symbol.

pub fn add_group(&mut self, group: PositionGroup)

Create or update a position group.

pub fn get_group(&self, id: &str) -> Option<&PositionGroup>

Get a group by id.

pub fn add_to_group(&mut self, group_id: &str, position_id: PositionId)

Add a position to an existing group. Creates the group if it does not exist.

pub fn group_position_ids(&self, group_id: &str) -> Vec<PositionId>

Return all position ids belonging to a group.

pub fn remove_group(&mut self, group_id: &str) -> Option<PositionGroup>

Remove a group (does not close or remove the positions).

pub fn open_ids_by_group(&self, group_id: &str) -> Vec<PositionId>

All open position IDs in a group.

pub fn pending_ids_by_group(&self, group_id: &str) -> Vec<PositionId>

All pending position IDs in a group.

pub fn all_group_ids(&self) -> Vec<&GroupId>

All group IDs that currently exist.

pub fn all_group_ids_sorted(&self) -> Vec<&GroupId>

All group IDs in stable lexicographic order.

pub fn id_by_trade_id(&self, trade_id: &str) -> Option<PositionId>

Look up the position ID for a given application-defined trade id.

pub fn would_duplicate_trade_id( &self, position: &Position, ) -> Option<PositionId>

Return the current owner when adding position would duplicate a trade ID already assigned to a different position.

This is opt-in validation; Self::add intentionally retains its legacy last-write-wins trade-index behavior.

pub fn ensure_trade_id_available( &self, trade_id: &str, position_id: Option<&str>, ) -> Result<(), PositionManagerError>

Validate a non-empty trade ID without mutating manager state.

pub fn duplicate_trade_ids(&self) -> Vec<TradeId>

Find every trade ID currently present on more than one stored position. Results are stable and lexicographically sorted.

pub fn set_trade_id(&mut self, position_id: &str, trade_id: TradeId)

Update the trade_id mapping for a position (used when trade_id is attached after position creation, e.g. during scale-in).

pub fn set_trade_id_checked( &mut self, position_id: &str, trade_id: TradeId, ) -> Result<(), PositionManagerError>

Atomically attach a trade ID to a stored position and update the index.

pub fn open_ids_by_side(&self, side: Side) -> Vec<PositionId>

Collect ids of all open positions matching a side filter.

pub fn open_ids_by_side_sorted(&self, side: Side) -> Vec<PositionId>

Stable lexicographic variant of Self::open_ids_by_side.

pub fn all_open_ids(&self) -> Vec<PositionId>

Collect ids of all open positions regardless of symbol.

pub fn all_open_ids_sorted(&self) -> Vec<PositionId>

All open position IDs in stable lexicographic order.

pub fn all_pending_ids(&self) -> Vec<PositionId>

Collect ids of all pending positions regardless of symbol.

pub fn all_pending_ids_sorted(&self) -> Vec<PositionId>

All pending position IDs in stable lexicographic order.

Trait Implementations

impl Clone for PositionManager

fn clone(&self) -> PositionManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PositionManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PositionManager

fn default() -> PositionManager

Returns the “default value” for a type.