//!

//! Miscellaneous utilities for `tor-*` and `arti-*`.

//!

//! This crate lives at the *bottom* of the Tor crate stack.

//! So it contains only utilities which have no `tor-*` (or `arti-*`) dependencies.

//!

//! There is no particular theme.

//! More substantial sets of functionality with particular themes

//! are to be found in other `tor-*` crates.

#![deny(missing_docs)]

#![warn(noop_method_call)]

#![deny(unreachable_pub)]

#![warn(clippy::all)]

#![deny(clippy::await_holding_lock)]

#![deny(clippy::cargo_common_metadata)]

#![deny(clippy::cast_lossless)]

#![deny(clippy::checked_conversions)]

#![warn(clippy::cognitive_complexity)]

#![deny(clippy::debug_assert_with_mut_call)]

#![deny(clippy::exhaustive_enums)]

#![deny(clippy::exhaustive_structs)]

#![deny(clippy::expl_impl_clone_on_copy)]

#![deny(clippy::fallible_impl_from)]

#![deny(clippy::implicit_clone)]

#![deny(clippy::large_stack_arrays)]

#![warn(clippy::manual_ok_or)]

#![deny(clippy::missing_docs_in_private_items)]

#![deny(clippy::missing_panics_doc)]

#![warn(clippy::needless_borrow)]

#![warn(clippy::needless_pass_by_value)]

#![warn(clippy::option_option)]

#![warn(clippy::rc_buffer)]

#![deny(clippy::ref_option_ref)]

#![warn(clippy::semicolon_if_nothing_returned)]

#![warn(clippy::trait_duplication_in_bounds)]

#![deny(clippy::unnecessary_wraps)]

#![warn(clippy::unseparated_literal_suffix)]

#![deny(clippy::unwrap_used)]

use std::fmt;

#[cfg(feature = "humantime-serde")]

pub mod humantime_serde_option;

// ----------------------------------------------------------------------

/// Function with the signature of `Debug::fmt` that just prints `".."`

///

/// ```

/// use educe::Educe;

/// use tor_basic_utils::skip_fmt;

///

/// #[derive(Educe, Default)]

/// #[educe(Debug)]

/// struct Wombat {

///     visible: usize,

///

///     #[educe(Debug(method = "skip_fmt"))]

///     invisible: [u8; 2],

/// }

///

/// assert_eq!( format!("{:?}", &Wombat::default()),

///             "Wombat { visible: 0, invisible: .. }" );

/// ```

// ----------------------------------------------------------------------