release v0.2.11 to warn about future rename to hetnetpy

Merges #41
Refs #40

Author: dhimmel

README.md

@@ -4,6 +4,16 @@
 [![GitHub issues](https://img.shields.io/github/issues/hetio/hetio.svg)](https://github.com/hetio/hetio/issues)
 [![Build Status](https://travis-ci.com/hetio/hetio.svg?branch=master)](https://travis-ci.com/hetio/hetio)
 
+## Package relocation
+
+**Critical**:
+This is the final release before the package name [changes](https://github.com/hetio/hetio/issues/40) to `hetnetpy` from `hetio`.
+Future development will occur in the `hetio/hetnetpy` [repository](https://github.com/hetio/hetnetpy).
+PyPI releases will be available at <https://pypi.org/project/hetnetpy/>.
+
+Users of v0.2.11 will see a warning when importing `hetio`.
+These users should either switch to using `hetnetpy` or downgrade to `hetio<=0.2.10` to avoid the warning.
+
 ## Background
 
 **Hetnets**: Hetnets, also [called](https://doi.org/10.15363/thinklab.d104) *heterogeneous information networks*, are graphs with multiple node and edge types. Hetnets are both multipartite and multirelational. They provide a scalable, intuitive, and frictionless structure for data integration.

hetio/__init__.py

@@ -1 +1,11 @@
-__version__ = '0.2.10'
+import warnings
+
+__version__ = "0.2.11"
+
+message = '''
+PACKAGE HAS BEEN RELOCATED:
+v0.2.11 is the last release before the hetio package is renamed to hetnetpy.
+Consider switching to the hetnetpy package or specifying hetio<=0.2.10 to silence this warning.
+Future releases and development will only occur for the hetnetpy package.
+'''
+warnings.warn(message, FutureWarning)

release-notes/v0.2.11.txt

@@ -0,0 +1,9 @@
+hetio/hetio v0.2.11
+===================
+
+Final release before this package is renamed to hetnetpy from hetio.
+See <https://github.com/hetio/hetio/issues/40> for more information on the renaming.
+`import hetio` will raise a DeprecationWarning.
+Users are recommended to switch to hetnetpy or downgrade to v0.2.10 to avoid the warning.
+
+There are no functional changes in this release.

test/relocation_test.py

@@ -0,0 +1,13 @@
+import importlib
+
+import pytest
+
+
+def test_relocation_warning():
+    """
+    https://github.com/hetio/hetio/issues/40
+    """
+    with pytest.warns(FutureWarning, match='PACKAGE HAS BEEN RELOCATED'):
+        import hetio
+        # Reload module to ensure warning tiggers
+        importlib.reload(hetio)