Cleanup and documentation

enumscribe_derive/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "enumscribe_derive"
-version = "0.1.0"
+version = "0.1.1"
 authors = ["Tom Panton <pantonshire@gmail.com>"]
 edition = "2018"
 license = "MIT"
@@ -17,4 +17,5 @@ syn = "1.0"
 quote = "1.0"
 
 [features]
+default = ["serde"]
 serde = []

enumscribe_derive/README.md

@@ -2,11 +2,27 @@
 
 [![Build Status](https://travis-ci.com/Pantonshire/enumscribe.svg?branch=main)](https://travis-ci.com/Pantonshire/enumscribe)
 
-This crate provides derive macros for converting between simple enums and strings. It also includes derive macros for [`serde::Serialize`](https://docs.serde.rs/serde/trait.Serialize.html) and [`serde::Deserialize`](https://docs.serde.rs/serde/trait.Deserialize.html) for simple enums.
+This crate provides derive macros for converting between simple enums and strings. It also includes derive macros for
+[`serde::Serialize`](https://docs.serde.rs/serde/trait.Serialize.html) and
+[`serde::Deserialize`](https://docs.serde.rs/serde/trait.Deserialize.html) for simple enums.
+
+## Adding enumscribe to your project
+Add to your Cargo.toml file:
+
+```toml
+[dependencies]
+enumscribe = "0.1"
+```
+
+Derive macros and [`serde`](https://crates.io/crates/serde) support are enabled by default. They can be disabled by
+setting `default-features = false`.
+
+It is also possible to use the `enumscribe_derive` crate on its own without using the `enumscribe` crate. However,
+doing so means that you will only be able to derive `serde::Serialize` and `serde::Deserialize`.
 
 ## Usage
-There are a variety of different traits that you can derive. The "Scribe" traits are for converting from an enum to a string, and the "Unscribe" traits are for
-converting a string to an enum.
+There are a variety of different traits that you can derive. The "Scribe" traits are for converting from an enum to a
+string, and the "Unscribe" traits are for converting a string to an enum.
 
 ### Basic usage
 ```rust
@@ -29,11 +45,12 @@ assert_eq!(Airport::Heathrow.scribe(), "LHR");
 assert_eq!(Airport::try_unscribe("LGW"), Some(Airport::Gatwick));
 ```
 
-The `#[enumscribe(str = "...")]` allows us to specify what string should be used to represent a particular variant. If this is omitted, the name of the variant
-will be used instead.
+The `#[enumscribe(str = "...")]` allows us to specify what string should be used to represent a particular variant. If
+this is omitted, the name of the variant will be used instead.
 
 ### Case insensitivity
-The `#[enumscribe(case_insensitive)]` attribute can be used to make the "Unscribe" traits perform case-insensitive matching for a variant:
+The `#[enumscribe(case_insensitive)]` attribute can be used to make the "Unscribe" traits perform case-insensitive
+matching for a variant:
 
 ```rust
 use enumscribe::TryUnscribe;
@@ -50,8 +67,8 @@ assert_eq!(Website::try_unscribe("GiThUb.CoM"), Some(Website::Github));
 ```
 
 ### "other" variant
-You can also have a variant which stores strings that could not be matched to any other variant. This is done using the `#[enumscribe(other)]` attribute.
-The variant should have a single field, which is a `String`.
+You can also have a variant which stores strings that could not be matched to any other variant. This is done using the
+`#[enumscribe(other)]` attribute. The variant should have a single field, which is a `String`.
 
 ```rust
 use std::borrow::Cow;

enumscribe_derive/src/enums.rs

@@ -195,7 +195,7 @@ pub(crate) fn parse_enum(data: &DataEnum) -> MacroResult<Enum> {
             }.insert(lowercase_name);
 
             // Return an error if the variant has any fields
-            if variant.fields.len() != 0 {
+            if !variant.fields.is_empty() {
                 let variant_ident = variant.ident.to_string();
                 return Err(MacroError::new(
                     format!(

enumscribe_derive/src/lib.rs

@@ -1,7 +1,10 @@
-//! Derive macros for the traits provided by `enumscribe`, to help you easily convert your enums
-//! to strings and vice-versa.
+//! Derive macros for the traits provided by [`enumscribe`](https://docs.rs/enumscribe), to
+//! help you easily convert your enums to strings and vice-versa.
 //!
-//! See the documentation for the `enumscribe` crate for usage examples.
+//! See the [documentation for the `enumscribe` crate](https://docs.rs/crate/enumscribe) for usage
+//! examples.
+
+#![deny(missing_docs)]
 
 use proc_macro::TokenStream;
 
@@ -270,7 +273,7 @@ fn gen_unscribe_match<F, G, E>(
     Ok(main_match)
 }
 
-/// Derives `enumscribe::ScribeStaticStr` for an enum. This allows the enum to be converted to
+/// Derives [`enumscribe::ScribeStaticStr`](https://docs.rs/enumscribe/latest/enumscribe/trait.ScribeStaticStr.html) for an enum. This allows the enum to be converted to
 /// a `&'static str` using the `scribe()` method.
 ///
 /// You may annotate variants with `#[enumscribe(str = "foo")]` to specify what string the variant
@@ -321,7 +324,7 @@ pub fn derive_scribe_static_str(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::TryScribeStaticStr` for an enum. This allows the enum to be converted to
+/// Derives [`enumscribe::TryScribeStaticStr`](https://docs.rs/enumscribe/latest/enumscribe/trait.TryScribeStaticStr.html) for an enum. This allows the enum to be converted to
 /// a `Option<&'static str>` using the `try_scribe()` method.
 ///
 /// You may annotate variants with `#[enumscribe(str = "foo")]` to specify what string the variant
@@ -359,7 +362,7 @@ pub fn derive_try_scribe_static_str(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::ScribeString` for an enum. This allows the enum to be converted to
+/// Derives [`enumscribe::ScribeString`](https://docs.rs/enumscribe/latest/enumscribe/trait.ScribeString.html) for an enum. This allows the enum to be converted to
 /// a `String` using the `scribe()` method.
 ///
 /// This behaves almost identically to [`ScribeCowStr`](derive.ScribeCowStr.html), except the
@@ -394,7 +397,7 @@ pub fn derive_scribe_string(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::TryScribeString` for an enum. This allows the enum to be converted to
+/// Derives [`enumscribe::TryScribeString`](https://docs.rs/enumscribe/latest/enumscribe/trait.TryScribeString.html) for an enum. This allows the enum to be converted to
 /// a `Option<String>` using the `try_scribe()` method.
 ///
 /// This behaves almost identically to [`TryScribeCowStr`](derive.TryScribeCowStr.html), except the
@@ -427,7 +430,7 @@ pub fn derive_try_scribe_string(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::ScribeCowStr` for an enum. This allows the enum to be converted to
+/// Derives [`enumscribe::ScribeCowStr`](https://docs.rs/enumscribe/latest/enumscribe/trait.ScribeCowStr.html) for an enum. This allows the enum to be converted to
 /// a `Cow<'static, str>` using the `scribe()` method.
 ///
 /// You may annotate variants with `#[enumscribe(str = "foo")]` to specify what string the variant
@@ -474,7 +477,7 @@ pub fn derive_scribe_cow_str(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::TryScribeCowStr` for an enum. This allows the enum to be converted to
+/// Derives [`enumscribe::TryScribeCowStr`](https://docs.rs/enumscribe/latest/enumscribe/trait.TryScribeCowStr.html) for an enum. This allows the enum to be converted to
 /// a `Option<Cow<'static, str>>` using the `try_scribe()` method.
 ///
 /// You may annotate variants with `#[enumscribe(str = "foo")]` to specify what string the variant
@@ -520,7 +523,7 @@ pub fn derive_try_scribe_cow_str(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::Unscribe` for an enum. This allows a `&str` to be converted to the
+/// Derives [`enumscribe::Unscribe`](https://docs.rs/enumscribe/latest/enumscribe/trait.Unscribe.html) for an enum. This allows a `&str` to be converted to the
 /// enum using the `unscribe()` associated function.
 ///
 /// You may annotate variants with `#[enumscribe(str = "foo")]` to specify what string should
@@ -564,7 +567,7 @@ pub fn derive_unscribe(input: TokenStream) -> TokenStream {
     )
 }
 
-/// Derives `enumscribe::TryUnscribe` for an enum. This allows a `&str` to be converted to an
+/// Derives [`enumscribe::TryUnscribe`](https://docs.rs/enumscribe/latest/enumscribe/trait.TryUnscribe.html) for an enum. This allows a `&str` to be converted to an
 /// `Option` of the enum using the `try_unscribe()` associated function.
 ///
 /// You may annotate variants with `#[enumscribe(str = "foo")]` to specify what string should