Deny missing docs

Author: Alex6323

bee-inx/examples/utxo.rs

@@ -15,7 +15,7 @@ async fn main() -> Result<(), Error> {
     let mut unspent_outputs = inx.read_unspent_outputs().await?;
 
     let mut count = 0;
-    while let Some(_) = unspent_outputs.next().await {
+    while let Some(_unspent_output) = unspent_outputs.next().await {
         count += 1;
     }
     println!("Read {count} unspent outputs.");

bee-inx/src/block/mod.rs

@@ -1,6 +1,7 @@
 // Copyright 2022 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
+/// A module that provides block related INX responses.
 pub mod responses;
 
 use futures::stream::{Stream, StreamExt};
@@ -15,7 +16,7 @@ use crate::{
 };
 
 impl Inx {
-    // TODO
+    /// Listens to all blocks.
     pub async fn listen_to_blocks(&mut self) -> Result<impl Stream<Item = Result<Block, Error>>, Error> {
         Ok(self
             .client
@@ -25,7 +26,7 @@ impl Inx {
             .map(try_from_inx_type))
     }
 
-    // TODO
+    /// Listens to solid blocks.
     pub async fn listen_to_solid_blocks(&mut self) -> Result<impl Stream<Item = Result<BlockMetadata, Error>>, Error> {
         Ok(self
             .client
@@ -35,7 +36,7 @@ impl Inx {
             .map(try_from_inx_type))
     }
 
-    // TODO
+    /// Listens to referenced blocks.
     pub async fn listen_to_referenced_blocks(
         &mut self,
     ) -> Result<impl Stream<Item = Result<BlockMetadata, Error>>, Error> {
@@ -47,7 +48,7 @@ impl Inx {
             .map(try_from_inx_type))
     }
 
-    // TODO
+    /// Requests the block with the given block id.
     pub async fn read_block(&mut self, block_id: bee::BlockId) -> Result<Raw<bee::Block>, Error> {
         Ok(self
             .client
@@ -58,7 +59,7 @@ impl Inx {
             .into())
     }
 
-    // TODO
+    /// Requests the metadata of the block with the given block id. 
     pub async fn read_block_metadata(&mut self, block_id: bee::BlockId) -> Result<BlockMetadata, Error> {
         Ok(self
             .client
@@ -68,7 +69,7 @@ impl Inx {
             .try_into()?)
     }
 
-    // TODO
+    /// Submits a block and returns its corresponding block id.
     pub async fn submit_block(&mut self, raw_block: Raw<bee::Block>) -> Result<bee::BlockId, Error> {
         Ok(self
             .client

bee-inx/src/block/responses.rs

@@ -153,6 +153,7 @@ impl From<LedgerInclusionState> for inx::LedgerInclusionState {
     }
 }
 
+/// Whether a block contains a transaction that is either included or conflicting, or contains no transaction at all.
 #[allow(missing_docs)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum LedgerInclusionState {

bee-inx/src/error.rs

@@ -4,6 +4,7 @@
 use inx::tonic;
 use thiserror::Error;
 
+#[allow(missing_docs)]
 #[derive(Debug, Error)]
 pub enum Error {
     #[error(transparent)]

bee-inx/src/lib.rs

@@ -1,18 +1,28 @@
 // Copyright 2022 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
+//! Bee compatible INX types and INX node request bindings.
+
+#![deny(missing_docs)]
+
 mod error;
 
+/// A module that provides block related requests..
 pub mod block;
+/// A module that provides the INX client.
 pub mod client;
+/// A module that provides milestone related requests.
 pub mod milestone;
+/// A module that provides node related requests.
 pub mod node;
+/// A module that provides the [`Raw<T: Packable>`] struct.
 pub mod raw;
+/// A module that provides UTXO ledger related requests.
 pub mod utxo;
 
 pub use self::{block::*, error::Error, milestone::*, node::*, raw::*, utxo::*};
 
-pub mod inx {
+pub(crate) mod inx {
     pub use ::inx::proto::{
         block_metadata::*,
         ledger_update::{marker::*, *},
@@ -36,6 +46,7 @@ pub(crate) mod bee {
     pub use bee_block::{protocol::protocol_parameters, rand::output::rand_output};
 }
 
+#[allow(missing_docs)]
 #[macro_export]
 macro_rules! return_err_if_none {
     ($object:ident.$field:ident) => {

bee-inx/src/milestone/mod.rs

@@ -1,7 +1,9 @@
 // Copyright 2022 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
+/// A module that provides milestone related INX requests.
 pub mod requests;
+/// A module that provides milestone related INX responses.
 pub mod responses;
 
 use futures::stream::{Stream, StreamExt};
@@ -15,7 +17,7 @@ use crate::{
 };
 
 impl Inx {
-    /// TODO
+    /// Requests a particular milestone.
     pub async fn read_milestone(&mut self, request: MilestoneRequest) -> Result<Milestone, Error> {
         Ok(self
             .client
@@ -48,7 +50,7 @@ impl Inx {
             .map(try_from_inx_type))
     }
 
-    /// TODO
+    /// Requests "white flag" data for a milestone.
     pub async fn compute_white_flag(&mut self, request: WhiteFlagRequest) -> Result<WhiteFlagResponse, Error> {
         Ok(self
             .client
@@ -71,7 +73,7 @@ impl Inx {
             .map(try_from_inx_type))
     }
 
-    /// TODO
+    /// Reads the past cone metadata of a milestone specified by a [`MilestoneRequest`].
     pub async fn read_milestone_cone_metadata(
         &mut self,
         request: MilestoneRequest,

bee-inx/src/milestone/requests.rs

@@ -5,6 +5,8 @@ use std::ops::{Bound, RangeBounds};
 
 use crate::{bee, error, inx};
 
+/// Allows to request a milestone by either its index or its id.
+#[allow(missing_docs)]
 pub enum MilestoneRequest {
     MilestoneIndex(bee::MilestoneIndex),
     MilestoneId(bee::MilestoneId),
@@ -71,6 +73,7 @@ where
     }
 }
 
+/// Allows to request "white flag" data for a particular milestone.
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct WhiteFlagRequest {
     milestone_index: bee::MilestoneIndex,

bee-inx/src/milestone/responses.rs

@@ -36,6 +36,7 @@ impl From<Milestone> for inx::Milestone {
 }
 
 /// The [`Milestone`] type.
+#[allow(missing_docs)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MilestoneAndProtocolParameters {
     pub milestone: Milestone,
@@ -95,6 +96,8 @@ impl From<MilestoneInfo> for inx::MilestoneInfo {
     }
 }
 
+/// The response of a corresponding "white flag" request.
+#[allow(missing_docs)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct WhiteFlagResponse {
     milestone_inclusion_merkle_root: Vec<u8>,

bee-inx/src/node/mod.rs

@@ -1,7 +1,9 @@
 // Copyright 2022 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
+/// A module that provides node related INX requests.
 pub mod requests;
+/// A module that provides node related INX responses.
 pub mod responses;
 
 use futures::stream::{Stream, StreamExt};
@@ -15,13 +17,13 @@ use crate::{
 };
 
 impl Inx {
-    /// TODO
+    /// Requests the status of the connected node.
     pub async fn read_node_status(&mut self) -> Result<NodeStatus, Error> {
         NodeStatus::try_from(self.client.read_node_status(inx::NoParams {}).await?.into_inner())
             .map_err(Error::InxError)
     }
 
-    // TODO
+    /// Listens to node status updates.
     pub async fn listen_to_node_status(
         &mut self,
         request: NodeStatusRequest,
@@ -34,7 +36,7 @@ impl Inx {
             .map(try_from_inx_type))
     }
 
-    /// TODO
+    /// Requests the configuration of the connected node.
     pub async fn read_node_configuration(&mut self) -> Result<NodeConfiguration, Error> {
         NodeConfiguration::try_from(
             self.client
@@ -45,7 +47,7 @@ impl Inx {
         .map_err(Error::InxError)
     }
 
-    /// TODO
+    /// Requests the protocol parameters of the connected node.
     pub async fn read_protocol_parameters(&mut self, request: MilestoneRequest) -> Result<ProtocolParameters, Error> {
         Ok(self
             .client

bee-inx/src/node/requests.rs

@@ -3,7 +3,8 @@
 
 use crate::inx;
 
-/// TODO
+/// A request for the node status.
+#[allow(missing_docs)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct NodeStatusRequest {
     pub cooldown_in_milliseconds: u32,