@@ -14,26 +14,27 @@ def generate(module, base_url=""):
1414
1515 for handler , methods in mapping .items ():
1616 doc = url_doc .setdefault ("," .join (methods ), OrderedDict ())
17- doc ['usage' ] = handler .api_function .__doc__
17+ usage = handler .api_function .__doc__
18+ if usage :
19+ doc ['usage' ] = usage
1820 if handler .example :
1921 doc ['example' ] = "{0}{1}" .format (base_url , url )
2022 if isinstance (handler .example , str ):
2123 doc ['example' ] += "?{0}" .format (handler .example )
22- inputs = doc .setdefault ('inputs' , OrderedDict ())
2324 doc ['outputs' ] = OrderedDict (format = handler .output_format .__doc__ )
2425
25- api = handler .api_function
26- types = api . __annotations__
27-
28- for argument in handler .accepted_parameters :
29- if argument in ('request' , 'response' ):
30- continue
31-
32- input_definition = inputs .setdefault (argument , OrderedDict ())
33- input_definition ['type' ] = types .get (argument , hug .types .text ).__doc__
34- default = handler .defaults .get (argument , None )
35- if default is not None :
36- input_definition ['default' ] = default
26+ if handler .accepted_parameters :
27+ inputs = doc . setdefault ( 'inputs' , OrderedDict ())
28+ types = handler . api_function . __annotations__
29+ for argument in handler .accepted_parameters :
30+ if argument in ('request' , 'response' ):
31+ continue
32+
33+ input_definition = inputs .setdefault (argument , OrderedDict ())
34+ input_definition ['type' ] = types .get (argument , hug .types .text ).__doc__
35+ default = handler .defaults .get (argument , None )
36+ if default is not None :
37+ input_definition ['default' ] = default
3738
3839 return documentation
3940
0 commit comments