Add suffix to HiddenNodes error type

By convention we always include the suffix "Error" on our error types.

Rename the error type `HiddenNodes` to `HiddenNodesError`.
This commit is contained in:
Tobin C. Harding 2023-10-04 13:48:24 +11:00
parent 2b40ea24fb
commit 6933ca4fc2
No known key found for this signature in database
GPG Key ID: 40BF9E4C269D6607
1 changed files with 11 additions and 11 deletions

View File

@ -622,33 +622,33 @@ impl std::error::Error for IncompleteBuilderError {
/// having hidden branches. /// having hidden branches.
#[derive(Clone, Ord, PartialOrd, Eq, PartialEq, Hash, Debug)] #[derive(Clone, Ord, PartialOrd, Eq, PartialEq, Hash, Debug)]
#[non_exhaustive] #[non_exhaustive]
pub enum HiddenNodes { pub enum HiddenNodesError {
/// Indicates an attempt to construct a tap tree from a builder containing hidden parts. /// Indicates an attempt to construct a tap tree from a builder containing hidden parts.
HiddenParts(NodeInfo), HiddenParts(NodeInfo),
} }
impl HiddenNodes { impl HiddenNodesError {
/// Converts error into the original incomplete [`NodeInfo`] instance. /// Converts error into the original incomplete [`NodeInfo`] instance.
pub fn into_node_info(self) -> NodeInfo { pub fn into_node_info(self) -> NodeInfo {
match self { match self {
HiddenNodes::HiddenParts(node_info) => node_info, HiddenNodesError::HiddenParts(node_info) => node_info,
} }
} }
} }
impl core::fmt::Display for HiddenNodes { impl core::fmt::Display for HiddenNodesError {
fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result { fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
f.write_str(match self { f.write_str(match self {
HiddenNodes::HiddenParts(_) => HiddenNodesError::HiddenParts(_) =>
"an attempt to construct a tap tree from a node_info containing hidden parts.", "an attempt to construct a tap tree from a node_info containing hidden parts.",
}) })
} }
} }
#[cfg(feature = "std")] #[cfg(feature = "std")]
impl std::error::Error for HiddenNodes { impl std::error::Error for HiddenNodesError {
fn source(&self) -> Option<&(dyn std::error::Error + 'static)> { fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
use self::HiddenNodes::*; use self::HiddenNodesError::*;
match self { match self {
HiddenParts(_) => None, HiddenParts(_) => None,
@ -700,17 +700,17 @@ impl TryFrom<TaprootBuilder> for TapTree {
} }
impl TryFrom<NodeInfo> for TapTree { impl TryFrom<NodeInfo> for TapTree {
type Error = HiddenNodes; type Error = HiddenNodesError;
/// Constructs [`TapTree`] from a [`NodeInfo`] if it is complete binary tree. /// Constructs [`TapTree`] from a [`NodeInfo`] if it is complete binary tree.
/// ///
/// # Returns /// # Returns
/// ///
/// A [`TapTree`] iff the [`NodeInfo`] has no hidden nodes, otherwise return [`HiddenNodes`] /// A [`TapTree`] iff the [`NodeInfo`] has no hidden nodes, otherwise return
/// error with the content of incomplete [`NodeInfo`] instance. /// [`HiddenNodesError`] error with the content of incomplete [`NodeInfo`] instance.
fn try_from(node_info: NodeInfo) -> Result<Self, Self::Error> { fn try_from(node_info: NodeInfo) -> Result<Self, Self::Error> {
if node_info.has_hidden_nodes { if node_info.has_hidden_nodes {
Err(HiddenNodes::HiddenParts(node_info)) Err(HiddenNodesError::HiddenParts(node_info))
} else { } else {
Ok(TapTree(node_info)) Ok(TapTree(node_info))
} }