From 64ff4ab0cbdbd6d53308a6984ede7da3fe88ee4c Mon Sep 17 00:00:00 2001 From: Warren Usui Date: Fri, 14 Feb 2014 17:28:38 -0800 Subject: [PATCH] Fixed task/args.py docstrings. --- teuthology/task/args.py | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/teuthology/task/args.py b/teuthology/task/args.py index d1f7b97733..17e9e9dc00 100644 --- a/teuthology/task/args.py +++ b/teuthology/task/args.py @@ -1,4 +1,10 @@ +""" +These routines only appear to be used by the peering_speed tests. +""" def gen_args(name, args): + """ + Called from argify to generate arguments. + """ usage = [""] usage += [name + ':'] usage += \ @@ -13,7 +19,14 @@ def gen_args(name, args): for (key, _, default, _) in args] usage = '\n'.join(' ' + i for i in usage) def ret(config): - class Object(object): pass + """ + return an object with attributes set from args. + """ + class Object(object): + """ + simple object + """ + pass obj = Object() for (key, usage, default, conv) in args: if key in config: @@ -24,9 +37,19 @@ def gen_args(name, args): return usage, ret def argify(name, args): + """ + Object used as a decorator for the peering speed tests. + See peering_spee_test.py + """ (usage, config_func) = gen_args(name, args) def ret1(f): + """ + Wrapper to handle doc and usage information + """ def ret2(**kwargs): + """ + Call f (the parameter passed to ret1) + """ config = kwargs.get('config', {}) if config is None: config = {} -- 2.39.5