Add typing extensions

.travis.yml

@@ -3,8 +3,12 @@ language: python
 python:
   - "nightly"
   - "3.7-dev"
-  - "3.6"
-  - "3.5"
+  - "3.6.1"
+  - "3.6.0"
+  - "3.5.3"
+  - "3.5.2"
+  - "3.5.1"
+  - "3.5.0"
   - "3.4"
   - "3.3"
   - "2.7"
@@ -14,5 +18,8 @@ install:
 
 script:
   - export PYTHONPATH=`python -c "import sys; print('python2' if sys.version.startswith('2') else 'src')"`; py.test $PYTHONPATH
+  - if [[ $TRAVIS_PYTHON_VERSION < '3.5' ]]; then python setup.py install; fi
+  - export PYTHONPATH=`python -c "import sys; print('typing_extensions/src_py2' if sys.version.startswith('2') else 'typing_extensions/src_py3')"`;
+    py.test $PYTHONPATH;
   - if [[ $TRAVIS_PYTHON_VERSION == '3.6' ]]; then flake8; fi
-  - if [[ $TRAVIS_PYTHON_VERSION == '3.6' ]]; then flake8 --config=.flake8-tests src/test_typing.py python2/test_typing.py; fi
+  - if [[ $TRAVIS_PYTHON_VERSION == '3.6' ]]; then flake8 --config=.flake8-tests src/test_typing.py python2/test_typing.py typing_extensions/src_py2/test_typing_extensions.py typing_extensions/src_py3/test_typing_extensions.py; fi

test-requirements.txt

@@ -4,3 +4,4 @@ flake8-pyi; python_version >= '3.6'
 pytest>=2.8; python_version >= '3.3'
 pytest-xdist>=1.13; python_version >= '3.3'
 pytest-cov>=2.4.0; python_version >= '3.3'
+typing>=3.6.1; python_version <= '3.4'

tox.ini

@@ -22,4 +22,6 @@ exclude =
   # tests have more relaxed formatting rules
   # and its own specific config in .flake8-tests
   python2/test_typing.py,
-  src/test_typing.py
+  src/test_typing.py,
+  typing_extensions/src_py2/test_typing_extensions.py,
+  typing_extensions/src_py3/test_typing_extensions.py,

typing_extensions/README.rst

@@ -0,0 +1,83 @@
+=================
+Typing Extensions
+=================
+
+.. image:: https://badges.gitter.im/python/typing.svg
+ :alt: Chat at https://gitter.im/python/typing
+ :target: https://gitter.im/python/typing?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
+
+Overview
+========
+
+The ``typing`` module was added to the standard library in Python 3.5 on
+a provisional basis and will no longer be provisional in Python 3.7. However,
+this means users of Python 3.5 - 3.6 who are unable to upgrade will not be
+able to take advantage of new types added to the ``typing`` module, such as
+``typing.Text`` or ``typing.Coroutine``.
+
+The ``typing_extensions`` module contains both backports of these changes
+as well as experimental types that will eventually be added to the ``typing``
+module.
+
+Users of other Python versions should continue to install and use
+use the ``typing`` module from PyPi instead of using this one unless
+specifically writing code that must be compatible with multiple Python
+versions or requires experimental types.
+
+Included items
+==============
+
+This module currently contains the following:
+
+All Python versions:
+--------------------
+
+- ``ClassVar``
+- ``ContextManager``
+- ``Counter``
+- ``DefaultDict``
+- ``Deque``
+- ``NewType``
+- ``NoReturn``
+- ``overload`` (note that older versions of ``typing`` only let you use ``overload`` in stubs)
+- ``Text``
+- ``Type``
+- ``TYPE_CHECKING``
+
+Python 3.3+ only:
+-----------------
+
+- ``ChainMap``
+
+Python 3.5+ only:
+-----------------
+
+- ``AsyncIterable``
+- ``AsyncIterator``
+- ``AsyncContextManager``
+- ``Awaitable``
+- ``Coroutine``
+
+Python 3.6+ only:
+-----------------
+
+- ``AsyncGenerator``
+
+Other Notes and Limitations
+===========================
+
+There are a few types whose interface was modified between different
+versions of typing. For example, ``typing.Sequence`` was modified to
+subclass ``typing.Reversible`` as of Python 3.5.3.
+
+These changes are _not_ backported to prevent subtle compatibility
+issues when mixing the differing implementations of modified classes.
+
+Running tests
+=============
+
+To run tests, navigate into the appropriate source directory and run
+``test_typing_extensions.py``. You will also need to install the latest
+version of ``typing`` if you are using a version of Python that does not
+include ``typing`` as a part of the standard library.
+

typing_extensions/setup.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+import sys
+from distutils.core import setup
+
+if sys.version_info < (2, 7, 0) or (3, 0, 0) <= sys.version_info < (3, 3, 0):
+    sys.stderr.write('ERROR: You need Python 2.7 or 3.3+ '
+                     'to install the typing package.\n')
+    exit(1)
+
+version = '3.6.1'
+description = 'Backported and Experimental Type Hints for Python 3.5+'
+long_description = '''\
+Typing Extensions -- Backported and Experimental Type Hints for Python
+
+The ``typing`` module was added to the standard library in Python 3.5 on
+a provisional basis and will no longer be provisional in Python 3.7. However,
+this means users of Python 3.5 - 3.6 who are unable to upgrade will not be
+able to take advantage of new types added to the ``typing`` module, such as
+``typing.Text`` or ``typing.Coroutine``.
+
+The ``typing_extensions`` module contains both backports of these changes
+as well as experimental types that will eventually be added to the ``typing``
+module.
+
+Users of other Python versions should continue to install and use
+use the ``typing`` module from PyPi instead of using this one unless
+specifically writing code that must be compatible with multiple Python
+versions or requires experimental types.
+'''
+
+classifiers = [
+    'Development Status :: 3 - Alpha',
+    'Environment :: Console',
+    'Intended Audience :: Developers',
+    'License :: OSI Approved :: Python Software Foundation License',
+    'Operating System :: OS Independent',
+    'Programming Language :: Python :: 2.7',
+    'Programming Language :: Python :: 3.3',
+    'Programming Language :: Python :: 3.4',
+    'Programming Language :: Python :: 3.5',
+    'Programming Language :: Python :: 3.6',
+    'Topic :: Software Development',
+]
+
+if sys.version_info.major == 2:
+    package_dir = 'src_py2'
+elif sys.version_info.major == 3:
+    package_dir = 'src_py3'
+else:
+    raise AssertionError()
+
+install_requires = []
+if sys.version_info < (3, 5):
+    install_requires.append('typing >= 3.6.1')
+
+setup(name='typing_extensions',
+      version=version,
+      description=description,
+      long_description=long_description,
+      author='Guido van Rossum, Jukka Lehtosalo, Lukasz Langa, Michael Lee',
+      author_email='[email protected]',
+      url='https://github.com/python/typing',
+      license='PSF',
+      keywords='typing function annotations type hints hinting checking '
+               'checker typehints typehinting typechecking backport',
+      package_dir={'': package_dir},
+      py_modules=['typing_extensions'],
+      classifiers=classifiers,
+      install_requires=install_requires)