feat: move trailers to the transfer module

based on http-rs#309 by @brightly-salty

Author: OneOfOne

src/lib.rs

@@ -151,11 +151,19 @@ pub use status::Status;
 pub use status_code::StatusCode;
 pub use version::Version;
 
+#[doc(inline)]
+pub use transfer::trailers::Trailers;
+
+#[doc(inline)]
+pub use mime::Mime;
+
+#[doc(inline)]
+pub use headers::Headers;
+
 #[doc(inline)]
 pub use crate::url::Url;
 
 pub mod security;
-pub mod trailers;
 
 #[cfg(feature = "hyperium_http")]
 mod hyperium_http;

src/request.rs

@@ -10,7 +10,8 @@ use std::task::{Context, Poll};
 use crate::convert::{DeserializeOwned, Serialize};
 use crate::headers::{self, HeaderName, HeaderValue, HeaderValues, Headers, Names, ToHeaderValues, Values, CONTENT_TYPE};
 use crate::mime::Mime;
-use crate::trailers::{self, Trailers};
+
+use crate::transfer::{trailers, Trailers};
 use crate::{Body, Extensions, Method, Url, Version};
 
 pin_project_lite::pin_project! {
@@ -532,7 +533,7 @@ impl Request {
         self.version = version;
     }
 
-    /// Sends trailers to the a receiver.
+    /// Sends trailers to the receiver.
     pub fn send_trailers(&mut self) -> trailers::Sender {
         self.has_trailers = true;
         let sender = self.trailers_sender.take().expect("Trailers sender can only be constructed once");

src/response.rs

@@ -11,7 +11,7 @@ use std::task::{Context, Poll};
 use crate::convert::DeserializeOwned;
 use crate::headers::{self, HeaderName, HeaderValue, HeaderValues, Headers, Names, ToHeaderValues, Values, CONTENT_TYPE};
 use crate::mime::Mime;
-use crate::trailers::{self, Trailers};
+use crate::transfer::{trailers, Trailers};
 use crate::upgrade;
 use crate::{Body, Extensions, StatusCode, Version};
 

src/transfer/mod.rs

@@ -5,9 +5,11 @@
 mod encoding;
 mod encoding_proposal;
 mod te;
+pub mod trailers;
 mod transfer_encoding;
 
 pub use encoding::Encoding;
 pub use encoding_proposal::EncodingProposal;
 pub use te::TE;
+pub use trailers::Trailers;
 pub use transfer_encoding::TransferEncoding;

src/trailers.rs src/transfer/trailers.rs

@@ -23,7 +23,7 @@
 //! # async_std::task::block_on(async {
 //! #
 //! use http_types_rs::{Url, Method, Request};
-//! use http_types_rs::trailers::Trailers;
+//! use http_types_rs::transfer::Trailers;
 //! use http_types_rs::headers::{HeaderName, HeaderValue};
 //! use async_std::task;
 //! use std::str::FromStr;
@@ -76,7 +76,7 @@ impl Trailers {
     /// ```
     /// # fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync + 'static>> {
     /// #
-    /// use http_types_rs::trailers::Trailers;
+    /// use http_types_rs::transfer::Trailers;
     ///
     /// let mut trailers = Trailers::new();
     /// trailers.insert("Content-Type", "text/plain");
@@ -97,7 +97,7 @@ impl Trailers {
     /// ```
     /// # fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync + 'static>> {
     /// #
-    /// use http_types_rs::trailers::Trailers;
+    /// use http_types_rs::transfer::Trailers;
     ///
     /// let mut trailers = Trailers::new();
     /// trailers.append("Content-Type", "text/plain");