stygian_proxy/
lib.rs

1//! # stygian-proxy
2#![allow(clippy::multiple_crate_versions)]
3//!
4//! High-performance, resilient proxy rotation for the Stygian scraping ecosystem.
5//!
6//! ## Features
7//!
8//! - Pluggable rotation strategies: round-robin, random, weighted, least-used
9//! - Per-proxy latency and success-rate tracking via atomics
10//! - Async health checker with configurable intervals
11//! - Per-proxy circuit breaker (`Closed -> Open -> HalfOpen`)
12//! - In-memory proxy pool (no external DB required)
13//! - `graph` feature: [`ProxyManagerPort`] trait for stygian-graph HTTP adapters
14//! - `browser` feature: per-context proxy binding for stygian-browser
15//!
16//! ## Quick start
17//!
18//! ```rust,no_run
19//! use stygian_proxy::error::ProxyResult;
20//!
21//! fn main() -> ProxyResult<()> {
22//!     // ProxyManager construction added in T12 (proxy-manager task)
23//!     Ok(())
24//! }
25//! ```
26
27pub mod circuit_breaker;
28pub mod error;
29pub mod fetcher;
30pub mod health;
31pub mod manager;
32pub mod session;
33pub mod storage;
34pub mod strategy;
35pub mod types;
36
37#[cfg(feature = "graph")]
38pub mod graph;
39
40#[cfg(feature = "browser")]
41pub mod browser;
42
43#[cfg(feature = "tls-profiled")]
44pub mod http_client;
45
46/// MCP (Model Context Protocol) server — exposes proxy pool tools
47#[cfg(feature = "mcp")]
48pub mod mcp;
49
50// Top-level re-exports
51pub use circuit_breaker::{CircuitBreaker, STATE_CLOSED, STATE_HALF_OPEN, STATE_OPEN};
52pub use error::{ProxyError, ProxyResult};
53pub use fetcher::{FreeListFetcher, FreeListSource, ProxyFetcher, load_from_fetcher};
54pub use health::{HealthChecker, HealthMap};
55pub use manager::{PoolStats, ProxyHandle, ProxyManager, ProxyManagerBuilder};
56pub use session::{SessionMap, StickyPolicy};
57pub use storage::MemoryProxyStore;
58pub use strategy::{
59    BoxedRotationStrategy, LeastUsedStrategy, ProxyCandidate, RandomStrategy, RotationStrategy,
60    RoundRobinStrategy, WeightedStrategy,
61};
62pub use types::{ProfiledRequestMode, Proxy, ProxyConfig, ProxyMetrics, ProxyRecord, ProxyType};
63
64#[cfg(feature = "graph")]
65pub use graph::{BoxedProxyManager, NoopProxyManager, ProxyManagerPort};
66
67#[cfg(feature = "browser")]
68pub use browser::{BrowserProxySource, ProxyManagerBridge};
69
70#[cfg(feature = "tls-profiled")]
71pub use http_client::{ProfiledRequester, ProfiledRequesterError};
stygian_proxy/lib.rs

stygian_proxy/
lib.rs
