Get auth docs building (#194)

* Get auth docs building

For some reason, the docstrings for the auth classes aren't
being built into the docs.  Add a link from the main page to
get things generated.

docs/auth/index.rst

@@ -0,0 +1,16 @@
+******************
+Auth (`pyvo.auth`)
+******************
+This module contains submodules which help handle auth when
+communicating with virtual observatory services.
+
+Reference/API
+=============
+
+.. automodapi:: pyvo.auth
+
+.. automodapi:: pyvo.auth.authsession
+
+.. automodapi:: pyvo.auth.authurls
+
+.. automodapi:: pyvo.auth.credentialstore

docs/index.rst

@@ -121,3 +121,4 @@ Using `pyvo`
    dal/index
    registry/index
    io/index
+   auth/index

pyvo/auth/__init__.py

@@ -1 +1,7 @@
 # Licensed under a 3-clause BSD style license - see LICENSE.rst
+
+__all__ = ["AuthSession", "AuthURLs", "CredentialStore"]
+
+from .authsession import AuthSession
+from .authurls import AuthURLs
+from .credentialstore import CredentialStore

pyvo/auth/authsession.py

@@ -3,6 +3,8 @@
 from .authurls import AuthURLs
 from .credentialstore import CredentialStore
 
+__all__ = ["AuthSession"]
+
 
 class AuthSession:
     """

pyvo/auth/authurls.py

@@ -3,6 +3,8 @@
 
 from . import securitymethods
 
+__all__ = ["AuthURLs"]
+
 
 class AuthURLs():
     """

pyvo/auth/credentialstore.py

@@ -4,6 +4,8 @@
 
 from . import securitymethods
 
+__all__ = ["CredentialStore"]
+
 
 class CredentialStore(object):
     """