Merge pull request #29 from carols10cents/more-orgs

Implement support for listing organizations

examples/orgs.rs

@@ -23,6 +23,20 @@ fn main() {
             for repo in github.org_repos("rust-lang").list(&options).unwrap() {
                 println!("{}", repo.name)
             }
+
+            println!("");
+
+            println!("My organizations:");
+            for org in github.orgs().list().unwrap() {
+                println!("{}", org.login)
+            }
+
+            println!("");
+
+            println!("softprops' organizations:");
+            for org in github.user_orgs("softprops").list().unwrap() {
+                println!("{}", org.login)
+            }
         }
         _ => println!("example missing GITHUB_TOKEN"),
     }

src/lib.rs

@@ -21,6 +21,7 @@ pub mod releases;
 pub mod repositories;
 pub mod statuses;
 pub mod pulls;
+pub mod organizations;
 
 pub use rep::*;
 pub use errors::Error;
@@ -31,6 +32,7 @@ use hyper::method::Method;
 use hyper::header::{Authorization, ContentLength, UserAgent};
 use hyper::status::StatusCode;
 use repositories::{Repository, Repositories, UserRepositories, OrganizationRepositories};
+use organizations::{Organizations, UserOrganizations};
 use std::fmt;
 use std::io::Read;
 use url::Url;
@@ -166,6 +168,20 @@ impl<'a> Github<'a> {
         Repositories::new(self)
     }
 
+    /// Return a reference to the collection of organizations that the user
+    /// associated with the current authentication credentials is in
+    pub fn orgs(&self) -> Organizations {
+        Organizations::new(self)
+    }
+
+    /// Return a reference to the collection of organizations a user
+    /// is publicly associated with
+    pub fn user_orgs<U>(&self, user: U) -> UserOrganizations
+        where U: Into<String>
+    {
+        UserOrganizations::new(self, user)
+    }
+
     /// Return a reference to an interface that provides access to a user's gists
     pub fn user_gists<O>(&self, owner: O) -> UserGists
         where O: Into<String>

src/organizations.rs

@@ -0,0 +1,45 @@
+use self::super::{Github, Result};
+use rep::Org;
+
+pub struct Organizations<'a> {
+    github: &'a Github<'a>,
+}
+
+impl<'a> Organizations<'a> {
+    pub fn new(github: &'a Github<'a>) -> Organizations<'a> {
+        Organizations { github: github }
+    }
+
+    fn path(&self, more: &str) -> String {
+        format!("/user/orgs{}", more)
+    }
+
+    /// list the authenticated user's organizations
+    /// https://developer.github.com/v3/orgs/#list-your-organizations
+    pub fn list(&self) -> Result<Vec<Org>> {
+        self.github.get::<Vec<Org>>(&self.path(""))
+    }
+}
+
+pub struct UserOrganizations<'a> {
+    github: &'a Github<'a>,
+    user: String,
+}
+
+impl<'a> UserOrganizations<'a> {
+    pub fn new<U>(github: &'a Github<'a>, user: U) -> UserOrganizations<'a>
+        where U: Into<String>
+    {
+        UserOrganizations { github: github, user: user.into() }
+    }
+
+    fn path(&self, more: &str) -> String {
+        format!("/users/{}/orgs{}", self.user, more)
+    }
+
+    /// list the organizations this user is publicly associated with
+    /// https://developer.github.com/v3/orgs/#list-user-organizations
+    pub fn list(&self) -> Result<Vec<Org>> {
+        self.github.get::<Vec<Org>>(&self.path(""))
+    }
+}

src/rep.rs.in

@@ -454,6 +454,21 @@ pub struct User {
     pub site_admin: bool,
 }
 
+#[derive(Debug, Deserialize)]
+pub struct Org {
+    pub login: String,
+    pub id: u64,
+    pub url: String,
+    pub repos_url: String,
+    pub events_url: String,
+    pub hooks_url: String,
+    pub issues_url: String,
+    pub members_url: String,
+    pub public_members_url: String,
+    pub avatar_url: String,
+    pub description: Option<String>,
+}
+
 #[derive(Debug, Deserialize)]
 pub struct Commit {
     pub label: String,