#![warn(missing_docs)]
#![forbid(unsafe_code)]
mod config;
mod error;
mod events;
mod request;
#[cfg(feature = "reqwest")]
mod reqwest_client;
mod response;
#[cfg(any(feature = "reqwest", feature = "ureq"))]
mod transport;
#[cfg(feature = "ureq")]
mod ureq_client;
pub use config::ClientConfig;
pub use error::Error;
pub use events::{EvaluationEvent, EvaluationFailure};
pub use futures_core::Stream;
pub use request::{NoulCriteria, Question, Request};
#[cfg(feature = "reqwest")]
pub use reqwest_client::{ReqwestClient, ReqwestError};
pub use response::{Answer, Response, Usage};
#[cfg(feature = "ureq")]
pub use ureq_client::{UreqClient, UreqError};
use std::future::Future;
pub trait AsyncClient {
type TransportError: std::error::Error + Send + Sync + 'static;
fn evaluate_events<'a>(
&'a self,
request: &'a Request,
) -> impl Stream<Item = EvaluationEvent<Self::TransportError>> + Send + 'a;
fn evaluate<'a>(
&'a self,
request: &'a Request,
) -> impl Future<Output = Result<Response, Error<Self::TransportError>>> + Send + 'a {
let events = self.evaluate_events(request);
async move {
let mut events = std::pin::pin!(events);
while let Some(event) =
std::future::poll_fn(|context| events.as_mut().poll_next(context)).await
{
if let Some(result) = event.into_result() {
return result;
}
}
Err(Error::IncompleteEvaluation)
}
}
}
pub trait SyncClient {
type TransportError: std::error::Error + Send + Sync + 'static;
fn evaluate_events(
&self,
request: &Request,
) -> impl Iterator<Item = EvaluationEvent<Self::TransportError>>;
fn evaluate(&self, request: &Request) -> Result<Response, Error<Self::TransportError>> {
for event in self.evaluate_events(request) {
if let Some(result) = event.into_result() {
return result;
}
}
Err(Error::IncompleteEvaluation)
}
}