Al momento sto documentando molto del mio codice (Python) e mi chiedevo se esiste un plugin per Eclipse che può generare automaticamente una stringa doc per le mie funzioni, come Visual Studio lo fa per C# quando si scrive ///
su un metodo.Autogenerazione della documentazione fittizia nel codice sorgente per Python in eclissi
Ho cercato una soluzione, ma non ho avuto fortuna: qualcuno di voi conosce una soluzione?
Esempio:
Dalla mia lista di parametri su un metodo di documentazione "fittizio" verrà creato sotto la mia definizione di un metodo come illustrato di seguito:
def myFunction(self, a, b):
"""
:param a:
:type a:
:param b:
:type b:
:return:
:rtype:
"""
return 'Hello, world'
penso che questo è contro, in generale, lo spirito di pitone. I parametri dovrebbero essere auto-documentanti tramite il loro nome possibilmente dettagliato. Python usa l'inferenza del tipo, quindi, un test unitario dovrebbe fallire se il tipo di argomento non corrisponde al tipo di parametro desiderato. Una documentazione su una riga dovrebbe essere sufficiente. –
In molti modi sono d'accordo con te, tuttavia, non faccio quello che fa il mio utente finale. Non ha accesso ai test delle unità, e credo che un bel codice documentato che elabora un po 'più dei nomi dei miei parametri gli renda la vita più facile e possa iniziare a lavorare con la mia API un po' più velocemente. (e con meno costi) – aweis
Vedo il tuo punto, ma vorrei omettere le informazioni sul tipo. –