Rename package: pep567 -> contextvars.

Author: 1st1

README.rst

@@ -12,6 +12,13 @@ module (see PEP 567) for Python 3.6.
 asyncio event loop with PEP 567 support yet.  Stay tuned for updates.
 
 
+Original "contextvars" Package
+==============================
+
+This package replaces the old "contextvars" PyPI package which
+repository is available `here <https://github.com/gawen/contextvars>`_.
+
+
 Documentation
 =============
 
@@ -20,33 +27,55 @@ https://docs.python.org/3.7/library/contextvars.html
 
 
 `PEP 567 <https://www.python.org/dev/peps/pep-0567/>`_ also provides
-a comprehensive overview of the API and explains the design choices.
+a comprehensive overview of the API and explains all design choices.
 
 
 Installation
 ============
 
 .. code-block:: bash
 
-    $ pip install pep567
+    $ pip install contextvars
 
 
 Usage
 =====
 
 .. code-block:: python
 
-    try:
-        # Python 3.7
-        import contextvars
-    except ImportError:
-        # Python <= 3.6
-        import pep567 as contextvars
+    import contextvars
 
     my_var = contextvars.ContextVar('my_var')
+
     # ...
 
 
+Listing as a Dependency
+=======================
+
+The good news is that the standard library always takes the
+precedence over site packages, so even if a local ``contextvars``
+module is installed, the one from the standard library will be used.
+Therefore you can simply list "contextvars" in your
+``requirements.txt`` or ``setup.py`` files.
+
+Another option is to use `"platform specific dependencies"
+<http://setuptools.readthedocs.io/en/latest/setuptools.html\
+#declaring-platform-specific-dependencies>`_ setuptools feature:
+
+.. code-block:: python
+
+    import setuptools
+
+    setuptools.setup(
+        name="Project",
+        ...
+        install_requires=[
+            'contextvars;python_version<"3.7"'
+        ]
+    )
+
+
 License
 =======
 

pep567/__init__.py renamed to contextvars/__init__.py

@@ -44,7 +44,7 @@ class ContextMeta(type(collections.abc.Mapping)):
 
     def __new__(mcls, names, bases, dct):
         cls = super().__new__(mcls, names, bases, dct)
-        if cls.__module__ != 'pep567' or cls.__name__ != 'Context':
+        if cls.__module__ != 'contextvars' or cls.__name__ != 'Context':
             raise TypeError("type 'Context' is not an acceptable base type")
         return cls
 
@@ -96,7 +96,7 @@ class ContextVarMeta(type):
 
     def __new__(mcls, names, bases, dct):
         cls = super().__new__(mcls, names, bases, dct)
-        if cls.__module__ != 'pep567' or cls.__name__ != 'ContextVar':
+        if cls.__module__ != 'contextvars' or cls.__name__ != 'ContextVar':
             raise TypeError("type 'ContextVar' is not an acceptable base type")
         return cls
 
@@ -176,7 +176,7 @@ class TokenMeta(type):
 
     def __new__(mcls, names, bases, dct):
         cls = super().__new__(mcls, names, bases, dct)
-        if cls.__module__ != 'pep567' or cls.__name__ != 'Token':
+        if cls.__module__ != 'contextvars' or cls.__name__ != 'Token':
             raise TypeError("type 'Token' is not an acceptable base type")
         return cls
 

setup.py

@@ -7,14 +7,14 @@
 
 
 setuptools.setup(
-    name='pep567',
-    version="0.1.0",
+    name='contextvars',
+    version="2.0",
     description='PEP 567 Backport',
     long_description=readme,
     author='MagicStack Inc',
     author_email='[email protected]',
-    packages=['pep567'],
-    provides=['pep567'],
+    packages=['contextvars'],
+    provides=['contextvars'],
     license='Apache License, Version 2.0',
     classifiers=[
         'Development Status :: 3 - Alpha',

tests/test_basics.py

@@ -9,7 +9,7 @@
 import time
 import unittest
 
-import pep567 as contextvars
+import contextvars
 
 
 def isolated_context(func):