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
46pub mod routing;
47
48/// MCP (Model Context Protocol) server — exposes proxy pool tools
49#[cfg(feature = "mcp")]
50pub mod mcp;
51
52// Top-level re-exports
53pub use circuit_breaker::{CircuitBreaker, STATE_CLOSED, STATE_HALF_OPEN, STATE_OPEN};
54pub use error::{ProxyError, ProxyResult};
55pub use fetcher::{
56    FreeApiProxiesFetcher, FreeListFetcher, FreeListSource, ProxyFetcher, load_from_fetcher,
57};
58pub use health::{HealthChecker, HealthMap};
59pub use manager::{PoolStats, ProxyHandle, ProxyManager, ProxyManagerBuilder};
60pub use session::{SessionMap, StickyPolicy};
61pub use storage::MemoryProxyStore;
62pub use strategy::{
63    BoxedRotationStrategy, LeastUsedStrategy, ProxyCandidate, RandomStrategy, RotationStrategy,
64    RoundRobinStrategy, WeightedStrategy, capable_healthy_candidates,
65};
66pub use types::{
67    CapabilityRequirement, ProfiledRequestMode, Proxy, ProxyCapabilities, ProxyConfig,
68    ProxyMetrics, ProxyRecord, ProxyType, RoutingPath,
69};
70
71#[cfg(feature = "graph")]
72pub use graph::{BoxedProxyManager, NoopProxyManager, ProxyManagerPort};
73
74#[cfg(feature = "browser")]
75pub use browser::{BrowserProxySource, ProxyManagerBridge};
76
77#[cfg(feature = "tls-profiled")]
78pub use http_client::{ProfiledRequester, ProfiledRequesterError};
stygian_proxy/lib.rs

stygian_proxy/
lib.rs
