]> granicus.if.org Git - python/commitdiff
When adding a module like functools, it helps to let SVN know about the file.
authorNick Coghlan <ncoghlan@gmail.com>
Mon, 29 May 2006 20:27:44 +0000 (20:27 +0000)
committerNick Coghlan <ncoghlan@gmail.com>
Mon, 29 May 2006 20:27:44 +0000 (20:27 +0000)
Lib/functools.py [new file with mode: 0644]

diff --git a/Lib/functools.py b/Lib/functools.py
new file mode 100644 (file)
index 0000000..5aa30e3
--- /dev/null
@@ -0,0 +1,26 @@
+"""functools.py - Tools for working with functions
+"""
+# Python module wrapper for _functools C module
+# to allow utilities written in Python to be added
+# to the functools module.
+# Written by Nick Coghlan <ncoghlan at gmail.com>
+#   Copyright (c) 2006 Python Software Foundation.
+
+from _functools import partial
+__all__ = [
+    "partial",
+]
+
+# Still to come here (need to write tests and docs):
+#   update_wrapper - utility function to transfer basic function
+#                    metadata to wrapper functions
+#   WRAPPER_ASSIGNMENTS & WRAPPER_UPDATES - defaults args to above
+#           (update_wrapper has been approved by BDFL)
+#   wraps - decorator factory equivalent to:
+#               def wraps(f):
+#                     return partial(update_wrapper, wrapped=f)
+#
+# The wraps function makes it easy to avoid the bug that afflicts the
+# decorator example in the python-dev email proposing the
+# update_wrapper function:
+# http://mail.python.org/pipermail/python-dev/2006-May/064775.html
\ No newline at end of file