diff --git a/src/header/common/accept.rs b/src/header/common/accept.rs index bea84f14..9433280c 100644 --- a/src/header/common/accept.rs +++ b/src/header/common/accept.rs @@ -27,6 +27,51 @@ header! { #[doc="* `audio/*; q=0.2, audio/basic` (`*` value won't parse correctly)"] #[doc="* `text/plain; q=0.5, text/html, text/x-dvi; q=0.8, text/x-c`"] #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Accept, qitem};"] + #[doc="use hyper::mime::{Mime, TopLevel, SubLevel};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc=""] + #[doc="headers.set("] + #[doc=" Accept(vec!["] + #[doc=" qitem(Mime(TopLevel::Text, SubLevel::Html, vec![])),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Accept, qitem};"] + #[doc="use hyper::mime::{Mime, TopLevel, SubLevel, Attr, Value};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" Accept(vec!["] + #[doc=" qitem(Mime(TopLevel::Application, SubLevel::Json,"] + #[doc=" vec![(Attr::Charset, Value::Utf8)])),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Accept, QualityItem, Quality, qitem};"] + #[doc="use hyper::mime::{Mime, TopLevel, SubLevel};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc=""] + #[doc="headers.set("] + #[doc=" Accept(vec!["] + #[doc=" qitem(Mime(TopLevel::Text, SubLevel::Html, vec![])),"] + #[doc=" qitem(Mime(TopLevel::Application, SubLevel::Ext(\"xhtml+xml\".to_owned()), vec![])),"] + #[doc=" QualityItem::new(Mime(TopLevel::Application, SubLevel::Xml, vec![]),"] + #[doc=" Quality(900)),"] + #[doc=" qitem(Mime(TopLevel::Image, SubLevel::Ext(\"webp\".to_owned()), vec![])), +"] + #[doc=" QualityItem::new(Mime(TopLevel::Star, SubLevel::Star, vec![]),"] + #[doc=" Quality(800))"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc=""] #[doc="# Notes"] #[doc="* Using always Mime types to represent `media-range` differs from the ABNF."] #[doc="* **FIXME**: `accept-ext` is not supported."] diff --git a/src/header/common/accept_charset.rs b/src/header/common/accept_charset.rs index 16c80bba..b48ec5db 100644 --- a/src/header/common/accept_charset.rs +++ b/src/header/common/accept_charset.rs @@ -18,6 +18,35 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `iso-8859-5, unicode-1-1;q=0.8`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptCharset, Charset, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptCharset(vec![qitem(Charset::Us_Ascii)])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptCharset, Charset, Quality, QualityItem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptCharset(vec!["] + #[doc=" QualityItem::new(Charset::Us_Ascii, Quality(900)),"] + #[doc=" QualityItem::new(Charset::Iso_8859_10, Quality(200)),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptCharset, Charset, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptCharset(vec![qitem(Charset::Ext(\"utf-8\".to_owned()))])"] + #[doc=");"] + #[doc="```"] (AcceptCharset, "Accept-Charset") => (QualityItem)+ test_accept_charset { diff --git a/src/header/common/accept_encoding.rs b/src/header/common/accept_encoding.rs index 1b6a4838..d645759e 100644 --- a/src/header/common/accept_encoding.rs +++ b/src/header/common/accept_encoding.rs @@ -22,6 +22,40 @@ header! { #[doc="* `*`"] #[doc="* `compress;q=0.5, gzip;q=1`"] #[doc="* `gzip;q=1.0, identity; q=0.5, *;q=0`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptEncoding, Encoding, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptEncoding(vec![qitem(Encoding::Chunked)])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptEncoding, Encoding, qitem};"] + #[doc=" "] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptEncoding(vec!["] + #[doc=" qitem(Encoding::Chunked),"] + #[doc=" qitem(Encoding::Gzip),"] + #[doc=" qitem(Encoding::Deflate),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptEncoding, Encoding, QualityItem, Quality, qitem};"] + #[doc=" "] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptEncoding(vec!["] + #[doc=" qitem(Encoding::Chunked),"] + #[doc=" QualityItem::new(Encoding::Gzip, Quality(600)),"] + #[doc=" QualityItem::new(Encoding::EncodingExt(\"*\".to_owned()), Quality(0)),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (AcceptEncoding, "Accept-Encoding") => (QualityItem)* test_accept_encoding { diff --git a/src/header/common/accept_language.rs b/src/header/common/accept_language.rs index 0b761729..ecee89a9 100644 --- a/src/header/common/accept_language.rs +++ b/src/header/common/accept_language.rs @@ -17,6 +17,52 @@ header! { #[doc="# Example values"] #[doc="* `da, en-gb;q=0.8, en;q=0.7`"] #[doc="* `en-us;q=1.0, en;q=0.5, fr`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptLanguage, Language, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptLanguage(vec!["] + #[doc=" qitem("] + #[doc=" Language {"] + #[doc=" primary: \"en\".to_owned(),"] + #[doc=" sub: Some(\"us\".to_owned()),"] + #[doc=" }"] + #[doc=" ),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptLanguage, Language, QualityItem, Quality, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptLanguage(vec!["] + #[doc=" qitem("] + #[doc=" Language {"] + #[doc=" primary: \"da\".to_owned(),"] + #[doc=" sub: None,"] + #[doc=" }"] + #[doc=" ),"] + #[doc=" QualityItem::new("] + #[doc=" Language {"] + #[doc=" primary: \"en\".to_owned(),"] + #[doc=" sub: Some(\"gb\".to_owned()),"] + #[doc=" },"] + #[doc=" Quality(800),"] + #[doc=" ),"] + #[doc=" QualityItem::new("] + #[doc=" Language {"] + #[doc=" primary: \"en\".to_owned(),"] + #[doc=" sub: None,"] + #[doc=" },"] + #[doc=" Quality(700),"] + #[doc=" ),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (AcceptLanguage, "Accept-Language") => (QualityItem)+ test_accept_language { diff --git a/src/header/common/accept_ranges.rs b/src/header/common/accept_ranges.rs index ffcceeeb..f63bf7bb 100644 --- a/src/header/common/accept_ranges.rs +++ b/src/header/common/accept_ranges.rs @@ -18,6 +18,33 @@ header! { #[doc="* `none`"] #[doc="* `unknown-unit`"] #[doc="```"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptRanges, RangeUnit};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(AcceptRanges(vec![RangeUnit::Bytes]));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptRanges, RangeUnit};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(AcceptRanges(vec![RangeUnit::None]));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AcceptRanges, RangeUnit};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AcceptRanges(vec!["] + #[doc=" RangeUnit::Unregistered(\"nibbles\".to_owned()),"] + #[doc=" RangeUnit::Bytes,"] + #[doc=" RangeUnit::Unregistered(\"doublets\".to_owned()),"] + #[doc=" RangeUnit::Unregistered(\"quadlets\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (AcceptRanges, "Accept-Ranges") => (RangeUnit)+ test_acccept_ranges { diff --git a/src/header/common/access_control_allow_headers.rs b/src/header/common/access_control_allow_headers.rs index eda90952..4185648a 100644 --- a/src/header/common/access_control_allow_headers.rs +++ b/src/header/common/access_control_allow_headers.rs @@ -15,6 +15,41 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `accept-language, date`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate unicase;"] + #[doc="# fn main() {"] + #[doc="// extern crate unicase;"] + #[doc=""] + #[doc="use hyper::header::{Headers, AccessControlAllowHeaders};"] + #[doc="use unicase::UniCase;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AccessControlAllowHeaders(vec![UniCase(\"date\".to_owned())])"] + #[doc=");"] + #[doc="# }"] + #[doc="```"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate unicase;"] + #[doc="# fn main() {"] + #[doc="// extern crate unicase;"] + #[doc=""] + #[doc="use hyper::header::{Headers, AccessControlAllowHeaders};"] + #[doc="use unicase::UniCase;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AccessControlAllowHeaders(vec!["] + #[doc=" UniCase(\"accept-language\".to_owned()),"] + #[doc=" UniCase(\"date\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="# }"] + #[doc="```"] (AccessControlAllowHeaders, "Access-Control-Allow-Headers") => (UniCase)* test_access_control_allow_headers { diff --git a/src/header/common/access_control_allow_methods.rs b/src/header/common/access_control_allow_methods.rs index 712e0071..42b739de 100644 --- a/src/header/common/access_control_allow_methods.rs +++ b/src/header/common/access_control_allow_methods.rs @@ -15,6 +15,31 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `PUT, DELETE, XMODIFY`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AccessControlAllowMethods};"] + #[doc="use hyper::method::Method;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AccessControlAllowMethods(vec![Method::Get])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AccessControlAllowMethods};"] + #[doc="use hyper::method::Method;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AccessControlAllowMethods(vec!["] + #[doc=" Method::Get,"] + #[doc=" Method::Post,"] + #[doc=" Method::Patch,"] + #[doc=" Method::Extension(\"COPY\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (AccessControlAllowMethods, "Access-Control-Allow-Methods") => (Method)* test_access_control_allow_methods { diff --git a/src/header/common/access_control_allow_origin.rs b/src/header/common/access_control_allow_origin.rs index fff5ff3d..2441aeb5 100644 --- a/src/header/common/access_control_allow_origin.rs +++ b/src/header/common/access_control_allow_origin.rs @@ -20,6 +20,33 @@ use header::{Header, HeaderFormat}; /// * `null` /// * `*` /// * `http://google.com/` +/// +/// # Examples +/// ``` +/// use hyper::header::{Headers, AccessControlAllowOrigin}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// AccessControlAllowOrigin::Any +/// ); +/// ``` +/// ``` +/// use hyper::header::{Headers, AccessControlAllowOrigin}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// AccessControlAllowOrigin::Null, +/// ); +/// ``` +/// ``` +/// use hyper::header::{Headers, AccessControlAllowOrigin}; +/// use hyper::Url; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// AccessControlAllowOrigin::Value(Url::parse("http://hyper.rs").unwrap()) +/// ); +/// ``` #[derive(Clone, PartialEq, Debug)] pub enum AccessControlAllowOrigin { /// Allow all origins diff --git a/src/header/common/access_control_max_age.rs b/src/header/common/access_control_max_age.rs index becd0030..1f92be8e 100644 --- a/src/header/common/access_control_max_age.rs +++ b/src/header/common/access_control_max_age.rs @@ -12,6 +12,14 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `531`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AccessControlMaxAge};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(AccessControlMaxAge(1728000u32));"] + #[doc="```"] (AccessControlMaxAge, "Access-Control-Max-Age") => [u32] test_access_control_max_age { diff --git a/src/header/common/access_control_request_headers.rs b/src/header/common/access_control_request_headers.rs index 859d5feb..3338ef65 100644 --- a/src/header/common/access_control_request_headers.rs +++ b/src/header/common/access_control_request_headers.rs @@ -15,6 +15,41 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `accept-language, date`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate unicase;"] + #[doc="# fn main() {"] + #[doc="// extern crate unicase;"] + #[doc=""] + #[doc="use hyper::header::{Headers, AccessControlRequestHeaders};"] + #[doc="use unicase::UniCase;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AccessControlRequestHeaders(vec![UniCase(\"date\".to_owned())])"] + #[doc=");"] + #[doc="# }"] + #[doc="```"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate unicase;"] + #[doc="# fn main() {"] + #[doc="// extern crate unicase;"] + #[doc=""] + #[doc="use hyper::header::{Headers, AccessControlRequestHeaders};"] + #[doc="use unicase::UniCase;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" AccessControlRequestHeaders(vec!["] + #[doc=" UniCase(\"accept-language\".to_owned()),"] + #[doc=" UniCase(\"date\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="# }"] + #[doc="```"] (AccessControlRequestHeaders, "Access-Control-Request-Headers") => (UniCase)* test_access_control_request_headers { diff --git a/src/header/common/access_control_request_method.rs b/src/header/common/access_control_request_method.rs index 6c8bdd8f..4c931f4f 100644 --- a/src/header/common/access_control_request_method.rs +++ b/src/header/common/access_control_request_method.rs @@ -13,6 +13,15 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `GET`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, AccessControlRequestMethod};"] + #[doc="use hyper::method::Method;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(AccessControlRequestMethod(Method::Get));"] + #[doc="```"] (AccessControlRequestMethod, "Access-Control-Request-Method") => [Method] test_access_control_request_method { diff --git a/src/header/common/allow.rs b/src/header/common/allow.rs index 218a449b..501c3ac2 100644 --- a/src/header/common/allow.rs +++ b/src/header/common/allow.rs @@ -17,6 +17,31 @@ header! { #[doc="* `GET, HEAD, PUT`"] #[doc="* `OPTIONS, GET, PUT, POST, DELETE, HEAD, TRACE, CONNECT, PATCH, fOObAr`"] #[doc="* ``"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Allow};"] + #[doc="use hyper::method::Method;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" Allow(vec![Method::Get])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Allow};"] + #[doc="use hyper::method::Method;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" Allow(vec!["] + #[doc=" Method::Get,"] + #[doc=" Method::Post,"] + #[doc=" Method::Patch,"] + #[doc=" Method::Extension(\"COPY\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (Allow, "Allow") => (Method)* test_allow { diff --git a/src/header/common/authorization.rs b/src/header/common/authorization.rs index f7724cba..495ff1e1 100644 --- a/src/header/common/authorization.rs +++ b/src/header/common/authorization.rs @@ -20,6 +20,27 @@ use header::{Header, HeaderFormat}; /// /// # Example values /// * `Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==` +/// +/// # Examples +/// ``` +/// use hyper::header::{Headers, Authorization}; +/// +/// let mut headers = Headers::new(); +/// headers.set(Authorization("let me in".to_owned())); +/// ``` +/// ``` +/// use hyper::header::{Headers, Authorization, Basic}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// Authorization( +/// Basic { +/// username: "Aladdin".to_owned(), +/// password: Some("open sesame".to_owned()) +/// } +/// ) +/// ); +/// ``` #[derive(Clone, PartialEq, Debug)] pub struct Authorization(pub S); diff --git a/src/header/common/cache_control.rs b/src/header/common/cache_control.rs index c937c018..68e8546f 100644 --- a/src/header/common/cache_control.rs +++ b/src/header/common/cache_control.rs @@ -20,6 +20,30 @@ use header::parsing::{from_one_comma_delimited, fmt_comma_delimited}; /// * `no-cache` /// * `private, community="UCI"` /// * `max-age=30` +/// +/// # Examples +/// ``` +/// use hyper::header::{Headers, CacheControl, CacheDirective}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// CacheControl(vec![CacheDirective::MaxAge(86400u32)]) +/// ); +/// ``` +/// ``` +/// use hyper::header::{Headers, CacheControl, CacheDirective}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// CacheControl(vec![ +/// CacheDirective::NoCache, +/// CacheDirective::Private, +/// CacheDirective::MaxAge(360u32), +/// CacheDirective::Extension("foo".to_owned(), +/// Some("bar".to_owned())), +/// ]) +/// ); +/// ``` #[derive(PartialEq, Clone, Debug)] pub struct CacheControl(pub Vec); diff --git a/src/header/common/connection.rs b/src/header/common/connection.rs index cfe5059d..e5182b2e 100644 --- a/src/header/common/connection.rs +++ b/src/header/common/connection.rs @@ -62,6 +62,32 @@ header! { #[doc="* `close`"] #[doc="* `keep-alive`"] #[doc="* `upgrade`"] + #[doc="```"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Connection};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Connection::keep_alive());"] + #[doc="```"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate unicase;"] + #[doc="# fn main() {"] + #[doc="// extern crate unicase;"] + #[doc=""] + #[doc="use hyper::header::{Headers, Connection, ConnectionOption};"] + #[doc="use unicase::UniCase;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" Connection(vec!["] + #[doc=" ConnectionOption::ConnectionHeader(UniCase(\"upgrade\".to_owned())),"] + #[doc=" ])"] + #[doc=");"] + #[doc="# }"] + #[doc="```"] (Connection, "Connection") => (ConnectionOption)+ test_connection { diff --git a/src/header/common/content_encoding.rs b/src/header/common/content_encoding.rs index 1324c0be..719633f4 100644 --- a/src/header/common/content_encoding.rs +++ b/src/header/common/content_encoding.rs @@ -19,6 +19,25 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `gzip`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentEncoding, Encoding};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(ContentEncoding(vec![Encoding::Chunked]));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentEncoding, Encoding};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" ContentEncoding(vec!["] + #[doc=" Encoding::Gzip,"] + #[doc=" Encoding::Chunked,"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (ContentEncoding, "Content-Encoding") => (Encoding)+ test_content_encoding { diff --git a/src/header/common/content_language.rs b/src/header/common/content_language.rs index 7105ce8a..dc7e577d 100644 --- a/src/header/common/content_language.rs +++ b/src/header/common/content_language.rs @@ -17,6 +17,44 @@ header! { #[doc="# Example values"] #[doc="* `da`"] #[doc="* `mi, en`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentLanguage, Language, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" ContentLanguage(vec!["] + #[doc=" qitem("] + #[doc=" Language { "] + #[doc=" primary: \"en\".to_owned(),"] + #[doc=" sub: None,"] + #[doc=" }"] + #[doc=" ),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentLanguage, Language, qitem};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" ContentLanguage(vec!["] + #[doc=" qitem("] + #[doc=" Language {"] + #[doc=" primary: \"da\".to_owned(),"] + #[doc=" sub: None,"] + #[doc=" }"] + #[doc=" ),"] + #[doc=" qitem("] + #[doc=" Language {"] + #[doc=" primary: \"en\".to_owned(),"] + #[doc=" sub: Some(\"gb\".to_owned()),"] + #[doc=" }"] + #[doc=" ),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (ContentLanguage, "Content-Language") => (QualityItem)+ test_content_language { diff --git a/src/header/common/content_length.rs b/src/header/common/content_length.rs index 39e18878..56cb9c54 100644 --- a/src/header/common/content_length.rs +++ b/src/header/common/content_length.rs @@ -18,6 +18,14 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `3495`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentLength};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(ContentLength(1024u64));"] + #[doc="```"] (ContentLength, "Content-Length") => [u64] test_content_length { diff --git a/src/header/common/content_type.rs b/src/header/common/content_type.rs index a7526bdf..e80825f8 100644 --- a/src/header/common/content_type.rs +++ b/src/header/common/content_type.rs @@ -19,6 +19,29 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `text/html; charset=ISO-8859-4`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentType};"] + #[doc="use hyper::mime::{Mime, TopLevel, SubLevel};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc=""] + #[doc="headers.set("] + #[doc=" ContentType(Mime(TopLevel::Text, SubLevel::Html, vec![]))"] + #[doc=");"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ContentType};"] + #[doc="use hyper::mime::{Mime, TopLevel, SubLevel, Attr, Value};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" ContentType(Mime(TopLevel::Application, SubLevel::Json,"] + #[doc=" vec![(Attr::Charset, Value::Utf8)]))"] + #[doc=""] + #[doc=");"] + #[doc="```"] (ContentType, "Content-Type") => [Mime] test_content_type { diff --git a/src/header/common/cookie.rs b/src/header/common/cookie.rs index 07ff710a..acc0685f 100644 --- a/src/header/common/cookie.rs +++ b/src/header/common/cookie.rs @@ -17,6 +17,24 @@ use cookie::CookieJar; /// # Example values /// * `SID=31d4d96e407aad42` /// * `SID=31d4d96e407aad42; lang=en-US` +/// +/// # Example +/// ``` +/// # extern crate hyper; +/// # extern crate cookie; +/// # fn main() { +/// use hyper::header::{Headers, Cookie}; +/// use cookie::Cookie as CookiePair; +/// +/// let mut headers = Headers::new(); +/// +/// headers.set( +/// Cookie(vec![ +/// CookiePair::new("foo".to_owned(), "bar".to_owned()) +/// ]) +/// ); +/// # } +/// ``` #[derive(Clone, PartialEq, Debug)] pub struct Cookie(pub Vec); diff --git a/src/header/common/date.rs b/src/header/common/date.rs index fa00c477..55b9a588 100644 --- a/src/header/common/date.rs +++ b/src/header/common/date.rs @@ -13,6 +13,21 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `Tue, 15 Nov 1994 08:12:31 GMT`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="# extern crate time;"] + #[doc="# extern crate hyper;"] + #[doc="# fn main() {"] + #[doc="// extern crate time;"] + #[doc=""] + #[doc="use hyper::header::{Headers, Date, HttpDate};"] + #[doc="use time;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Date(HttpDate(time::now())));"] + #[doc="# }"] + #[doc="```"] (Date, "Date") => [HttpDate] test_date { diff --git a/src/header/common/etag.rs b/src/header/common/etag.rs index 32f30036..2fcee703 100644 --- a/src/header/common/etag.rs +++ b/src/header/common/etag.rs @@ -22,6 +22,20 @@ header! { #[doc="* `\"xyzzy\"`"] #[doc="* `W/\"xyzzy\"`"] #[doc="* `\"\"`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ETag, EntityTag};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(ETag(EntityTag::new(false, \"xyzzy\".to_owned())));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, ETag, EntityTag};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(ETag(EntityTag::new(true, \"xyzzy\".to_owned())));"] + #[doc="```"] (ETag, "ETag") => [EntityTag] test_etag { diff --git a/src/header/common/expect.rs b/src/header/common/expect.rs index 109ce707..f380e527 100644 --- a/src/header/common/expect.rs +++ b/src/header/common/expect.rs @@ -13,6 +13,13 @@ use header::{Header, HeaderFormat}; /// > defined by this specification is 100-continue. /// > /// > Expect = "100-continue" +/// +/// # Example +/// ``` +/// use hyper::header::{Headers, Expect}; +/// let mut headers = Headers::new(); +/// headers.set(Expect::Continue); +/// ``` #[derive(Copy, Clone, PartialEq, Debug)] pub enum Expect { /// The value `100-continue`. diff --git a/src/header/common/expires.rs b/src/header/common/expires.rs index 7d203d38..787f890f 100644 --- a/src/header/common/expires.rs +++ b/src/header/common/expires.rs @@ -17,6 +17,21 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `Thu, 01 Dec 1994 16:00:00 GMT`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate time;"] + #[doc="# fn main() {"] + #[doc="// extern crate time;"] + #[doc=""] + #[doc="use hyper::header::{Headers, Expires, HttpDate};"] + #[doc="use time::{self, Duration};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Expires(HttpDate(time::now() + Duration::days(1))));"] + #[doc="# }"] + #[doc="```"] (Expires, "Expires") => [HttpDate] test_expires { diff --git a/src/header/common/from.rs b/src/header/common/from.rs index 4c6ce739..0e1e462c 100644 --- a/src/header/common/from.rs +++ b/src/header/common/from.rs @@ -9,6 +9,14 @@ header! { #[doc="From = mailbox"] #[doc="mailbox = "] #[doc="```"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="use hyper::header::{Headers, From};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(From(\"webmaster@example.org\".to_owned()));"] + #[doc="```"] // FIXME: Maybe use mailbox? (From, "From") => [String] diff --git a/src/header/common/host.rs b/src/header/common/host.rs index 4f628dc6..a3de4bcb 100644 --- a/src/header/common/host.rs +++ b/src/header/common/host.rs @@ -9,6 +9,30 @@ use header::parsing::from_one_raw_str; /// /// Currently is just a String, but it should probably become a better type, /// like url::Host or something. +/// +/// # Examples +/// ``` +/// use hyper::header::{Headers, Host}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// Host{ +/// hostname: "hyper.rs".to_owned(), +/// port: None, +/// } +/// ); +/// ``` +/// ``` +/// use hyper::header::{Headers, Host}; +/// +/// let mut headers = Headers::new(); +/// headers.set( +/// Host{ +/// hostname: "hyper.rs".to_owned(), +/// port: Some(8080), +/// } +/// ); +/// ``` #[derive(Clone, PartialEq, Debug)] pub struct Host { /// The hostname, such a example.domain. diff --git a/src/header/common/if_match.rs b/src/header/common/if_match.rs index e3b466a3..742f299e 100644 --- a/src/header/common/if_match.rs +++ b/src/header/common/if_match.rs @@ -24,6 +24,26 @@ header! { #[doc="# Example values"] #[doc="* `\"xyzzy\"`"] #[doc="* \"xyzzy\", \"r2d2xxxx\", \"c3piozzzz\""] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, IfMatch};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(IfMatch::Any);"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, IfMatch, EntityTag};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" IfMatch::Items(vec!["] + #[doc=" EntityTag::new(false, \"xyzzy\".to_owned()),"] + #[doc=" EntityTag::new(false, \"foobar\".to_owned()),"] + #[doc=" EntityTag::new(false, \"bazquux\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (IfMatch, "If-Match") => {Any / (EntityTag)+} test_if_match { diff --git a/src/header/common/if_modified_since.rs b/src/header/common/if_modified_since.rs index 59e0c6f2..ea878bb5 100644 --- a/src/header/common/if_modified_since.rs +++ b/src/header/common/if_modified_since.rs @@ -17,6 +17,21 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `Sat, 29 Oct 1994 19:43:31 GMT`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate time;"] + #[doc="# fn main() {"] + #[doc="// extern crate time;"] + #[doc=""] + #[doc="use hyper::header::{Headers, IfModifiedSince, HttpDate};"] + #[doc="use time::{self, Duration};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(IfModifiedSince(HttpDate(time::now() - Duration::days(1))));"] + #[doc="# }"] + #[doc="```"] (IfModifiedSince, "If-Modified-Since") => [HttpDate] test_if_modified_since { diff --git a/src/header/common/if_none_match.rs b/src/header/common/if_none_match.rs index 8fb249d5..ba9e9dbf 100644 --- a/src/header/common/if_none_match.rs +++ b/src/header/common/if_none_match.rs @@ -26,6 +26,26 @@ header! { #[doc="* `\"xyzzy\", \"r2d2xxxx\", \"c3piozzzz\"`"] #[doc="* `W/\"xyzzy\", W/\"r2d2xxxx\", W/\"c3piozzzz\"`"] #[doc="* `*`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, IfNoneMatch};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(IfNoneMatch::Any);"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, IfNoneMatch, EntityTag};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" IfNoneMatch::Items(vec!["] + #[doc=" EntityTag::new(false, \"xyzzy\".to_owned()),"] + #[doc=" EntityTag::new(false, \"foobar\".to_owned()),"] + #[doc=" EntityTag::new(false, \"bazquux\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (IfNoneMatch, "If-None-Match") => {Any / (EntityTag)+} test_if_none_match { diff --git a/src/header/common/if_range.rs b/src/header/common/if_range.rs index 1f02e539..874cd6fd 100644 --- a/src/header/common/if_range.rs +++ b/src/header/common/if_range.rs @@ -24,6 +24,27 @@ use header::{self, Header, HeaderFormat, EntityTag, HttpDate}; /// # Example values /// * `Sat, 29 Oct 1994 19:43:31 GMT` /// * `\"xyzzy\"` +/// +/// # Examples +/// ``` +/// use hyper::header::{Headers, IfRange, EntityTag}; +/// +/// let mut headers = Headers::new(); +/// headers.set(IfRange::EntityTag(EntityTag::new(false, "xyzzy".to_owned()))); +/// ``` +/// ``` +/// # extern crate hyper; +/// # extern crate time; +/// # fn main() { +/// // extern crate time; +/// +/// use hyper::header::{Headers, IfRange, HttpDate}; +/// use time::{self, Duration}; +/// +/// let mut headers = Headers::new(); +/// headers.set(IfRange::Date(HttpDate(time::now() - Duration::days(1)))); +/// # } +/// ``` #[derive(Clone, Debug, PartialEq)] pub enum IfRange { /// The entity-tag the client has of the resource diff --git a/src/header/common/if_unmodified_since.rs b/src/header/common/if_unmodified_since.rs index 7ec2e20c..ebb9806a 100644 --- a/src/header/common/if_unmodified_since.rs +++ b/src/header/common/if_unmodified_since.rs @@ -17,6 +17,21 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `Sat, 29 Oct 1994 19:43:31 GMT`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate time;"] + #[doc="# fn main() {"] + #[doc="// extern crate time;"] + #[doc=""] + #[doc="use hyper::header::{Headers, IfUnmodifiedSince, HttpDate};"] + #[doc="use time::{self, Duration};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(IfUnmodifiedSince(HttpDate(time::now() - Duration::days(1))));"] + #[doc="# }"] + #[doc="```"] (IfUnmodifiedSince, "If-Unmodified-Since") => [HttpDate] test_if_unmodified_since { diff --git a/src/header/common/last_modified.rs b/src/header/common/last_modified.rs index ab9830e3..6232206c 100644 --- a/src/header/common/last_modified.rs +++ b/src/header/common/last_modified.rs @@ -16,6 +16,21 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `Sat, 29 Oct 1994 19:43:31 GMT`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate time;"] + #[doc="# fn main() {"] + #[doc="// extern crate time;"] + #[doc=""] + #[doc="use hyper::header::{Headers, LastModified, HttpDate};"] + #[doc="use time::{self, Duration};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(LastModified(HttpDate(time::now() - Duration::days(1))));"] + #[doc="# }"] + #[doc="```"] (LastModified, "Last-Modified") => [HttpDate] test_last_modified { diff --git a/src/header/common/location.rs b/src/header/common/location.rs index c1cb1f24..ff779c77 100644 --- a/src/header/common/location.rs +++ b/src/header/common/location.rs @@ -15,6 +15,20 @@ header! { #[doc="# Example values"] #[doc="* `/People.html#tim`"] #[doc="* `http://www.example.net/index.html`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Location};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Location(\"/People.html#tim\".to_owned()));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Location};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Location(\"http://www.example.com/index.html\".to_owned()));"] + #[doc="```"] // TODO: Use URL (Location, "Location") => [String] diff --git a/src/header/common/pragma.rs b/src/header/common/pragma.rs index 50e82966..39dee7e8 100644 --- a/src/header/common/pragma.rs +++ b/src/header/common/pragma.rs @@ -16,6 +16,20 @@ use header::{Header, HeaderFormat, parsing}; /// > specification deprecates such extensions to improve interoperability. /// /// Spec: https://tools.ietf.org/html/rfc7234#section-5.4 +/// +/// # Examples +/// ``` +/// use hyper::header::{Headers, Pragma}; +/// +/// let mut headers = Headers::new(); +/// headers.set(Pragma::NoCache); +/// ``` +/// ``` +/// use hyper::header::{Headers, Pragma}; +/// +/// let mut headers = Headers::new(); +/// headers.set(Pragma::Ext("foobar".to_owned())); +/// ``` #[derive(Clone, PartialEq, Debug)] pub enum Pragma { /// Corresponds to the `no-cache` value. diff --git a/src/header/common/referer.rs b/src/header/common/referer.rs index ecd00751..d73635ec 100644 --- a/src/header/common/referer.rs +++ b/src/header/common/referer.rs @@ -15,6 +15,20 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `http://www.example.org/hypertext/Overview.html`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Referer};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Referer(\"/People.html#tim\".to_owned()));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Referer};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Referer(\"http://www.example.com/index.html\".to_owned()));"] + #[doc="```"] // TODO: Use URL (Referer, "Referer") => [String] diff --git a/src/header/common/server.rs b/src/header/common/server.rs index bfdac93a..a0ccfa98 100644 --- a/src/header/common/server.rs +++ b/src/header/common/server.rs @@ -16,6 +16,14 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `CERN/3.0 libwww/2.17`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Server};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Server(\"hyper/0.5.2\".to_owned()));"] + #[doc="```"] // TODO: Maybe parse as defined in the spec? (Server, "Server") => [String] diff --git a/src/header/common/set_cookie.rs b/src/header/common/set_cookie.rs index a2b02f1e..a092319f 100644 --- a/src/header/common/set_cookie.rs +++ b/src/header/common/set_cookie.rs @@ -54,6 +54,31 @@ use cookie::CookieJar; /// * `lang=en-US; Expires=Wed, 09 Jun 2021 10:18:14 GMT` /// * `lang=; Expires=Sun, 06 Nov 1994 08:49:37 GMT` /// * `lang=en-US; Path=/; Domain=example.com` +/// +/// # Example +/// ``` +/// # extern crate hyper; +/// # extern crate cookie; +/// # fn main() { +/// // extern crate cookie; +/// +/// use hyper::header::{Headers, SetCookie}; +/// use cookie::Cookie as CookiePair; +/// +/// let mut headers = Headers::new(); +/// let mut cookie = CookiePair::new("foo".to_owned(), "bar".to_owned()); +/// +/// cookie.path = Some("/path".to_owned()); +/// cookie.domain = Some("example.com".to_owned()); +/// +/// headers.set( +/// SetCookie(vec![ +/// cookie, +/// CookiePair::new("baz".to_owned(), "quux".to_owned()), +/// ]) +/// ); +/// # } +/// ``` #[derive(Clone, PartialEq, Debug)] pub struct SetCookie(pub Vec); diff --git a/src/header/common/transfer_encoding.rs b/src/header/common/transfer_encoding.rs index 5ae98fb4..81d17c62 100644 --- a/src/header/common/transfer_encoding.rs +++ b/src/header/common/transfer_encoding.rs @@ -16,6 +16,19 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `gzip, chunked`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="use hyper::header::{Headers, TransferEncoding, Encoding};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" TransferEncoding(vec!["] + #[doc=" Encoding::Gzip,"] + #[doc=" Encoding::Chunked,"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (TransferEncoding, "Transfer-Encoding") => (Encoding)+ transfer_encoding { diff --git a/src/header/common/upgrade.rs b/src/header/common/upgrade.rs index 5ae7cf71..638dc366 100644 --- a/src/header/common/upgrade.rs +++ b/src/header/common/upgrade.rs @@ -26,6 +26,27 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11`"] + #[doc=""] + #[doc="# Examples"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Upgrade, Protocol, ProtocolName};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Upgrade(vec![Protocol::new(ProtocolName::WebSocket, None)]));"] + #[doc="```"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Upgrade, Protocol, ProtocolName};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" Upgrade(vec!["] + #[doc=" Protocol::new(ProtocolName::Http, Some(\"2.0\".to_owned())),"] + #[doc=" Protocol::new(ProtocolName::Unregistered(\"SHTTP\".to_owned()), Some(\"1.3\".to_owned())),"] + #[doc=" Protocol::new(ProtocolName::Unregistered(\"IRC\".to_owned()), Some(\"6.9\".to_owned())),"] + #[doc=" Protocol::new(ProtocolName::Unregistered(\"RTA\".to_owned()), Some(\"x11\".to_owned())),"] + #[doc=" ])"] + #[doc=");"] + #[doc="```"] (Upgrade, "Upgrade") => (Protocol)+ test_upgrade { diff --git a/src/header/common/user_agent.rs b/src/header/common/user_agent.rs index 08fe573d..2c57eca2 100644 --- a/src/header/common/user_agent.rs +++ b/src/header/common/user_agent.rs @@ -23,6 +23,14 @@ header! { #[doc=""] #[doc="# Notes"] #[doc="* The parser does not split the value"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="use hyper::header::{Headers, UserAgent};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(UserAgent(\"hyper/0.5.2\".to_owned()));"] + #[doc="```"] (UserAgent, "User-Agent") => [String] test_user_agent { diff --git a/src/header/common/vary.rs b/src/header/common/vary.rs index d49058ad..226b6726 100644 --- a/src/header/common/vary.rs +++ b/src/header/common/vary.rs @@ -17,6 +17,34 @@ header! { #[doc=""] #[doc="# Example values"] #[doc="* `accept-encoding, accept-language`"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="use hyper::header::{Headers, Vary};"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set(Vary::Any);"] + #[doc="```"] + #[doc=""] + #[doc="# Example"] + #[doc="```"] + #[doc="# extern crate hyper;"] + #[doc="# extern crate unicase;"] + #[doc="# fn main() {"] + #[doc="// extern crate unicase;"] + #[doc=""] + #[doc="use hyper::header::{Headers, Vary};"] + #[doc="use unicase::UniCase;"] + #[doc=""] + #[doc="let mut headers = Headers::new();"] + #[doc="headers.set("] + #[doc=" Vary::Items(vec!["] + #[doc=" UniCase(\"accept-encoding\".to_owned()),"] + #[doc=" UniCase(\"accept-language\".to_owned()),"] + #[doc=" ])"] + #[doc=");"] + #[doc="# }"] + #[doc="```"] (Vary, "Vary") => {Any / (UniCase)+} test_vary {