Come posso specificare il tipo di funzione nei miei suggerimenti sul tipo?

Voglio usare i suggerimenti sul tipo nel mio attuale progetto Python 3.5. La mia funzione dovrebbe ricevere una funzione come parametro.

Come posso specificare la funzione del tipo nei miei suggerimenti sul tipo?

import typing

def my_function(name:typing.AnyStr, func: typing.Function) -> None:
    # However, typing.Function does not exist.
    # How can I specify the type function for the parameter `func`?

    # do some processing
    pass

Ho controllato PEP 483 , ma non sono riuscito a trovare un suggerimento sul tipo di funzione.

Come ha notato @jonrsharpe in un commento, questo può essere fatto con typing.Callable:

from typing import AnyStr, Callable

def my_function(name: AnyStr, func: Callable) -> None:

Il problema è Callableche da solo è tradotto in Callable[..., Any]che significa:

Un callable accetta un numero qualsiasi di argomenti / tipo e restituisce un valore di qualsiasi tipo. Nella maggior parte dei casi, questo non è ciò che desideri poiché consentirai il passaggio di praticamente qualsiasi funzione. Si desidera che vengano suggeriti anche i parametri della funzione e i tipi restituiti.

Ecco perché molti typesdi typingessere stato sovraccaricato di supporto sub-scripting che denota questi tipi di extra. Quindi, se, ad esempio, hai una funzione sumche richiede due se intrestituisce un int:

def sum(a: int, b: int) -> int: return a+b

La tua annotazione per esso sarebbe:

Callable[[int, int], int]

vale a dire, i parametri sono sotto script nella sottoscrizione esterna con il tipo restituito come secondo elemento nella sottoscrizione esterna. In generale:

Callable[[ParamType1, ParamType2, .., ParamTypeN], ReturnType]

Un altro punto interessante da notare è che puoi usare la funzione incorporata type()per ottenere il tipo di una funzione incorporata e usarla. Quindi potresti avere

def f(my_function: type(abs)) -> int:
    return my_function(100)

O qualcosa di quella forma