Formatage Sphinx d'une partie des docstrings

Modifs non commitées qui traînaient dans ma copie, histoire d'éviter les conflits...

lc_ldap.py

@@ -78,6 +78,7 @@ current_user = os.getenv("SUDO_USER") or os.getenv("USER")
 
 # Quand on a besoin du fichier de secrets
 def import_secrets():
+    """Importe le fichier de secrets"""
     if not "/etc/crans/secrets/" in sys.path:
         sys.path.append("/etc/crans/secrets/")
     import secrets
@@ -127,12 +128,12 @@ class lc_ldap(ldap.ldapobject.LDAPObject, object):
     """
     def __init__(self, dn=None, user=None, cred=None, uri=uri, test=False):
         """Initialise la connexion ldap,
-         - En authentifiant avec dn et cred s'ils sont précisés
-         - Si dn n'est pas précisé, mais que user est précisé, récupère
-           le dn associé à l'uid user, et effectue l'authentification
-           avec ce dn et cred
+         - En authentifiant avec ``dn`` et ``cred`` s'ils sont précisés
+         - Si ``dn`` n'est pas précisé, mais que ``user`` est précisé, récupère
+           le ``dn`` associé à l'uid ``user``, et effectue l'authentification
+           avec ce ``dn`` et ``cred``
          - Sinon effectue une authentification anonyme
-         Si test est à True, on se connecte à la base de test sur vo.
+         Si ``test`` est à ``True``, on se connecte à la base de test sur ``vo``.
         """
         if test:
             uri = "ldapi:///"
@@ -177,8 +178,9 @@ class lc_ldap(ldap.ldapobject.LDAPObject, object):
         self.simple_bind_s(who=secrets.ldap_readonly_auth_dn, cred=secrets.ldap_readonly_password)
 
     def search(self, filterstr='(objectClass=*)', mode='ro', dn= base_dn, scope=ldap.SCOPE_SUBTREE, sizelimit=1000):
-        """La fonction de recherche dans la base ldap qui renvoie un liste de
-        CransLdapObjects. On utilise la feature de sizelimit de python ldap"""
+        """La fonction de recherche dans la base LDAP qui renvoie un liste de
+        :py:class:`CransLdapObject`. On utilise la feature de ``sizelimit`` de
+        ``python-ldap``"""
         ldap_res = self.search_ext_s(dn, scope, filterstr, sizelimit=sizelimit)
         ret = []
         for dn, ldif in ldap_res:
@@ -228,7 +230,7 @@ class lc_ldap(ldap.ldapobject.LDAPObject, object):
         return adherents
 
     def newMachine(self, parent, realm, uldif):
-        """Crée une nouvelle machine: realm peut être:
+        """Crée une nouvelle machine: ``realm`` peut être:
         fil, fil-v6, wifi, wifi-v6, adm, gratuit, personnel-ens, special
         --Partiellement implémenté"""
         #adm, serveurs, bornes, wifi, adherents, gratuit ou personnel-ens"""
@@ -299,7 +301,7 @@ class lc_ldap(ldap.ldapobject.LDAPObject, object):
         raise NotImplementedError()
 
     def _create_entity(self, dn, uldif):
-        '''Crée une nouvelle entité ldap en dn, avec attributs ldif:
+        '''Crée une nouvelle entité ldap en ``dn``, avec attributs ``ldif``:
         uniquement en unicode'''
         # Conversion en cldif pour vérification des valeurs
         cldif = ldif_to_cldif(uldif, self)
@@ -410,8 +412,8 @@ class lc_ldap_local(lc_ldap):
 
 
 def new_cransldapobject(conn, dn, mode='ro', ldif = None):
-    """Crée un objet CransLdap en utilisant la classe correspondant à
-    l'objectClass du ldif
+    """Crée un objet :py:class:`CransLdap` en utilisant la classe correspondant à
+    l'``objectClass`` du ``ldif``
     --pour usage interne à la libraire uniquement !"""
 
     classe = None
@@ -430,7 +432,7 @@ def new_cransldapobject(conn, dn, mode='ro', ldif = None):
     return classe(conn, dn, mode, ldif)
 
 class CransLdapObject(object):
-    """Classe de base des objets CransLdap.
+    """Classe de base des objets :py:class:`CransLdap`.
     Cette classe ne devrait pas être utilisée directement."""
 
     """ Qui peut faire quoi ? """
@@ -444,7 +446,7 @@ class CransLdapObject(object):
     def __init__(self, conn, dn, mode='ro', ldif = None):
         '''
         Créée une instance d'un objet Crans (machine, adhérent,
-        etc...) à ce dn, si ldif est précisé, n'effectue pas de
+        etc...) à ce ``dn``, si ``ldif`` est précisé, n'effectue pas de
         recherche dans la base ldap.
         '''
 
@@ -532,7 +534,7 @@ class CransLdapObject(object):
 
     def save(self):
         """Sauvegarde dans la base les modifications apportées à l'objet.
-        Interne: Vérifie que self._modifs contient des valeurs correctes et
+        Interne: Vérifie que ``self._modifs`` contient des valeurs correctes et
         enregistre les modifications."""
         if self.mode not in ['w', 'rw']:
             raise EnvironmentError("Objet en lecture seule, réessayer en lecture/écriture")