Restructure modules and packages in a clean way

The docs has increased lines of code, so I split it

5 files changed, 248 insertions, 233 deletions

diff --git a/pygithub3/services/users.py b/pygithub3/services/users.py
deleted file mode 100644
index 0c8c7aa..0000000
--- a/pygithub3/services/users.py
+++ /dev/null
@@ -1,233 +0,0 @@
-#!/usr/bin/env python
-# -*- encoding: utf-8 -*-
-
-from .base import Service
-
-
-class Keys(Service):
-    """ Consume `Keys API <http://developer.github.com/v3/users/keys/>`_
-
-    .. warning::
-
-        You must be authenticated for all requests
-    """
-
-    def list(self):
-        """ Get public keys
-
-        :returns: A :doc:`result`
-        """
-        request = self.make_request('users.keys.list')
-        return self._get_result(request)
-
-    def get(self, key_id):
-        """ Get a public key
-
-        :param int key_id: Key id
-        """
-        request = self.make_request('users.keys.get',
-            key_id=key_id)
-        return self._get(request)
-
-    def add(self, data):
-        """ Add a public key
-
-        :param dict data: Key (title and key attributes required)
-
-        ::
-
-            key_service.add(dict(title='host', key='ssh-rsa AAA...'))
-        """
-        request = self.make_request('users.keys.add',
-            body=data)
-        return self._post(request)
-
-    def update(self, key_id, data):
-        """ Update a public key
-
-        :param int key_id: Key id
-        :param dict data: Key (title and key attributes required)
-
-        ::
-
-            key_service.update(42, dict(title='host', key='ssh-rsa AAA...'))
-        """
-        request = self.make_request('users.keys.update',
-            key_id=key_id, body=data)
-        return self._patch(request)
-
-    def delete(self, key_id):
-        """ Delete a public key
-
-        :param int key_id: Key id
-        """
-        request = self.make_request('users.keys.delete',
-            key_id=key_id)
-        self._delete(request)
-
-
-class Followers(Service):
-    """ Consume `Followers API
-    <http://developer.github.com/v3/users/followers/>`_
-    """
-
-    def list(self, user=None):
-        """ Get user's followers
-
-        :param str user: Username
-        :returns: A :doc:`result`
-
-        If you call it without user and you are authenticated, get the
-        authenticated user's followers
-
-        .. warning::
-
-            If you aren't authenticated and call without user, it returns 403
-
-        ::
-
-            followers_service.list()
-            followers_service.list('octocat')
-        """
-        request = self.make_request('users.followers.list', user=user)
-        return self._get_result(request)
-
-    def list_following(self, user=None):
-        """ Get who a user is following
-
-        :param str user: Username
-        :returns: A :doc:`result`
-
-        If you call it without user and you are authenticated, get the
-        authenticated user's followings
-
-        .. warning::
-
-            If you aren't authenticated and call without user, it returns 403
-
-        ::
-
-            followers_service.list_following()
-            followers_service.list_following('octocat')
-        """
-        request = self.make_request('users.followers.listfollowing', user=user)
-        return self._get_result(request)
-
-    def is_following(self, user):
-        """ Check if you are following a user
-
-        :param str user: Username
-        """
-        request = self.make_request('users.followers.isfollowing', user=user)
-        return self._bool(request)
-
-    def follow(self, user):
-        """ Follow a user
-
-        :param str user: Username
-
-        .. warning::
-
-            You must be authenticated
-        """
-        request = self.make_request('users.followers.follow', user=user)
-        self._put(request)
-
-    def unfollow(self, user):
-        """ Unfollow a user
-
-        :param str user: Username
-
-        .. warning::
-
-            You must be authenticated
-        """
-        request = self.make_request('users.followers.unfollow', user=user)
-        self._delete(request)
-
-
-class Emails(Service):
-    """ Consume `Emails API <http://developer.github.com/v3/users/emails/>`_
-
-    .. warning::
-
-        You must be authenticated for all requests
-    """
-
-    def list(self):
-        """ Get user's emails
-
-        :returns: A :doc:`result`
-        """
-        request = self.make_request('users.emails.list')
-        return self._get_result(request)
-
-    def add(self, *emails):
-        """ Add emails
-
-        :param list emails: Emails to add
-
-        .. note::
-
-            It rejects non-valid emails
-
-        ::
-
-            email_service.add('test1@xample.com', 'test2@xample.com')
-        """
-        request = self.make_request('users.emails.add', body=emails)
-        return self._post(request)
-
-    def delete(self, *emails):
-        """ Delete emails
-
-        :param list emails: List of emails
-
-        ::
-
-            email_service.delete('test1@xample.com', 'test2@xample.com')
-        """
-        request = self.make_request('users.emails.delete', body=emails)
-        self._delete(request)
-
-
-class User(Service):
-    """ Consume `Users API <http://developer.github.com/v3/users>`_ """
-
-    def __init__(self, **config):
-        self.keys = Keys(**config)
-        self.emails = Emails(**config)
-        self.followers = Followers(**config)
-        super(User, self).__init__(**config)
-
-    def get(self, user=None):
-        """ Get a single user
-
-        :param str user: Username
-
-        If you call it without user and you are authenticated, get the
-        authenticated user.
-
-        .. warning::
-
-            If you aren't authenticated and call without user, it returns 403
-
-        ::
-
-            user_service.get('copitux')
-            user_service.get()
-        """
-        request = self.make_request('users.get', user=user)
-        return self._get(request)
-
-    def update(self, data):
-        """ Update the authenticated user
-
-        :param dict data: Input to update
-
-        ::
-
-            user_service.update(dict(name='new_name', bio='new_bio'))
-        """
-        request = self.make_request('users.update', body=data)
-        return self._patch(request)
diff --git a/pygithub3/services/users/__init__.py b/pygithub3/services/users/__init__.py
new file mode 100644
index 0000000..c448319
--- /dev/null
+++ b/pygithub3/services/users/__init__.py
@@ -0,0 +1,49 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+from ..base import Service
+from .keys import Keys
+from .emails import Emails
+from .followers import Followers
+
+
+class User(Service):
+    """ Consume `Users API <http://developer.github.com/v3/users>`_ """
+
+    def __init__(self, **config):
+        self.keys = Keys(**config)
+        self.emails = Emails(**config)
+        self.followers = Followers(**config)
+        super(User, self).__init__(**config)
+
+    def get(self, user=None):
+        """ Get a single user
+
+        :param str user: Username
+
+        If you call it without user and you are authenticated, get the
+        authenticated user.
+
+        .. warning::
+
+            If you aren't authenticated and call without user, it returns 403
+
+        ::
+
+            user_service.get('copitux')
+            user_service.get()
+        """
+        request = self.make_request('users.get', user=user)
+        return self._get(request)
+
+    def update(self, data):
+        """ Update the authenticated user
+
+        :param dict data: Input to update
+
+        ::
+
+            user_service.update(dict(name='new_name', bio='new_bio'))
+        """
+        request = self.make_request('users.update', body=data)
+        return self._patch(request)
diff --git a/pygithub3/services/users/emails.py b/pygithub3/services/users/emails.py
new file mode 100644
index 0000000..084a29c
--- /dev/null
+++ b/pygithub3/services/users/emails.py
@@ -0,0 +1,49 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+from . import Service
+
+
+class Emails(Service):
+    """ Consume `Emails API <http://developer.github.com/v3/users/emails/>`_
+
+    .. warning::
+
+        You must be authenticated for all requests
+    """
+
+    def list(self):
+        """ Get user's emails
+
+        :returns: A :doc:`result`
+        """
+        request = self.make_request('users.emails.list')
+        return self._get_result(request)
+
+    def add(self, *emails):
+        """ Add emails
+
+        :param list emails: Emails to add
+
+        .. note::
+
+            It rejects non-valid emails
+
+        ::
+
+            email_service.add('test1@xample.com', 'test2@xample.com')
+        """
+        request = self.make_request('users.emails.add', body=emails)
+        return self._post(request)
+
+    def delete(self, *emails):
+        """ Delete emails
+
+        :param list emails: List of emails
+
+        ::
+
+            email_service.delete('test1@xample.com', 'test2@xample.com')
+        """
+        request = self.make_request('users.emails.delete', body=emails)
+        self._delete(request)
diff --git a/pygithub3/services/users/followers.py b/pygithub3/services/users/followers.py
new file mode 100644
index 0000000..d6969e2
--- /dev/null
+++ b/pygithub3/services/users/followers.py
@@ -0,0 +1,84 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+from . import Service
+
+
+class Followers(Service):
+    """ Consume `Followers API
+    <http://developer.github.com/v3/users/followers/>`_
+    """
+
+    def list(self, user=None):
+        """ Get user's followers
+
+        :param str user: Username
+        :returns: A :doc:`result`
+
+        If you call it without user and you are authenticated, get the
+        authenticated user's followers
+
+        .. warning::
+
+            If you aren't authenticated and call without user, it returns 403
+
+        ::
+
+            followers_service.list()
+            followers_service.list('octocat')
+        """
+        request = self.make_request('users.followers.list', user=user)
+        return self._get_result(request)
+
+    def list_following(self, user=None):
+        """ Get who a user is following
+
+        :param str user: Username
+        :returns: A :doc:`result`
+
+        If you call it without user and you are authenticated, get the
+        authenticated user's followings
+
+        .. warning::
+
+            If you aren't authenticated and call without user, it returns 403
+
+        ::
+
+            followers_service.list_following()
+            followers_service.list_following('octocat')
+        """
+        request = self.make_request('users.followers.listfollowing', user=user)
+        return self._get_result(request)
+
+    def is_following(self, user):
+        """ Check if you are following a user
+
+        :param str user: Username
+        """
+        request = self.make_request('users.followers.isfollowing', user=user)
+        return self._bool(request)
+
+    def follow(self, user):
+        """ Follow a user
+
+        :param str user: Username
+
+        .. warning::
+
+            You must be authenticated
+        """
+        request = self.make_request('users.followers.follow', user=user)
+        self._put(request)
+
+    def unfollow(self, user):
+        """ Unfollow a user
+
+        :param str user: Username
+
+        .. warning::
+
+            You must be authenticated
+        """
+        request = self.make_request('users.followers.unfollow', user=user)
+        self._delete(request)
diff --git a/pygithub3/services/users/keys.py b/pygithub3/services/users/keys.py
new file mode 100644
index 0000000..996233c
--- /dev/null
+++ b/pygithub3/services/users/keys.py
@@ -0,0 +1,66 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+from . import Service
+
+
+class Keys(Service):
+    """ Consume `Keys API <http://developer.github.com/v3/users/keys/>`_
+
+    .. warning::
+
+        You must be authenticated for all requests
+    """
+
+    def list(self):
+        """ Get public keys
+
+        :returns: A :doc:`result`
+        """
+        request = self.make_request('users.keys.list')
+        return self._get_result(request)
+
+    def get(self, key_id):
+        """ Get a public key
+
+        :param int key_id: Key id
+        """
+        request = self.make_request('users.keys.get',
+            key_id=key_id)
+        return self._get(request)
+
+    def add(self, data):
+        """ Add a public key
+
+        :param dict data: Key (title and key attributes required)
+
+        ::
+
+            key_service.add(dict(title='host', key='ssh-rsa AAA...'))
+        """
+        request = self.make_request('users.keys.add',
+            body=data)
+        return self._post(request)
+
+    def update(self, key_id, data):
+        """ Update a public key
+
+        :param int key_id: Key id
+        :param dict data: Key (title and key attributes required)
+
+        ::
+
+            key_service.update(42, dict(title='host', key='ssh-rsa AAA...'))
+        """
+        request = self.make_request('users.keys.update',
+            key_id=key_id, body=data)
+        return self._patch(request)
+
+    def delete(self, key_id):
+        """ Delete a public key
+
+        :param int key_id: Key id
+        """
+        request = self.make_request('users.keys.delete',
+            key_id=key_id)
+        self._delete(request)