refactor(net): remove inner from Net

This commit is contained in:
Paul Campbell 2024-11-11 07:44:43 +00:00
parent 3c50dbd414
commit 989233a2ca
3 changed files with 128 additions and 186 deletions

View file

@ -147,6 +147,6 @@ mod tests {
// not needed for this test, but should it be needed, we can avoid checking for any // not needed for this test, but should it be needed, we can avoid checking for any
// unconsumed request matches. // unconsumed request matches.
let mock_net = kxio::net::MockNet::try_from(net).expect("recover mock"); let mock_net = kxio::net::MockNet::try_from(net).expect("recover mock");
mock_net.reset().expect("reset mock"); mock_net.reset();
} }
} }

View file

@ -1,23 +1,10 @@
// //
use std::{marker::PhantomData, sync::RwLock}; use std::cell::RefCell;
use reqwest::Client; use reqwest::Client;
use super::{Error, Result}; use super::{Error, Result};
/// Marker trait used to identify whether a [Net] is mocked or not.
pub trait NetType {}
/// Marker struct that indicates that a [Net] is a mock.
#[derive(Debug)]
pub struct Mocked;
impl NetType for Mocked {}
/// Market struct that indicates that a [Net] is not mocked.
#[derive(Debug)]
pub struct Unmocked;
impl NetType for Unmocked {}
/// A list of planned requests and responses /// A list of planned requests and responses
type Plans = Vec<Plan>; type Plans = Vec<Plan>;
@ -48,24 +35,19 @@ struct Plan {
} }
/// An abstraction for the network /// An abstraction for the network
#[derive(Debug)]
pub struct Net { pub struct Net {
inner: InnerNet<Unmocked>, plans: Option<RefCell<Plans>>,
mock: Option<InnerNet<Mocked>>,
} }
impl Net { impl Net {
/// Creates a new unmocked [Net] for creating real network requests. /// Creates a new unmocked [Net] for creating real network requests.
pub(super) const fn new() -> Self { pub(super) const fn new() -> Self {
Self { Self { plans: None }
inner: InnerNet::<Unmocked>::new(),
mock: None,
}
} }
/// Creats a new [MockNet] for use in tests. /// Creats a new [MockNet] for use in tests.
pub(super) const fn mock() -> MockNet { pub(super) const fn mock() -> MockNet {
MockNet { MockNet {
inner: InnerNet::<Mocked>::new(), plans: RefCell::new(vec![]),
} }
} }
} }
@ -107,17 +89,46 @@ impl Net {
&self, &self,
request: impl Into<reqwest::RequestBuilder>, request: impl Into<reqwest::RequestBuilder>,
) -> Result<reqwest::Response> { ) -> Result<reqwest::Response> {
match &self.mock { let Some(plans) = &self.plans else {
Some(mock) => mock.send(request).await, return request.into().send().await.map_err(Error::from);
None => self.inner.send(request).await, };
} let request = request.into().build()?;
} let index = plans.borrow().iter().position(|plan| {
} // METHOD
impl Default for Net { (if plan.match_on.contains(&MatchOn::Method) {
fn default() -> Self { plan.request.method() == request.method()
Self { } else {
inner: InnerNet::<Unmocked>::new(), true
mock: None, })
// URL
&& (if plan.match_on.contains(&MatchOn::Url) {
plan.request.url() == request.url()
} else {
true
})
// BODY
&& (if plan.match_on.contains(&MatchOn::Body) {
match (plan.request.body(), request.body()) {
(None, None) => true,
(Some(plan), Some(req)) => plan.as_bytes().eq(&req.as_bytes()),
_ => false,
}
} else {
true
})
// HEADERS
&& (if plan.match_on.contains(&MatchOn::Headers) {
plan.request.headers() == request.headers()
} else {
true
})
});
match index {
Some(i) => {
let response = plans.borrow_mut().remove(i).response;
Ok(response)
}
None => Err(Error::UnexpectedMockRequest(request)),
} }
} }
} }
@ -125,8 +136,10 @@ impl TryFrom<Net> for MockNet {
type Error = super::Error; type Error = super::Error;
fn try_from(net: Net) -> std::result::Result<Self, Self::Error> { fn try_from(net: Net) -> std::result::Result<Self, Self::Error> {
match net.mock { match &net.plans {
Some(inner_mock) => Ok(MockNet { inner: inner_mock }), Some(plans) => Ok(MockNet {
plans: RefCell::new(plans.take()),
}),
None => Err(Self::Error::NetIsNotAMock), None => Err(Self::Error::NetIsNotAMock),
} }
} }
@ -158,9 +171,8 @@ impl TryFrom<Net> for MockNet {
/// # Ok(()) /// # Ok(())
/// # } /// # }
/// ``` /// ```
#[derive(Debug)]
pub struct MockNet { pub struct MockNet {
inner: InnerNet<Mocked>, plans: RefCell<Plans>,
} }
impl MockNet { impl MockNet {
/// Helper to create a default [reqwest::Client]. /// Helper to create a default [reqwest::Client].
@ -190,8 +202,29 @@ impl MockNet {
/// # Ok(()) /// # Ok(())
/// # } /// # }
/// ``` /// ```
pub fn on(&self, request: impl Into<reqwest::RequestBuilder>) -> OnRequest { pub fn on(&self, request_builder: impl Into<reqwest::RequestBuilder>) -> OnRequest {
self.inner.on(request) match request_builder.into().build() {
Ok(request) => OnRequest::Valid {
net: self,
request,
match_on: vec![MatchOn::Method, MatchOn::Url],
},
Err(err) => OnRequest::Error(err.into()),
}
}
fn _on(
&self,
request: reqwest::Request,
response: reqwest::Response,
match_on: Vec<MatchOn>,
) -> Result<()> {
self.plans.borrow_mut().push(Plan {
request,
response,
match_on,
});
Ok(())
} }
/// Creates a [http::response::Builder] to be extended and returned by a mocked network request. /// Creates a [http::response::Builder] to be extended and returned by a mocked network request.
@ -199,21 +232,6 @@ impl MockNet {
Default::default() Default::default()
} }
/// Constructs the request and matches it against the expected requests.
///
/// The first on it finds where it matches against its criteria will be taken ("consumed") and
/// its response returned.
///
/// The order the expected requests are scanned is the order they were declared. As each
/// expected request is successfully matched against, it is removed and can't be matched
/// against again.
pub async fn send(
&self,
request: impl Into<reqwest::RequestBuilder>,
) -> Result<reqwest::Response> {
self.inner.send(request).await
}
/// Clears all the expected requests and responses from the [MockNet]. /// Clears all the expected requests and responses from the [MockNet].
/// ///
/// When the [MockNet] goes out of scope it will assert that all expected requests and /// When the [MockNet] goes out of scope it will assert that all expected requests and
@ -231,144 +249,37 @@ impl MockNet {
/// # Ok(()) /// # Ok(())
/// # } /// # }
/// ``` /// ```
pub fn reset(&self) -> Result<()> { pub fn reset(&self) {
self.inner.reset() self.plans.take();
} }
} }
impl From<MockNet> for Net { impl From<MockNet> for Net {
fn from(mock_net: MockNet) -> Self { fn from(mock_net: MockNet) -> Self {
Self { Self {
inner: InnerNet::<Unmocked>::new(),
// keep the original `inner` around to allow it's Drop impelmentation to run when we go // keep the original `inner` around to allow it's Drop impelmentation to run when we go
// out of scope at the end of the test // out of scope at the end of the test
mock: Some(mock_net.inner), plans: Some(RefCell::new(mock_net.plans.take())),
} }
} }
} }
/// Part of the inner workings of [Net] and [MockNet]. impl Drop for MockNet {
///
/// Holds the list of expected requests for [MockNet].
#[derive(Debug)]
pub struct InnerNet<T: NetType> {
_type: PhantomData<T>,
plans: RwLock<Plans>,
}
impl InnerNet<Unmocked> {
const fn new() -> Self {
Self {
_type: PhantomData,
plans: RwLock::new(vec![]),
}
}
pub async fn send(
&self,
request: impl Into<reqwest::RequestBuilder>,
) -> Result<reqwest::Response> {
request.into().send().await.map_err(Error::from)
}
}
impl InnerNet<Mocked> {
const fn new() -> Self {
Self {
_type: PhantomData,
plans: RwLock::new(vec![]),
}
}
pub async fn send(
&self,
request: impl Into<reqwest::RequestBuilder>,
) -> Result<reqwest::Response> {
let request = request.into().build()?;
let read_plans = self.plans.read().map_err(|_| Error::RwLockLocked)?;
let index = read_plans.iter().position(|plan| {
// METHOD
(if plan.match_on.contains(&MatchOn::Method) {
plan.request.method() == request.method()
} else {
true
})
// URL
&& (if plan.match_on.contains(&MatchOn::Url) {
plan.request.url() == request.url()
} else {
true
})
// BODY
&& (if plan.match_on.contains(&MatchOn::Body) {
match (plan.request.body(), request.body()) {
(None, None) => true,
(Some(plan), Some(req)) => plan.as_bytes().eq(&req.as_bytes()),
_ => false,
}
} else {
true
})
// HEADERS
&& (if plan.match_on.contains(&MatchOn::Headers) {
plan.request.headers() == request.headers()
} else {
true
})
});
drop(read_plans);
match index {
Some(i) => {
let mut write_plans = self.plans.write().map_err(|_| Error::RwLockLocked)?;
Ok(write_plans.remove(i).response)
}
None => Err(Error::UnexpectedMockRequest(request)),
}
}
pub fn on(&self, request_builder: impl Into<reqwest::RequestBuilder>) -> OnRequest {
match request_builder.into().build() {
Ok(request) => OnRequest::Valid {
net: self,
request,
match_on: vec![MatchOn::Method, MatchOn::Url],
},
Err(err) => OnRequest::Error(err.into()),
}
}
fn _on(
&self,
request: reqwest::Request,
response: reqwest::Response,
match_on: Vec<MatchOn>,
) -> Result<()> {
let mut write_plans = self.plans.write().map_err(|_| Error::RwLockLocked)?;
write_plans.push(Plan {
request,
response,
match_on,
});
Ok(())
}
pub fn reset(&self) -> Result<()> {
let mut write_plans = self.plans.write().map_err(|_| Error::RwLockLocked)?;
write_plans.clear();
Ok(())
}
}
impl<T: NetType> Drop for InnerNet<T> {
fn drop(&mut self) { fn drop(&mut self) {
let Ok(read_plans) = self.plans.read() else { assert!(self.plans.borrow().is_empty())
return; }
}; }
assert!(read_plans.is_empty()) impl Drop for Net {
fn drop(&mut self) {
if let Some(plans) = &self.plans {
assert!(plans.borrow().is_empty())
}
} }
} }
/// Intermediate struct used while declaring an expected request and its response. /// Intermediate struct used while declaring an expected request and its response.
pub enum OnRequest<'net> { pub enum OnRequest<'net> {
Valid { Valid {
net: &'net InnerNet<Mocked>, net: &'net MockNet,
request: reqwest::Request, request: reqwest::Request,
match_on: Vec<MatchOn>, match_on: Vec<MatchOn>,
}, },

View file

@ -1,6 +1,6 @@
use assert2::let_assert; use assert2::let_assert;
// //
use kxio::net::{Error, MatchOn, Net}; use kxio::net::{Error, MatchOn, MockNet, Net};
#[tokio::test] #[tokio::test]
async fn test_get_url() { async fn test_get_url() {
@ -30,17 +30,20 @@ async fn test_get_url() {
#[tokio::test] #[tokio::test]
async fn test_get_wrong_url() { async fn test_get_wrong_url() {
//given //given
let net = kxio::net::mock(); let mock_net = kxio::net::mock();
let client = net.client(); let client = mock_net.client();
let url = "https://www.example.com"; let url = "https://www.example.com";
let request = client.get(url); let request = client.get(url);
let my_response = net.response().status(200).body("Get OK"); let my_response = mock_net.response().status(200).body("Get OK");
net.on(request) mock_net
.on(request)
.respond_with_body(my_response) .respond_with_body(my_response)
.expect("on request, respond"); .expect("on request, respond");
let net = Net::from(mock_net);
//when //when
let_assert!( let_assert!(
Err(Error::UnexpectedMockRequest(invalid_request)) = Err(Error::UnexpectedMockRequest(invalid_request)) =
@ -51,7 +54,8 @@ async fn test_get_wrong_url() {
assert_eq!(invalid_request.url().to_string(), "https://some.other.url/"); assert_eq!(invalid_request.url().to_string(), "https://some.other.url/");
// remove pending unmatched request - we never meant to match against it // remove pending unmatched request - we never meant to match against it
net.reset().expect("reset"); let mock_net = MockNet::try_from(net).expect("recover net");
mock_net.reset();
} }
#[tokio::test] #[tokio::test]
@ -214,19 +218,22 @@ async fn test_post_by_headers() {
#[tokio::test] #[tokio::test]
#[should_panic] #[should_panic]
async fn test_unused_post() { async fn test_unused_post_as_net() {
//given //given
let net = kxio::net::mock(); let mock_net = kxio::net::mock();
let client = net.client(); let client = mock_net.client();
let url = "https://www.example.com"; let url = "https://www.example.com";
let request = client.post(url); let request = client.post(url);
let my_response = net.response().status(200).body("Post OK"); let my_response = mock_net.response().status(200).body("Post OK");
net.on(request) mock_net
.on(request)
.respond_with_body(my_response) .respond_with_body(my_response)
.expect("on request, respond"); .expect("on request, respond");
let _net = Net::from(mock_net);
//when //when
// don't send the planned request // don't send the planned request
// let _response = Net::from(net).send(client.post(url)).await.expect("send"); // let _response = Net::from(net).send(client.post(url)).await.expect("send");
@ -234,3 +241,27 @@ async fn test_unused_post() {
//then //then
// Drop implementation for net should panic // Drop implementation for net should panic
} }
#[tokio::test]
#[should_panic]
async fn test_unused_post_as_mocknet() {
//given
let mock_net = kxio::net::mock();
let client = mock_net.client();
let url = "https://www.example.com";
let request = client.post(url);
let my_response = mock_net.response().status(200).body("Post OK");
mock_net
.on(request)
.respond_with_body(my_response)
.expect("on request, respond");
//when
// don't send the planned request
// let _response = Net::from(net).send(client.post(url)).await.expect("send");
//then
// Drop implementation for mock_net should panic
}