add user emails struct and api to fetch them

examples/users.rs

@@ -27,5 +27,11 @@ async fn main() -> Result<(), Box<dyn Error>> {
         Ok(user) => println!("{:#?}", user),
         Err(err) => println!("err {:#?}", err),
     }
+
+    match github.users().authenticated_emails().await {
+        Ok(emails) => println!("{:#?}", emails),
+        Err(err) => println!("err {:#?}", err),
+    }
+
     Ok(())
 }

src/users.rs

@@ -61,6 +61,13 @@ pub struct AuthenticatedUser {
     pub updated_at: String, // TODO: change to `DateTime`?
 }
 
+#[derive(Debug, Deserialize)]
+pub struct UserEmail {
+    pub email: String,
+    pub primary: bool,
+    pub verified: bool,
+}
+
 /// Query user information
 pub struct Users {
     github: Github,
@@ -76,6 +83,11 @@ impl Users {
         self.github.get("/user")
     }
 
+    /// Get current authenticated user's email list
+    pub fn authenticated_emails(&self) -> Future<Vec<UserEmail>> {
+        self.github.get("/user/emails")
+    }
+
     pub fn get<U>(&self, username: U) -> Future<User>
     where
         U: Into<String>,