Improve and document DuctRegistry, remove omniduct.session, add `…

…about()` functionality and add new logo. (#87)

MANIFEST.in

@@ -0,0 +1 @@
+include omniduct/logo.*

README.md

@@ -1,4 +1,4 @@
-# Omniduct
+# <img src="https://raw.githubusercontent.com/airbnb/omniduct/master/omniduct/logo.png" height=200> Omniduct
 [![PyPI - Version](https://img.shields.io/pypi/v/omniduct.svg)](https://pypi.org/project/omniduct/)
 ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/omniduct.svg)
 ![PyPI - Status](https://img.shields.io/pypi/status/omniduct.svg)

omniduct/__init__.py

@@ -3,8 +3,28 @@
 from omniduct.duct import Duct
 from omniduct.registry import DuctRegistry
 from . import protocols
-from ._version import *
-from .utils.session import is_directly_imported
+from ._version import __author__, __author_email__, __version__, __logo__, __docs_url__
 
-if is_directly_imported():
-    from .session import *
+
+def about():
+    from collections import OrderedDict
+    from .utils.about import show_about
+
+    return show_about(
+        "Omniduct",
+        version=__version__,
+        logo=__logo__,
+        maintainers=OrderedDict(zip(
+            [a.strip() for a in __author__.split(',')],
+            [a.strip() for a in __author_email__.split(',')]
+        )),
+        attributes={
+            'Documentation': __docs_url__,
+        },
+        description="""
+        Omniduct provides uniform interfaces for connecting to and extracting data
+        from a wide variety of (potentially remote) data stores (including HDFS,
+        Hive, Presto, MySQL, etc).
+        """,
+        endorse_omniduct=False
+    )

omniduct/_version.py

@@ -1,11 +1,13 @@
 import os
 import sys
 
-__all__ = ['__author__', '__author_email__', '__version__']
+__all__ = ['__author__', '__author_email__', '__version__', '__logo__', '__docs_url__']
 
 __author__ = "Matthew Wardrop, Dan Frank"
-__author_email__ = "matthew.wardrop@airbnb.com, dan.frank@airbnb.com"
+__author_email__ = "mpwardrop@gmail.com, danfrankj@gmail.com"
 __version__ = "0.9.6"
+__logo__ = os.path.join(os.path.dirname(__file__), 'logo.png') if '__file__' in globals() else None
+__docs_url__ = "https://omniduct.readthedocs.io/"
 
 
 # These are the core dependencies, and should not include those which are used only in handling specific protocols.