Quelle est la différence entre les deux .un() et .(première)

Query.one() exige qu'il y a seulement un résultat dans le jeu de résultats; c'est une erreur si la base de données renvoie 0 ou 2 ou plus de résultats et une exception sera levée.

Query.first() renvoie le premier d'une potentiellement plus vaste ensemble de résultats (en ajoutant LIMIT 1 la requête), ou None si il n'y avait pas de résultats. Aucune exception n'est levée.

À partir de la documentation pour de la Requête.un():

Retourner exactement un résultat ou lever une exception.

et de de la Requête.first():

Retour le premier résultat de cette Requête ou Aucun si le résultat ne contient pas de n'importe quelle ligne.

(l'emphase est mienne).

En termes d'une liste Python, one() serait:

def one(lst):
    if not lst:
        raise NoResultFound
    if len(lst) > 1:
        raise MultipleResultsFound
    return lst[0]

tout first() serait:

def first(lst):
    return lst[0] if lst else None

Il y a aussi un de la Requête.one_or_none() méthode, ce qui soulève une exception uniquement si il y a plusieurs résultats de la requête. Sinon ça va retourner le résultat unique, ou None si il n'y avait pas de résultats.

Dans la liste de termes, qui serait l'équivalent de:

def one_or_none(lst):
    if not lst:
        return None
    if len(lst) > 1:
        raise MultipleResultsFound
    return lst[0]