summaryrefslogtreecommitdiffstats
path: root/FOSS/Python/Dependencies/future-0.18.2/docs/utilities.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/utilities.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/utilities.rst')
-rw-r--r--FOSS/Python/Dependencies/future-0.18.2/docs/utilities.rst48
1 files changed, 0 insertions, 48 deletions
diff --git a/FOSS/Python/Dependencies/future-0.18.2/docs/utilities.rst b/FOSS/Python/Dependencies/future-0.18.2/docs/utilities.rst
deleted file mode 100644
index e3f1e9c..0000000
--- a/FOSS/Python/Dependencies/future-0.18.2/docs/utilities.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-.. _utilities-guide:
-
-Utilities
----------
-
-:mod:`future` also provides some useful functions and decorators to ease
-backward compatibility with Py2 in the :mod:`future.utils` and
-:mod:`past.utils` modules. These are a selection of the most useful functions
-from ``six`` and various home-grown Py2/3 compatibility modules from popular
-Python projects, such as Jinja2, Pandas, IPython, and Django. The goal is to
-consolidate these in one place, tested and documented, obviating the need for
-every project to repeat this work.
-
-Examples::
-
- # Functions like print() expect __str__ on Py2 to return a byte
- # string. This decorator maps the __str__ to __unicode__ on Py2 and
- # defines __str__ to encode it as utf-8:
-
- from future.utils import python_2_unicode_compatible
-
- @python_2_unicode_compatible
- class MyClass(object):
- def __str__(self):
- return u'Unicode string: \u5b54\u5b50'
- a = MyClass()
-
- # This then prints the Chinese characters for Confucius:
- print(a)
-
-
- # Iterators on Py3 require a __next__() method, whereas on Py2 this
- # is called next(). This decorator allows Py3-style iterators to work
- # identically on Py2:
-
- @implements_iterator
- class Upper(object):
- def __init__(self, iterable):
- self._iter = iter(iterable)
- def __next__(self): # note the Py3 interface
- return next(self._iter).upper()
- def __iter__(self):
- return self
-
- print(list(Upper('hello')))
- # prints ['H', 'E', 'L', 'L', 'O']
-
-On Python 3 these decorators are no-ops.