Méthodes d'instance et méthodes statiques dans les classes python

Question

Donc, dans le paquet docutils de python, il y a une classe (Image) qui a une méthode (align). Comme je l'ai compris, les méthodes prennent self comme premier argument à moins qu'elles ne soient décorées comme @classmethod ou @staticmethod, mais align ne le fait pas. Le code correspondant est copié ci-dessous (full code here).

class Image(Directive): 

    def align(argument): 
     # This is not callable as self.align. We cannot make it a 
     # staticmethod because we're saving an unbound method in 
     # option_spec below. 
     return directives.choice(argument, Image.align_values) 

J'utilise ce code comme base pour mes propres fins, et je l'ai essayé à la fois de donner aligner un argument en soi et en le transformant en une méthode statique (après avoir changé le nom afin de ne pas entrer en conflit avec l'auto .align), mais a eu des erreurs avec l'une ou l'autre approche. Que se passe-t-il?

Answer 1

Il n'est pas nécessaire de nommer le premier argument self; c'est juste une convention. Dans le code suivant

i = Image() 
i.align() 

la méthode align sera appelée avec le paramètre argument faisant référence à l'objet i.

La fonction suivante se comporter de manière identique:

def align(self): 
    return directives.choice(self, Image.align_values) 

(remplaçant simplement argument avec le self plus commun).

---

Dans ce contexte, la fonction align n'a jamais été destiné à être une méthode; l'auteur semble simplement définir une fonction à stocker dans le dictionnaire options_spec. L'effet recherché aurait pu être atteint sans polluer l'espace de la classe en supprimant le nom après la référence de fonction a été enregistrée:

option_spec = {'alt': directives.unchanged, 
       'height': directives.length_or_unitless, 
       'width': directives.length_or_percentage_or_unitless, 
       'scale': directives.percentage, 
       'align': align, 
       'name': directives.unchanged, 
       'target': directives.unchanged_required, 
       'class': directives.class_option} 
del align 

ou en renonçant à la déclaration def — c'est une fonction très simple — et en utilisant une expression lambda pour créer la fonction.

option_spec = {'alt': directives.unchanged, 
       'height': directives.length_or_unitless, 
       'width': directives.length_or_percentage_or_unitless, 
       'scale': directives.percentage, 
       'align': lambda x: directives.choice(x, Image.align_values) 
       'name': directives.unchanged, 
       'target': directives.unchanged_required, 
       'class': directives.class_option}