Commit 0f4c1c58 authored by Ryan McCormick's avatar Ryan McCormick Committed by GitHub
Browse files

fix: Fix cargo doc warnings for lib/runtime (#150)

parent dac63127
...@@ -148,12 +148,12 @@ where ...@@ -148,12 +148,12 @@ where
}) })
} }
/// String identifying <namespace>/<component>/<endpoint> /// String identifying `<namespace>/<component>/<endpoint>`
pub fn path(&self) -> String { pub fn path(&self) -> String {
self.endpoint.path() self.endpoint.path()
} }
/// String identifying <namespace>/component/<component>/<endpoint> /// String identifying `<namespace>/component/<component>/<endpoint>`
pub fn etcd_path(&self) -> String { pub fn etcd_path(&self) -> String {
self.endpoint.etcd_path() self.endpoint.etcd_path()
} }
......
...@@ -24,12 +24,12 @@ use crate::Result; ...@@ -24,12 +24,12 @@ use crate::Result;
// async fn publish(&self, event: &(impl Serialize + Send + Sync)) -> Result<()>; // async fn publish(&self, event: &(impl Serialize + Send + Sync)) -> Result<()>;
// } // }
/// A [EventPlane] is a component that can publish and/or subscribe to events. /// An [EventPublisher] is an object that can publish events.
/// ///
/// Each implementation of [EventPlane] will define the root subject. /// Each implementation of [EventPublisher] will define the root subject.
#[async_trait] #[async_trait]
pub trait EventPublisher { pub trait EventPublisher {
/// The base subject used for this implementation of the [EventPlane]. /// The base subject used for this implementation of the [EventPublisher].
fn subject(&self) -> String; fn subject(&self) -> String;
/// Publish a single event to the event plane. The `event_name` will be `.` concatenated with the /// Publish a single event to the event plane. The `event_name` will be `.` concatenated with the
...@@ -57,7 +57,7 @@ pub trait EventPublisher { ...@@ -57,7 +57,7 @@ pub trait EventPublisher {
// fn publisher_bytes(&self, event_name: impl AsRef<str>) -> &PublisherBytes; // fn publisher_bytes(&self, event_name: impl AsRef<str>) -> &PublisherBytes;
} }
/// A trait for subscribing to events in the event plane. /// An [EventSubscriber] is an object that can subscribe to events.
/// ///
/// This trait provides methods to subscribe to events published on specific subjects. /// This trait provides methods to subscribe to events published on specific subjects.
#[async_trait] #[async_trait]
......
...@@ -307,7 +307,7 @@ impl ServerExecutionHandle { ...@@ -307,7 +307,7 @@ impl ServerExecutionHandle {
} }
// Client implementation // Client implementation
struct Client { pub struct Client {
dealer: Dealer<IntoIter<Vec<u8>>, Vec<u8>>, dealer: Dealer<IntoIter<Vec<u8>>, Vec<u8>>,
} }
......
...@@ -29,7 +29,7 @@ pub trait ReturnHandle<T: Returnable>: Send + Sync + 'static { ...@@ -29,7 +29,7 @@ pub trait ReturnHandle<T: Returnable>: Send + Sync + 'static {
fn return_to_pool(&self, value: PoolValue<T>); fn return_to_pool(&self, value: PoolValue<T>);
} }
/// Enum to hold either a Box<T> or T directly /// Enum to hold either a `Box<T>` or `T` directly
pub enum PoolValue<T: Returnable> { pub enum PoolValue<T: Returnable> {
Boxed(Box<T>), Boxed(Box<T>),
Direct(T), Direct(T),
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment