diff options
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 83 |
1 files changed, 0 insertions, 83 deletions
diff --git a/README.rst b/README.rst deleted file mode 100644 index f04b7b4..0000000 --- a/README.rst +++ /dev/null @@ -1,83 +0,0 @@ -funcsigs -======== - -``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.2 and up. - -|pypi_version| - -Documentation -------------- - -The reference documentation is standard library documentation for the -`inspect`_ module in Python3. This documentation has been included in the -``funcsigs`` package documentation hosted on `Read The Docs`_. - -Example -------- - -To obtain a signature object, pass the target function to the -``funcsigs.signature`` function. :: - - >>> from funcsigs import signature - >>> def foo(a, b=None, *args, **kwargs): - ... pass - - >>> sig = signature(foo) - -For the details of the signature object, refer to the either the package of -standard library documentation. - -Compatability -------------- - -The ``funcsigs`` backport has been tested against: - -* CPython 2.6 -* CPython 2.7 -* CPython 3.2 -* PyPy 1.9 - -Continuous integration testing is provided by `Travis CI`_. - -Under Python 2.x there is a compatability 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 compatability 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| - -Copyright ---------- - -This 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`_. - -.. _Apache License Version 2.0: http://opensource.org/licenses/Apache-2.0 -.. _GitHub: https://github.com/aliles/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/alies/funcsigs/issues - -.. |build_status| image:: https://secure.travis-ci.org/aliles/funcsigs.png?branch=master - :target: http://travis-ci.org/#!/aliles/funcsigs - :alt: Current build status - -.. |coverage| image:: https://coveralls.io/repos/aliles/funcsigs/badge.png?branch=master - :target: https://coveralls.io/r/aliles/funcsigs?branch=master - :alt: Coverage status - -.. |pypi_version| image:: https://pypip.in/v/funcsigs/badge.png - :target: https://crate.io/packages/funcsigs/ - :alt: Latest PyPI version |