Diciamo che ho la seguente funzione con una docstring:
def foo(*args):
"""
do some fooness
+----------------------------+----------------------------------------------------+
| kind | ndb property |
+============================+====================================================+
| :func:'unicode' | :class:'google.appengine.ext.ndb.StringProperty' |
+----------------------------+----------------------------------------------------+
| :class:'datetime.datetime' | :class:'google.appengine.ext.ndb.DateTimeProperty' |
+----------------------------+----------------------------------------------------+
Args:
args: some arguments
"""
Le righe della tabella sono troppo lunghe. Quindi flake8 si lamenta di questo.
Per risolvere questo problema, ho trovato il seguente:
def foo(*args):
("""
do some fooness
"""
'\n +----------------------------+----------------------------------------------------+' # noqa
'\n | kind | ndb property |' # noqa
'\n +============================+====================================================+' # noqa
'\n | :func:'unicode' | :class:'google.appengine.ext.ndb.StringProperty' |' # noqa
'\n +----------------------------+----------------------------------------------------+' # noqa
'\n | :class:'datetime.datetime' | :class:'google.appengine.ext.ndb.DateTimeProperty' |' # noqa
'\n +----------------------------+----------------------------------------------------+' # noqa
"""
Args:
args: some arguments
""")
Funziona, ma penso che sia davvero brutto. C'è una soluzione meno brutta a questo problema?