Skip to main content

eggfetch_core/
lib.rs

1//! Async-first HTTP client engine for eggfetch.
2//!
3//! This crate is the single owner of HTTP behavior. The CLI and Python
4//! bindings are thin adapters that delegate to it.
5//!
6//! # Example
7//!
8//! ```no_run
9//! # async fn example() -> eggfetch_core::Result<()> {
10//! use eggfetch_core::Client;
11//!
12//! let client = Client::new();
13//! let mut response = client
14//!     .get("https://example.com")?
15//!     .header("user-agent", "eggfetch")
16//!     .query("q", "test")
17//!     .send()
18//!     .await?;
19//!
20//! assert!(response.status().is_success());
21//! let bytes = response.bytes().await?;
22//! # Ok(())
23//! # }
24//! ```
25
26#![deny(missing_docs)]
27
28pub mod auth;
29pub mod body;
30pub mod client;
31pub mod compression;
32#[cfg(feature = "cookies")]
33pub mod cookie;
34pub mod error;
35mod h2_headers;
36pub mod headers;
37pub mod http_version;
38pub mod limits;
39#[cfg(feature = "multipart")]
40pub mod multipart;
41pub mod network_stream;
42pub(crate) mod pipeline;
43pub mod pool;
44#[cfg(feature = "proxy")]
45pub mod proxy;
46pub mod redact;
47pub mod redirect;
48pub mod request;
49pub mod response;
50pub(crate) mod response_decode;
51pub mod retry;
52pub mod service;
53pub(crate) mod stream;
54pub mod timeout;
55#[cfg(feature = "tls-rustls")]
56pub mod tls;
57pub mod trace;
58pub mod transport;
59
60pub use auth::{AuthScheme, BasicAuth, BearerAuth};
61pub use body::{BoxBytesStream, NativeResponseBody, RequestBody, ResponseBody, SharedTrailers};
62pub use client::{Client, ClientBuilder};
63pub use compression::{accept_encoding_value, ContentCoding};
64pub use error::{Error, NetworkFailureKind, RequestFailure, Result};
65pub use headers::Headers;
66pub use http::Method;
67pub use http_version::HttpVersionPolicy;
68pub use limits::Limits;
69#[cfg(feature = "multipart")]
70pub use multipart::{Boundary, Multipart, MultipartEncoder, Part, PartBody};
71pub use network_stream::{
72    ConnectionMetadata, ExtraInfo, NetworkStream, TlsInfo, TransportKind, UpgradedStream,
73    UpgradedStreamVariant,
74};
75pub use pool::{Pool, PoolConfig};
76#[cfg(feature = "proxy")]
77pub use proxy::{
78    NoProxy, NoProxyRule, Proxy, ProxyAuth, ProxyConfig, ProxyDecision, ProxyEnvironment, ProxyRule,
79};
80pub use redact::{
81    is_sensitive_header, redact_headers, redact_url, redact_url_string, SENSITIVE_HEADERS,
82};
83pub use redirect::{
84    build_redirect_request_with_redirect_policy, check_https_downgrade, is_https_downgrade,
85    RedirectDowngradePolicy, RedirectPolicy,
86};
87pub use request::{
88    NativeRequestOptions, ProxyOverride, Request, RequestBuilder, ResolvedTarget, TransportHints,
89};
90pub use response::{HistoryEntry, Response};
91pub use retry::{
92    BackoffPolicy, MethodPolicy, ReplayCheck, RetryCause, RetryContext, RetryPolicy,
93    RetryPolicyBuilder, StatusPolicy,
94};
95pub use service::NativeHttpService;
96pub use timeout::{Timeout, TimeoutBuilder, TimeoutPhase};
97#[cfg(feature = "tls-rustls")]
98pub use tls::{ClientIdentity, TlsConfig, TlsConfigBuilder, TlsVersion, TrustStore};
99pub use transport::dialer::{DialError, DialErrorKind, DialFuture, DialStream, DialTarget, Dialer};
100/// Socket option for direct TCP connections.
101pub use transport::direct_connector::{SocketOption, SocketOptionKind};
102pub use transport::lifecycle::{
103    PhysicalConnectionPolicy, TransportIoDirection, TransportIoTimeout,
104};
105#[cfg(feature = "http3")]
106pub use transport::metrics::{H3CloseKind, H3CloseSummary, H3ConnectionDiagnostic, H3RouteKind};
107pub use transport::metrics::{TransportMetrics, TransportSnapshot};