url: improve tests and docs for the authority method

Signed-off-by: Alejandro Martinez Ruiz <[email protected]>

Author: unleashed

url/src/lib.rs

@@ -684,6 +684,7 @@ impl Url {
     /// Non-ASCII domains are punycode-encoded per IDNA if this is the host
     /// of a special URL, or percent encoded for non-special URLs.
     /// IPv6 addresses are given between `[` and `]` brackets.
+    /// Ports are omitted if they match the well known port of a special URL.
     ///
     /// Username and password are percent-encoded.
     ///
@@ -702,10 +703,20 @@ impl Url {
     /// assert_eq!(url.authority(), "");
     /// let url = Url::parse("http://example.com/tmp/foo")?;
     /// assert_eq!(url.authority(), "example.com");
+    /// let url = Url::parse("ftp://127.0.0.1:21/")?;
+    /// assert_eq!(url.authority(), "127.0.0.1");
+    /// let url = Url::parse("ftp://[email protected]:2121/")?;
+    /// assert_eq!(url.authority(), "[email protected]:2121");
     /// let url = Url::parse("https://:@example.com/")?;
     /// assert_eq!(url.authority(), "example.com");
-    /// let url = Url::parse("https://user:[email protected]:8080/tmp/foo")?;
-    /// assert_eq!(url.authority(), "user:[email protected]:8080");
+    /// let url = Url::parse("https://:password@[::1]:8080/")?;
+    /// assert_eq!(url.authority(), ":password@[::1]:8080");
+    /// let url = Url::parse("gopher://user:@àlex.example.com:70")?;
+    /// assert_eq!(url.authority(), "user@%C3%A0lex.example.com:70");
+    /// let url = Url::parse("irc://àlex:àlex@àlex.рф.example.com:6667/foo")?;
+    /// assert_eq!(url.authority(), "%C3%A0lex:%C3%A0lex@%C3%A0lex.%D1%80%D1%84.example.com:6667");
+    /// let url = Url::parse("https://àlex:àlex@àlex.рф.example.com:443/foo")?;
+    /// assert_eq!(url.authority(), "%C3%A0lex:%C3%[email protected]");
     /// # Ok(())
     /// # }
     /// # run().unwrap();