remove unused struct and put its functions as top level

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sitewriter"
-version = "0.4.2"
+version = "0.5.0"
 authors = ["Edgar <git@edgarluque.com>"]
 edition = "2021"
 description = "A sitemap writing library."

benches/benchmark.rs

@@ -1,5 +1,5 @@
 use criterion::{black_box, criterion_group, criterion_main, Criterion};
-use sitewriter::*;
+use sitewriter::{ChangeFreq, UrlEntry, UrlEntryBuilder};
 
 fn benchmark(c: &mut Criterion) {
     use chrono::Utc;
@@ -52,11 +52,11 @@ fn benchmark(c: &mut Criterion) {
     ];
 
     c.bench_function("generate_str", |b| {
-        b.iter(|| Sitemap::generate_str(black_box(&urls)))
+        b.iter(|| sitewriter::generate_str(black_box(&urls)))
     });
 
     c.bench_function("generate_bytes", |b| {
-        b.iter(|| Sitemap::generate_bytes(black_box(&urls)))
+        b.iter(|| sitewriter::generate_bytes(black_box(&urls)))
     });
 }
 

examples/gen_sitemap.rs

@@ -1,5 +1,5 @@
 use chrono::prelude::*;
-use sitewriter::*;
+use sitewriter::{ChangeFreq, UrlEntry, UrlEntryBuilder};
 
 fn main() {
     let urls = vec![
@@ -48,6 +48,6 @@ fn main() {
         },
     ];
 
-    let result = Sitemap::generate_str(&urls).unwrap();
+    let result = sitewriter::generate_str(&urls);
     println!("{}", result);
 }

src/lib.rs

@@ -13,7 +13,7 @@
 //!
 //! ```rust
 //! use chrono::prelude::*;
-//! use sitewriter::*;
+//! use sitewriter::{ChangeFreq, UrlEntry, UrlEntryBuilder};
 //!
 //!    let urls = vec![
 //!        UrlEntryBuilder::default()
@@ -61,7 +61,7 @@
 //!        },
 //!    ];
 //!
-//!    let result = Sitemap::generate_str(&urls).unwrap();
+//!    let result = sitewriter::generate_str(&urls);
 //!    println!("{}", result);
 //! ```
 //!
@@ -77,25 +77,20 @@
 //! Help other developers, inform them and share your opinion.\
 //! Use [cargo_crev_reviews](https://crates.io/crates/cargo_crev_reviews) to write reviews easily.
 
-
 use chrono::{DateTime, SecondsFormat, Utc};
 use derive_builder::Builder;
-pub use url;
-use url::Url;
-
 use quick_xml::{
     events::{BytesDecl, BytesEnd, BytesStart, BytesText, Event},
     Writer,
 };
+use std::{fmt::Display, io::Cursor};
 
-use quick_xml::Result;
+pub use quick_xml::Result;
-use std::fmt::Display;
+pub use url::Url;
-use std::io::Cursor;
 
-pub use quick_xml;
+/// How frequently the page is likely to change. This value provides general
-
+/// information to search engines and may not correlate exactly to how often they crawl the page.
-/// How frequently the page is likely to change. This value provides general information to search engines and may not correlate exactly to how often they crawl the page.
+#[derive(Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
-#[derive(Debug, Eq, PartialEq, Copy, Clone)]
 pub enum ChangeFreq {
     /// Changes each time it's accessed.
     Always,
@@ -129,7 +124,7 @@ impl Display for ChangeFreq {
 }
 
 /// A sitemap url entry.
-#[derive(Debug, Clone, Builder)]
+#[derive(Debug, Clone, Builder, PartialEq, PartialOrd)]
 #[builder(setter(strip_option))]
 pub struct UrlEntry {
     /// URL of the page.
@@ -150,7 +145,8 @@ pub struct UrlEntry {
 }
 
 impl UrlEntry {
-    pub fn new(
+    #[must_use]
+    pub const fn new(
         loc: Url,
         lastmod: Option<DateTime<Utc>>,
         changefreq: Option<ChangeFreq>,
@@ -165,10 +161,6 @@ impl UrlEntry {
     }
 }
 
-/// Struct that implements the sitemap generation function.
-#[derive(Debug)]
-pub struct Sitemap;
-
 fn write_tag<T>(writer: &mut Writer<T>, tag: &str, text: &str) -> Result<()>
 where
     T: std::io::Write,
@@ -180,15 +172,18 @@ where
     Ok(())
 }
 
-impl Sitemap {
+/// Generates the sitemap and saves it using the provided writer.
-    /// Generates the sitemap and saves it using the provided writer.
+///
-    ///
+/// It's recommended to use [`Sitemap::generate_bytes`] or [`Sitemap::generate_str`] if you need a
-    /// It's recommended to use [`Sitemap::into_bytes`] or [`Sitemap::into_str`] if you need a
+/// String or a Vec<u8>.
-    /// String or a Vec<u8>.
+///
-    pub fn generate<T>(inner_writer: T, urls: &[UrlEntry]) -> Result<T>
+/// # Errors
-    where
+///
+/// Will return `Err` if it fails to write to the writer.
+pub fn generate<T>(inner_writer: T, urls: &[UrlEntry]) -> Result<T>
+where
     T: std::io::Write,
-    {
+{
     let mut writer = Writer::new_with_indent(inner_writer, b' ', 4);
     writer.write_event(Event::Decl(BytesDecl::new(b"1.0", Some(b"UTF-8"), None)))?;
 
@@ -224,21 +219,24 @@ impl Sitemap {
     writer.write_event(Event::End(BytesEnd::borrowed(urlset_name)))?;
 
     Ok(writer.into_inner())
-    }
+}
 
-    /// Generates the sitemap.
+/// Generates the sitemap.
-    pub fn generate_bytes(urls: &[UrlEntry]) -> Result<Vec<u8>> {
+#[must_use]
+pub fn generate_bytes(urls: &[UrlEntry]) -> Vec<u8> {
     let inner = Cursor::new(Vec::new());
-        let result = Sitemap::generate(inner, urls)?;
+    let result = generate(inner, urls).expect(
-        Ok(result.into_inner())
+            "it should never error, please report this bug to https://github.com/edg-l/sitewriter/issues",
-    }
+        );
+    result.into_inner()
+}
 
-    /// Generates the sitemap returning a string.
+/// Generates the sitemap returning a string.
-    pub fn generate_str(urls: &[UrlEntry]) -> Result<String> {
+#[must_use]
-        let bytes = Sitemap::generate_bytes(urls)?;
+pub fn generate_str(urls: &[UrlEntry]) -> String {
+    let bytes = generate_bytes(urls);
     let res = std::str::from_utf8(&bytes).expect("to be valid utf8");
-        Ok(res.to_owned())
+    res.to_owned()
-    }
 }
 
 #[cfg(test)]
@@ -296,7 +294,7 @@ mod tests {
             },
         ];
 
-        Sitemap::generate_str(&urls).unwrap();
+        let _result = generate_str(&urls);
     }
 
     #[test]