This file is indexed.

/usr/lib/python2.7/dist-packages/funcsigs-1.0.2.egg-info/PKG-INFO is in python-funcsigs 1.0.2-3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
Metadata-Version: 1.1
Name: funcsigs
Version: 1.0.2
Summary: Python function signatures from PEP362 for Python 2.6, 2.7 and 3.2+
Home-page: http://funcsigs.readthedocs.org
Author: Testing Cabal
Author-email: testing-in-python@lists.idyll.org
License: ASL
Description: .. funcsigs documentation master file, created by
           sphinx-quickstart on Fri Apr 20 20:27:52 2012.
           You can adapt this file completely to your liking, but it should at least
           contain the root `toctree` directive.
        
        Introducing funcsigs
        ====================
        
        The Funcsigs Package
        --------------------
        
        ``funcsigs`` is a backport of the `PEP 362`_ function signature features from
        Python 3.3's `inspect`_ module. The backport is compatible with Python 2.6, 2.7
        as well as 3.3 and up. 3.2 was supported by version 0.4, but with setuptools and
        pip no longer supporting 3.2, we cannot make any statement about 3.2
        compatibility.
        
        Compatibility
        `````````````
        
        The ``funcsigs`` backport has been tested against:
        
        * CPython 2.6
        * CPython 2.7
        * CPython 3.3
        * CPython 3.4
        * CPython 3.5
        * CPython nightlies
        * PyPy and PyPy3(currently failing CI)
        
        Continuous integration testing is provided by `Travis CI`_.
        
        Under Python 2.x there is a compatibility issue when a function is assigned to
        the ``__wrapped__`` property of a class after it has been constructed.
        Similiarily there under PyPy directly passing the ``__call__`` method of a
        builtin is also a compatibility issues.  Otherwise the functionality is
        believed to be uniform between both Python2 and Python3.
        
        Issues
        ``````
        
        Source code for ``funcsigs`` is hosted on `GitHub`_. Any bug reports or feature
        requests can be made using GitHub's `issues system`_. |build_status| |coverage|
        
        Example
        -------
        
        To obtain a `Signature` object, pass the target function to the
        ``funcsigs.signature`` function.
        
        .. code-block:: python
        
            >>> from funcsigs import signature
            >>> def foo(a, b=None, *args, **kwargs):
            ...     pass
            ...
            >>> sig = signature(foo)
            >>> sig
            <funcsigs.Signature object at 0x...>
            >>> sig.parameters
            OrderedDict([('a', <Parameter at 0x... 'a'>), ('b', <Parameter at 0x... 'b'>), ('args', <Parameter at 0x... 'args'>), ('kwargs', <Parameter at 0x... 'kwargs'>)])
            >>> sig.return_annotation
            <class 'funcsigs._empty'>
        
        Introspecting callables with the Signature object
        -------------------------------------------------
        
        .. note::
        
           This section of documentation is a direct reproduction of the Python
           standard library documentation for the inspect module.
        
        The Signature object represents the call signature of a callable object and its
        return annotation.  To retrieve a Signature object, use the :func:`signature`
        function.
        
        .. function:: signature(callable)
        
           Return a :class:`Signature` object for the given ``callable``::
        
              >>> from funcsigs import signature
              >>> def foo(a, *, b:int, **kwargs):
              ...     pass
        
              >>> sig = signature(foo)
        
              >>> str(sig)
              '(a, *, b:int, **kwargs)'
        
              >>> str(sig.parameters['b'])
              'b:int'
        
              >>> sig.parameters['b'].annotation
              <class 'int'>
        
           Accepts a wide range of python callables, from plain functions and classes to
           :func:`functools.partial` objects.
        
           .. note::
        
              Some callables may not be introspectable in certain implementations of
              Python.  For example, in CPython, built-in functions defined in C provide
              no metadata about their arguments.
        
        
        .. class:: Signature
        
           A Signature object represents the call signature of a function and its return
           annotation.  For each parameter accepted by the function it stores a
           :class:`Parameter` object in its :attr:`parameters` collection.
        
           Signature objects are *immutable*.  Use :meth:`Signature.replace` to make a
           modified copy.
        
           .. attribute:: Signature.empty
        
              A special class-level marker to specify absence of a return annotation.
        
           .. attribute:: Signature.parameters
        
              An ordered mapping of parameters' names to the corresponding
              :class:`Parameter` objects.
        
           .. attribute:: Signature.return_annotation
        
              The "return" annotation for the callable.  If the callable has no "return"
              annotation, this attribute is set to :attr:`Signature.empty`.
        
           .. method:: Signature.bind(*args, **kwargs)
        
              Create a mapping from positional and keyword arguments to parameters.
              Returns :class:`BoundArguments` if ``*args`` and ``**kwargs`` match the
              signature, or raises a :exc:`TypeError`.
        
           .. method:: Signature.bind_partial(*args, **kwargs)
        
              Works the same way as :meth:`Signature.bind`, but allows the omission of
              some required arguments (mimics :func:`functools.partial` behavior.)
              Returns :class:`BoundArguments`, or raises a :exc:`TypeError` if the
              passed arguments do not match the signature.
        
           .. method:: Signature.replace(*[, parameters][, return_annotation])
        
              Create a new Signature instance based on the instance replace was invoked
              on.  It is possible to pass different ``parameters`` and/or
              ``return_annotation`` to override the corresponding properties of the base
              signature.  To remove return_annotation from the copied Signature, pass in
              :attr:`Signature.empty`.
        
              ::
        
                 >>> def test(a, b):
                 ...     pass
                 >>> sig = signature(test)
                 >>> new_sig = sig.replace(return_annotation="new return anno")
                 >>> str(new_sig)
                 "(a, b) -> 'new return anno'"
        
        
        .. class:: Parameter
        
           Parameter objects are *immutable*.  Instead of modifying a Parameter object,
           you can use :meth:`Parameter.replace` to create a modified copy.
        
           .. attribute:: Parameter.empty
        
              A special class-level marker to specify absence of default values and
              annotations.
        
           .. attribute:: Parameter.name
        
              The name of the parameter as a string.  Must be a valid python identifier
              name (with the exception of ``POSITIONAL_ONLY`` parameters, which can have
              it set to ``None``).
        
           .. attribute:: Parameter.default
        
              The default value for the parameter.  If the parameter has no default
              value, this attribute is set to :attr:`Parameter.empty`.
        
           .. attribute:: Parameter.annotation
        
              The annotation for the parameter.  If the parameter has no annotation,
              this attribute is set to :attr:`Parameter.empty`.
        
           .. attribute:: Parameter.kind
        
              Describes how argument values are bound to the parameter.  Possible values
              (accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):
        
              +------------------------+----------------------------------------------+
              |    Name                | Meaning                                      |
              +========================+==============================================+
              | *POSITIONAL_ONLY*      | Value must be supplied as a positional       |
              |                        | argument.                                    |
              |                        |                                              |
              |                        | Python has no explicit syntax for defining   |
              |                        | positional-only parameters, but many built-in|
              |                        | and extension module functions (especially   |
              |                        | those that accept only one or two parameters)|
              |                        | accept them.                                 |
              +------------------------+----------------------------------------------+
              | *POSITIONAL_OR_KEYWORD*| Value may be supplied as either a keyword or |
              |                        | positional argument (this is the standard    |
              |                        | binding behaviour for functions implemented  |
              |                        | in Python.)                                  |
              +------------------------+----------------------------------------------+
              | *VAR_POSITIONAL*       | A tuple of positional arguments that aren't  |
              |                        | bound to any other parameter. This           |
              |                        | corresponds to a ``*args`` parameter in a    |
              |                        | Python function definition.                  |
              +------------------------+----------------------------------------------+
              | *KEYWORD_ONLY*         | Value must be supplied as a keyword argument.|
              |                        | Keyword only parameters are those which      |
              |                        | appear after a ``*`` or ``*args`` entry in a |
              |                        | Python function definition.                  |
              +------------------------+----------------------------------------------+
              | *VAR_KEYWORD*          | A dict of keyword arguments that aren't bound|
              |                        | to any other parameter. This corresponds to a|
              |                        | ``**kwargs`` parameter in a Python function  |
              |                        | definition.                                  |
              +------------------------+----------------------------------------------+
        
              Example: print all keyword-only arguments without default values::
        
                 >>> def foo(a, b, *, c, d=10):
                 ...     pass
        
                 >>> sig = signature(foo)
                 >>> for param in sig.parameters.values():
                 ...     if (param.kind == param.KEYWORD_ONLY and
                 ...                        param.default is param.empty):
                 ...         print('Parameter:', param)
                 Parameter: c
        
           .. method:: Parameter.replace(*[, name][, kind][, default][, annotation])
        
              Create a new Parameter instance based on the instance replaced was invoked
              on.  To override a :class:`Parameter` attribute, pass the corresponding
              argument.  To remove a default value or/and an annotation from a
              Parameter, pass :attr:`Parameter.empty`.
        
              ::
        
                 >>> from funcsigs import Parameter
                 >>> param = Parameter('foo', Parameter.KEYWORD_ONLY, default=42)
                 >>> str(param)
                 'foo=42'
        
                 >>> str(param.replace()) # Will create a shallow copy of 'param'
                 'foo=42'
        
                 >>> str(param.replace(default=Parameter.empty, annotation='spam'))
                 "foo:'spam'"
        
        
        .. class:: BoundArguments
        
           Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call.
           Holds the mapping of arguments to the function's parameters.
        
           .. attribute:: BoundArguments.arguments
        
              An ordered, mutable mapping (:class:`collections.OrderedDict`) of
              parameters' names to arguments' values.  Contains only explicitly bound
              arguments.  Changes in :attr:`arguments` will reflect in :attr:`args` and
              :attr:`kwargs`.
        
              Should be used in conjunction with :attr:`Signature.parameters` for any
              argument processing purposes.
        
              .. note::
        
                 Arguments for which :meth:`Signature.bind` or
                 :meth:`Signature.bind_partial` relied on a default value are skipped.
                 However, if needed, it is easy to include them.
        
              ::
        
                >>> def foo(a, b=10):
                ...     pass
        
                >>> sig = signature(foo)
                >>> ba = sig.bind(5)
        
                >>> ba.args, ba.kwargs
                ((5,), {})
        
                >>> for param in sig.parameters.values():
                ...     if param.name not in ba.arguments:
                ...         ba.arguments[param.name] = param.default
        
                >>> ba.args, ba.kwargs
                ((5, 10), {})
        
        
           .. attribute:: BoundArguments.args
        
              A tuple of positional arguments values.  Dynamically computed from the
              :attr:`arguments` attribute.
        
           .. attribute:: BoundArguments.kwargs
        
              A dict of keyword arguments values.  Dynamically computed from the
              :attr:`arguments` attribute.
        
           The :attr:`args` and :attr:`kwargs` properties can be used to invoke
           functions::
        
              def test(a, *, b):
                 ...
        
              sig = signature(test)
              ba = sig.bind(10, b=20)
              test(*ba.args, **ba.kwargs)
        
        
        .. seealso::
        
           :pep:`362` - Function Signature Object.
              The detailed specification, implementation details and examples.
        
        Copyright
        ---------
        
        *funcsigs* is a derived work of CPython under the terms of the `PSF License
        Agreement`_. The original CPython inspect module, its unit tests and
        documentation are the copyright of the Python Software Foundation. The derived
        work is distributed under the `Apache License Version 2.0`_.
        
        .. _PSF License Agreement: http://docs.python.org/3/license.html#terms-and-conditions-for-accessing-or-otherwise-using-python
        .. _Apache License Version 2.0: http://opensource.org/licenses/Apache-2.0
        .. _GitHub: https://github.com/testing-cabal/funcsigs
        .. _PSF License Agreement: http://docs.python.org/3/license.html#terms-and-conditions-for-accessing-or-otherwise-using-python
        .. _Travis CI: http://travis-ci.org/
        .. _Read The Docs: http://funcsigs.readthedocs.org/
        .. _PEP 362: http://www.python.org/dev/peps/pep-0362/
        .. _inspect: http://docs.python.org/3/library/inspect.html#introspecting-callables-with-the-signature-object
        .. _issues system: https://github.com/testing-cabal/funcsigs/issues
        .. _Current build status: http://travis-ci.org/#!/aliles/funcsigs
        .. _Coverage status: https://coveralls.io/r/aliles/funcsigs?branch=master
        .. _Latest PyPI version: https://crate.io/packages/funcsigs/
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Libraries :: Python Modules