2.33. Introspecție#

Câteva funcții încorporate permit unui program în execuție să se inspecteze pe sine – valorile cu care lucrează, spațiile de nume în care trăiesc acele valori și relațiile dintre clase. Apelează la ele când trebuie să iei decizii pe baza a ceea ce un obiect este de fapt, mai degrabă decât a ceea ce pretinde apelantul său.

2.33.1. Identitate și hashing#

  • id() – un întreg unic care identifică un obiect atât timp cât acesta este activ. Două nume care leagă același obiect întorc același id; două obiecte egale, dar distincte, nu.

>>> a = [1, 2, 3]
>>> b = a
>>> c = [1, 2, 3]
>>> id(a) == id(b)        # same list
True
>>> id(a) == id(c)        # equal but distinct
False

Id-ul nu este portabil între rulări și nu are sens dincolo de „același obiect sau un obiect diferit.”

  • hash() – valoarea hash a unui obiect, același număr pe care dict și set îl folosesc pentru a-l căuta. Două obiecte egale au aceeași valoare hash; doar tipurile hashabile (valori imutabile, în general) funcționează în general.

>>> hash("abc")           # some integer, build-dependent
-1600925533
>>> hash([1, 2])
TypeError: unhashable type: 'list'

2.33.2. Interogarea tipurilor și a posibilității de apelare#

  • type() – clasa exactă a unei valori. type(x) is int întreabă „este x exact un int” (fără subclase); isinstance() este de obicei ceea ce vrei în schimb.

  • isinstance() – „este x o instanță a acestei clase sau a unei subclase a ei?” Instrumentul standard pentru distribuirea bazată pe tip în interiorul funcțiilor.

  • issubclass() – echivalentul la nivel de clasă. Primește două clase în loc de o instanță.

  • callable() – True dacă argumentul poate fi apelat cu (). Util când primești un argument care poate fi o funcție sau poate fi o valoare simplă.

>>> isinstance(3, int)
True
>>> isinstance(True, int)        # bool is a subclass of int
True
>>> issubclass(bool, int)
True
>>> callable(len)
True
>>> callable(10)
False

Un model care folosește callable:

def call_or_return(x):
    return x() if callable(x) else x

2.33.3. Examinarea domeniilor#

  • globals() – spațiul de nume global al modulului ca dict. Citirea din el funcționează; scrierea în el este reală, dar a face acest lucru în afara explorării REPL face un program greu de urmărit.

  • locals() – spațiul de nume local de la locul apelului. În interiorul unei funcții reflectă variabilele locale; modificarea dicționarului întors nu garantează scrierea înapoi în variabilele locale reale (comportament definit de implementare).

name = "OpenMV"

def f():
    x = 10
    print(globals()["name"])    # OpenMV
    print(locals())             # {'x': 10}

Acestea două sunt utile pentru depanare și pentru instrumente care trebuie să descopere ce este definit. Apelează la ele cu moderație în codul obișnuit – o funcție care modifică globals() este unul dintre cele mai greu de înțeles lucruri din Python.

2.33.4. Vezi și#

dir() și help(), tratate în debugging, sunt instrumentele de introspecție de zi cu zi pentru explorarea suprafeței unui obiect necunoscut.