summaryrefslogtreecommitdiffstats
path: root/FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst
diff options
context:
space:
mode:
authoryum <yum.food.vr@gmail.com>2023-01-23 14:28:53 -0800
committeryum <yum.food.vr@gmail.com>2023-01-23 14:32:09 -0800
commit9fff496394dcd94c4084694ca96a5e07ab836274 (patch)
treed89b78e16ecb6011bdd74555da79f7a8c1d90752 /FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst
parent9329d64f991b8b3289af22e4c2eedb09a97c5640 (diff)
package.ps1 now fetches all dependencies
Don't literally check in Python since it looks dodgy (rightfully so). Instead the build script just fetches it. * Update README, simplifying language and documenting other projects
Diffstat (limited to 'FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst')
-rw-r--r--FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst37
1 files changed, 0 insertions, 37 deletions
diff --git a/FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst b/FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst
deleted file mode 100644
index a298f2c..0000000
--- a/FOSS/Python/Dependencies/future-0.18.2/docs/func_annotations.rst
+++ /dev/null
@@ -1,37 +0,0 @@
-.. _func_annotations:
-
-Function annotations
-====================
-
-Function annotations are a piece of syntax introduced in Python 3.0 that was
-not backported to Python 2.x. (See PEP 3107:
-http://www.python.org/dev/peps/pep-3107/). They cause Python 2 to raise a
-SyntaxError.
-
-To rewrite Python 3 code with function annotations to be compatible with both
-Python 3 and Python 2, you can replace the annotation syntax with a dictionary
-called ``__annotations__`` as an attribute on your functions. For example, code
-such as this::
-
- def _parse(self, filename: str, dir='.') -> list:
- pass
-
-can be re-expressed like this::
-
- def _parse(self, filename, dir='.'):
- pass
- _parse.__annotations__ = {'filename': str, 'return': list}
-
-As described in PEP 3107, the annotation for a function's return value
-corresponds to the ``'return'`` key in the dictionary.
-
-(Note that PEP 3107 describes annotations as belonging to a
-``func_annotations`` attribute. This attribute was renamed in Python 3.2 to
-``__annotations__``.)
-
-Be aware that some libraries that consume function annotations, such as
-`Reticulated <https://github.com/mvitousek/reticulated>`_, have their own
-semantics for supporting earlier Python versions, such as decorators. If you
-are using such a library, please use its own mechanism for providing
-compatibility with earlier Python versions, rather than the generic equivalent
-above.