Expand description
§stygian-proxy
High-performance, resilient proxy rotation for the Stygian scraping ecosystem.
§Features
- Pluggable rotation strategies: round-robin, random, weighted, least-used
- Per-proxy latency and success-rate tracking via atomics
- Async health checker with configurable intervals
- Per-proxy circuit breaker (Closed → Open → HalfOpen)
- In-memory proxy pool (no external DB required)
graphfeature: [ProxyManagerPort] trait for stygian-graph HTTP adaptersbrowserfeature: per-context proxy binding for stygian-browser
§Quick start
use stygian_proxy::error::ProxyResult;
fn main() -> ProxyResult<()> {
// ProxyManager construction added in T12 (proxy-manager task)
Ok(())
}Re-exports§
pub use circuit_breaker::CircuitBreaker;pub use circuit_breaker::STATE_CLOSED;pub use circuit_breaker::STATE_HALF_OPEN;pub use circuit_breaker::STATE_OPEN;pub use error::ProxyError;pub use error::ProxyResult;pub use health::HealthChecker;pub use health::HealthMap;pub use manager::PoolStats;pub use manager::ProxyHandle;pub use manager::ProxyManager;pub use manager::ProxyManagerBuilder;pub use storage::MemoryProxyStore;pub use strategy::BoxedRotationStrategy;pub use strategy::LeastUsedStrategy;pub use strategy::ProxyCandidate;pub use strategy::RandomStrategy;pub use strategy::RotationStrategy;pub use strategy::RoundRobinStrategy;pub use strategy::WeightedStrategy;pub use types::Proxy;pub use types::ProxyConfig;pub use types::ProxyMetrics;pub use types::ProxyRecord;pub use types::ProxyType;
Modules§
- circuit_
breaker - Per-proxy circuit breaker.
- error
- health
- Async background health checker for proxy liveness verification.
- manager
- ProxyManager: unified proxy pool orchestrator.
- storage
- Storage port and in-memory adapter for proxy records.
- strategy
- Proxy rotation strategy trait and built-in implementations.
- types
- Core domain types for proxy management.