Add dogshell/dogshellwrap entry points (#305)

Currently, the 'dog' entrypoint conflicts with a binary of the same name
from sheepdog, a package available in major linux distributions. In
packaging, we've renamed the dog entrypoint from this package to
dogshell to match the source module's name and to avoid conflicts. I
think it makes sense to also add it as an entrypoint here for
consistency. I've marked it as Pending Deprecation, so that in the
future we can transition users to dogshell and retire the dog name.

datadog/dogshell/__init__.py

@@ -3,6 +3,8 @@
 # Copyright 2015-Present Datadog, Inc
 # stdlib
 import os
+import warnings
+import sys
 
 # 3p
 import argparse
@@ -28,6 +30,9 @@
 
 
 def main():
+    if sys.argv[0].endswith("dog"):
+        warnings.warn("dog is pending deprecation. Please use dogshell instead.", PendingDeprecationWarning)
+
     parser = argparse.ArgumentParser(description="Interact with the Datadog API",
                                      formatter_class=argparse.ArgumentDefaultsHelpFormatter)
     parser.add_argument('--config', help="location of your dogrc file (default ~/.dogrc)",

datadog/dogshell/wrap.py

@@ -28,6 +28,7 @@
 import sys
 import threading
 import time
+import warnings
 
 # datadog
 from datadog import initialize, api
@@ -405,4 +406,6 @@ def main():
 
 
 if __name__ == '__main__':
+    if sys.argv[0].endswith("dogwrap"):
+        warnings.warn("dogwrap is pending deprecation. Please use dogshellwrap instead.", PendingDeprecationWarning)
     main()

setup.py

@@ -39,7 +39,14 @@ def get_readme_md_contents():
         "Documentation": "https://datadogpy.readthedocs.io/en/latest/",
         "Source Code": "https://github.com/DataDog/datadogpy",
     },
-    entry_points={"console_scripts": ["dog = datadog.dogshell:main", "dogwrap = datadog.dogshell.wrap:main"]},
+    entry_points={
+        "console_scripts": [
+            "dog = datadog.dogshell:main",
+            "dogwrap = datadog.dogshell.wrap:main"
+            "dogshell = datadog.dogshell:main",
+            "dogshellwrap = datadog.dogshell.wrap:main"
+        ]
+    },
     test_suite="tests",
     classifiers=[
         "License :: OSI Approved :: BSD License",