Module planner 

Structs

PathPlanner

Path planner that resolves [DestinationRouting] to [ResolvedTransportRouting].

PathPlannerConfig

Configuration for PathPlanner’s internal path cache.

WeightingParams 🔒

Parameters that shape how per-path aggregates modulate the WeightedCollection weight.

Constants

MIN_SHARE_SHIFT 🔒

Smallest change in a candidate’s share of the draws that counts as traffic having moved.

Functions

capacity_factor 🔒

Continuous, monotonically increasing capacity factor, bounded in (0.05, 1.0].

composite_weight 🔒

Composite selection weight for a candidate path.

latency_factor 🔒

Continuous, monotonically decreasing latency factor, bounded in (0, 1].

pick_uniform_index 🔒

Picks a uniformly random index over len entries.

pick_weighted_index 🔒

Picks an index into weights with probability proportional to the weight; None if all are non-positive.

rebuild_candidates 🔒

Rebuilds the weighted candidate collection for one (source, destination, hops) triple from whatever the graph currently says.

shares_by_route 🔒

Each candidate’s share of the total weight, keyed by the route it takes.

should_explore 🔒

Whether this draw should explore — ignore the weights and pick uniformly.

temper_weights 🔒

Flattens weights by raising each to temper, compressing the spread between good and bad candidates without reordering them.

validate_unit_interval 🔒

validate_weight_temper 🔒

Rejects a temper exponent outside (0, 1].

weights_moved 🔒

Whether re-weighting would send a materially different share of the draws somewhere else.

Type Aliases

PlannerCacheKey 🔒

Cache key for the path planner: (source, destination, hops).

PlannerCacheValue 🔒