Wyjaśnij punkty wejścia Pythona?

EntryPoints zapewniają trwałą, opartą na systemie plików rejestrację nazwy obiektu oraz mechanizm bezpośredniego importu obiektu (zaimplementowany przez pakiet setuptools ).

Kojarzą nazwy obiektów Pythona z wolnymi identyfikatorami. Tak więc każdy inny kod korzystający z tej samej instalacji Pythona i znający identyfikator może uzyskać dostęp do obiektu o powiązanej nazwie, bez względu na to, gdzie obiekt jest zdefiniowany. nazwy powiązane mogą być dowolnymi nazwami istniejącymi w Moduł Pythona ; na przykład nazwa klasy, funkcji lub zmiennej. Mechanizm punktu wejścia nie dba o to, do czego odnosi się nazwa, o ile można ją importować.

Jako przykład, użyjmy (nazwy) funkcji i wyimaginowanego modułu Pythona O w pełni kwalifikowanej nazwie ' myns.mypkg.mymodule": {]}

def the_function():
   "function whose name is 'the_function', in 'mymodule' module"
   print "hello from the_function"

Punkty wejścia są rejestrowane za pomocą deklaracji punktów wejścia w setup.py. to register the_function under entrypoint called 'my_ep_func':

    entry_points = {
        'my_ep_group_id': [
            'my_ep_func = myns.mypkg.mymodule:the_function'
        ]
    },

Jako przykład pokazuje, punkty wejścia są pogrupowane; istnieje odpowiednie API, które wyszukuje wszystkie punkty wejścia należące do grupy (przykład poniżej).

Po instalacji pakietu (tj. running "python setup.py install'), powyższa deklaracja jest przetwarzana przez setuptools. Następnie zapisuje przetwarzane informacje w specjalnym pliku. Następnie API pkg_resources (część setuptools) może być użyte do wyszukania punktu wejścia i uzyskania dostępu do obiektów o powiązanych nazwach:

import pkg_resources

named_objects = {}
for ep in pkg_resources.iter_entry_points(group='my_ep_group_id'):
   named_objects.update({ep.name: ep.load()})

Tutaj, setuptools odczytuje informacje o punkcie wejścia, które zostały zapisane w specjalnych plikach. Znalazł punkt wejścia, zaimportował moduł (myns.mypkg.mymodule) i pobrał zdefiniowaną tam funkcję, po wywołaniu pkg_resources.load().

Zakładając, że nie było innych rejestracji punktu wejścia dla tego samego identyfikatora grupy, wywołanie funkcji byłoby proste:

>>> named_objects['my_ep_func']()
hello from the_function

W związku z tym, choć być może jest to trochę trudne do uchwycenia na początku, mechanizm punktu wejścia jest w rzeczywistości dość prosty w użyciu. Informatyka zapewnia przydatne narzędzie do tworzenia oprogramowania Python pluggable.

Z abstrakcyjnego punktu widzenia, punkty wejścia są używane do tworzenia systemowego rejestru wywołań Pythona, które implementują określone interfejsy. W pkg_resources znajdują się API, które sprawdzają, które punkty wejścia są reklamowane przez dany pakiet, a także API, które określają, które pakiety reklamują dany punkt wejścia.

Punkty wejściowe są przydatne do umożliwienia jednemu pakietowi korzystania z wtyczek znajdujących się w innym pakiecie. Na przykład projekt Iana Bickinga Wklej wykorzystuje punkty wejścia / align = "left" / W takim przypadku można napisać pakiet, który reklamuje swoją fabrykę aplikacji WSGI używając punktu wejścia paste.app_factory.

Innym zastosowaniem dla punktów wejścia jest wyliczanie wszystkich pakietów w systemie, które zapewniają pewną funkcjonalność wtyczek. TurboGears web framework wykorzystuje python.templating.engines punkt wejścia do wyszukiwania bibliotek szablonów, które są zainstalowane i dostępne.