I had a lot of trouble understanding this. Thus I am documenting it here for myself. All credit goes to the original StackOverFlow author.

1. Add one of the following to the root of your crate. Usually lib.rs
   1.

   #![feature(doc_cfg)]
   

   This is less than ideal as it will cause compile errors when used with stable
   2. It is better to use:

   #![cfg_attr(docsrs, feature(doc_cfg))]
   

   This allows this to be conditionally compiled and does not give any errors.

   [Read More]

Automatically convert one error to another.

Define a display trait for a struct or enum

impl std::fmt::Display for MechanismError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            MechanismError::NotValidMechanismFormat(mesg) => {
                write!(f, "{} does not conform to any Mechanism format.", mesg)
            }
            MechanismError::NotIP4Network(mesg) => {
                write!(f, "Was given ip4:{}. This is not an ip4 network.", mesg)
            }
            MechanismError::NotIP6Network(mesg) => {
                write!(f, "Was given ip6:{}. This is not an ip6 network.", mesg)
            }
            MechanismError::NotValidIPNetwork(mesg) => {
                write!(f, "{}.", mesg)
            }
            MechanismError::NotIpNetworkMechanism => {
                write!(f, "Attempt to access TXT as IP.")
            }
            MechanismError::NotStringMechanism => {
                write!(f, "Attempt to access IP as TXT.")
            }
        }
    }
}

Reference:

How to to_string() in Rust

Creating a enum to encapsulate Errors.

Releasing Version 0.2.6 of decon_spf

I am happy to announce that I have released decon-spf version 0.2.1 This release contains a number of improvements and a new feature.

Today I published my first rust crate.

Recently I decided that I might actually publish my little rust crate. To that end I started looking into some of the things that are needed and what can be done. I have published a perl module in the past. And as a rule for myself, I like to provide an example program that uses a module or library. That is what I will look at today.