1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
|
# this module should be kept Python 2.3 compatible
import re, sys, inspect, argparse
if sys.version >= '3':
from inspect import getfullargspec
else:
class getfullargspec(object):
"A quick and dirty replacement for getfullargspec for Python 2.X"
def __init__(self, f):
self.args, self.varargs, self.varkw, self.defaults = \
inspect.getargspec(f)
self.annotations = getattr(f, '__annotations__', {})
try:
set
except NameError: # Python 2.3
from sets import Set as set
def annotations(**ann):
"""
Returns a decorator annotating a function with the given annotations.
This is a trick to support function annotations in Python 2.X.
"""
def annotate(f):
fas = getfullargspec(f)
args = fas.args
if fas.varargs:
args.append(fas.varargs)
if fas.varkw:
args.append(fas.varkw)
for argname in ann:
if argname not in args:
raise NameError(
'Annotating non-existing argument: %s' % argname)
f.__annotations__ = ann
return f
return annotate
def is_annotation(obj):
"""
An object is an annotation object if it has the attributes
help, kind, abbrev, type, choices, metavar.
"""
return (hasattr(obj, 'help') and hasattr(obj, 'kind') and
hasattr(obj, 'abbrev') and hasattr(obj, 'type')
and hasattr(obj, 'choices') and hasattr(obj, 'metavar'))
class Annotation(object):
def __init__(self, help="", kind="positional", abbrev=None, type=None,
choices=None, metavar=None):
assert kind in ('positional', 'option', 'flag'), kind
if kind == "positional":
assert abbrev is None, abbrev
self.help = help
self.kind = kind
self.abbrev = abbrev
self.type = type
self.choices = choices
self.metavar = metavar
def from_(cls, obj):
"Helper to convert an object into an annotation, if needed"
if is_annotation(obj):
return obj # do nothing
elif hasattr(obj, '__iter__') and not isinstance(obj, str):
return cls(*obj)
return cls(obj)
from_ = classmethod(from_)
NONE = object() # sentinel use to signal the absence of a default
PARSER_CFG = getfullargspec(argparse.ArgumentParser.__init__).args[1:]
# the default arguments accepted by an ArgumentParser object
def pconf(obj):
"Extracts the configuration of the underlying ArgumentParser from obj"
cfg = dict(description=obj.__doc__)
for name in dir(obj):
if name in PARSER_CFG: # argument of ArgumentParser
cfg[name] = getattr(obj, name)
return cfg
def _parser_from(func, baseparser=None):
"""
Extract the arguments from the attributes of the passed function
(or bound method) and return an ArgumentParser instance. As a side
effect, adds a .p attribute to func.
"""
p = baseparser or argparse.ArgumentParser(**pconf(func))
p.func = func
p.argspec = f = getfullargspec(func)
p.parselist = _parser_call.__get__(p)
if inspect.ismethod(func):
del f.args[0] # remove self
try:
func.im_func.p = p # Python 2.X
except AttributeError:
func.__func__.p = p # Python 2.3
else:
func.p = p
defaults = f.defaults or ()
n_args = len(f.args)
n_defaults = len(defaults)
alldefaults = (NONE,) * (n_args - n_defaults) + defaults
prefix = p.prefix = getattr(func, 'prefix_chars', '-')[0]
for name, default in zip(f.args, alldefaults):
ann = f.annotations.get(name, ())
a = Annotation.from_(ann)
metavar = a.metavar
if default is NONE:
dflt = None
else:
dflt = default
if a.kind in ('option', 'flag'):
if a.abbrev:
shortlong = (prefix + a.abbrev, prefix*2 + name)
else:
shortlong = (prefix + name,)
elif default is NONE: # required argument
p.add_argument(name, help=a.help, type=a.type, choices=a.choices,
metavar=metavar)
else: # default argument
p.add_argument(name, nargs='?', help=a.help, default=dflt,
type=a.type, choices=a.choices, metavar=metavar)
if a.kind == 'option':
if default is not NONE:
metavar = metavar or str(default)
p.add_argument(help=a.help, default=dflt, type=a.type,
choices=a.choices, metavar=metavar, *shortlong)
elif a.kind == 'flag':
if default is not NONE and default is not False:
raise TypeError('Flag %r wants default False, got %r' %
(name, default))
p.add_argument(action='store_true', help=a.help, *shortlong)
if f.varargs:
a = Annotation.from_(f.annotations.get(f.varargs, ()))
p.add_argument(f.varargs, nargs='*', help=a.help, default=[],
type=a.type, metavar=a.metavar)
if f.varkw:
a = Annotation.from_(f.annotations.get(f.varkw, ()))
p.add_argument(f.varkw, nargs='*', help=a.help, default={},
type=a.type, metavar=a.metavar)
return p
def parser_from(obj, baseparser=None):
"""
obj can be a function, a bound method, or a generic object with a
.commands attribute. Returns an ArgumentParser with attributes
.func and .argspec, or a multi-parser with attribute .sub.
"""
if hasattr(obj, 'p'): # the underlying parser has been generated already
return obj.p
elif hasattr(obj, 'commands'): # a command container
p = obj.p = baseparser or argparse.ArgumentParser(**pconf(obj))
subparsers = p.add_subparsers(
title='subcommands', help='-h to get additional help')
p.subp = {}
for cmd in obj.commands:
method = getattr(obj, cmd)
baseparser = subparsers.add_parser(cmd, **pconf(method))
p.subp[cmd] = _parser_from(method, baseparser)
p.parselist = _parser_call.__get__(p)
return p
elif inspect.isfunction(obj) or inspect.ismethod(obj): # error if not func
return _parser_from(obj, baseparser)
else:
raise TypeError('%r could not be converted into a parser' % obj)
def _extract_kwargs(args):
"Returns two lists: regular args and name=value args"
arglist = []
kwargs = {}
for arg in args:
match = re.match(r'([a-zA-Z_]\w*)=', arg)
if match:
name = match.group(1)
kwargs[name] = arg[len(name)+1:]
else:
arglist.append(arg)
return arglist, kwargs
def _parser_call(p, arglist):
"""
Given a parser, calls its underlying callable with the arglist.
Works also for multiparsers by dispatching to the underlying parser.
"""
subp = getattr(p, 'subp', None)
if subp: # subparsers
p.parse_args(arglist) # argument checking
return _parser_call(subp[arglist[0]], arglist[1:])
# regular parser
if p.argspec.varkw:
arglist, kwargs = _extract_kwargs(arglist)
else:
kwargs = {}
argdict = vars(p.parse_args(arglist))
args = [argdict[a] for a in p.argspec.args]
varargs = argdict.get(p.argspec.varargs, [])
collision = set(p.argspec.args) & set(kwargs)
if collision:
p.error('colliding keyword arguments: %s' % ' '.join(collision))
result = p.func(*(args + varargs), **kwargs)
if result is None:
return []
elif hasattr(result, '__iter__') and not isinstance(result, str):
return [str(x) for x in result]
else:
return [str(result)]
def call(obj, arglist=sys.argv[1:]):
"""
If obj is a function or a bound method, parses the given arglist
by using an argument parser inferred from the annotations of obj
and then calls obj with the parsed arguments.
If obj is an object with attribute .commands, builds a multiparser
and dispatches to the associated subparsers.
Return a list of strings.
"""
return parser_from(obj).parselist(arglist)
|