Added help messages to release.py

Added new command "list" to release.py that lists all pypi releases

Author: Jandro

release.py

@@ -6,11 +6,13 @@
 import shutil
 import subprocess
 import sys
+import requests
 from pathlib import Path
 
 import click
 
-
+PYPI_PACKAGE_NAME = 'O365'
+PYPI_URL = 'https://pypi.org/pypi/{package}/json'
 DIST_PATH = 'dist'
 DIST_PATH_DELETE = 'dist_delete'
 CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])
@@ -22,7 +24,7 @@ def cli():
 
 
 @cli.command()
-@click.option('--force/--no-force', default=False)
+@click.option('--force/--no-force', default=False, help='Will force a new build removing the previous ones')
 def build(force):
     """ Builds the distribution files: wheels and source. """
     dist_path = Path(DIST_PATH)
@@ -41,8 +43,8 @@ def build(force):
 
 
 @cli.command()
-@click.option('--release/--no-release', default=False)
-@click.option('--rebuild/--no-rebuild', default=True)
+@click.option('--release/--no-release', default=False, help='--release to upload to pypi otherwise upload to test.pypi')
+@click.option('--rebuild/--no-rebuild', default=True, help='Will force a rebuild of the build files (src and wheels)')
 @click.pass_context
 def upload(ctx, release, rebuild):
     """ Uploads distribuition files to pypi or pypitest. """
@@ -76,30 +78,56 @@ def check():
 
     subprocess.check_call(['twine', 'check', 'dist/*'])
 
+
 @cli.command()
-@click.option('--annotate/--no-annotate',default=False)
-@click.option('--coverage/--no-coverage',default=False)
-@click.option('-v/-nv',default=False)
-@click.option('-vv/-nvv',default=False)
-def test(annotate,coverage,v,vv):
-    """ runs tests and optionally creates annotated files of coverage. """
-    args = ["python3","-m","pytest","tests/"]
+@click.option('--annotate/--no-annotate', default=False, help='Annotate coverage on files')
+@click.option('--coverage/--no-coverage', default=False, help='Run coverage')
+@click.option('-v/-nv', default=False, help='Verbose')
+@click.option('-vv/-nvv', default=False, help='Very verbose')
+def test(annotate, coverage, v, vv):
+    """ Runs tests and optionally creates annotated files of coverage. """
+    args = ['python3', '-m', 'pytest', 'tests/']
     if coverage:
-        args.append("--cov=O365")
+        args.append('--cov=O365')
         if annotate:
-            args.append("--cov-report")
-            args.append("annotate")
-        if v:#Verbose
-            args.append("-v")
-        if vv and not v:#Very verbose
-            args.append("-vv")
+            args.append('--cov-report')
+            args.append('annotate')
+        if v:  # Verbose
+            args.append('-v')
+        if vv and not v:  # Very verbose
+            args.append('-vv')
 
     env = os.environ.copy()
 
-    p = subprocess.Popen(args,env=env)
-    
+    p = subprocess.Popen(args, env=env)
     p.wait()
 
 
+# noinspection PyShadowingBuiltins
+@cli.command(name='list')
+def list_releases():
+    """ Lists all releases published on pypi. """
+    response = requests.get(PYPI_URL.format(package=PYPI_PACKAGE_NAME))
+    if response:
+        data = response.json()
+
+        releases_dict = data.get('releases', {})
+
+        if releases_dict:
+            for version, release in releases_dict.items():
+                release_formats = []
+                published_on_date = None
+                for fmt in release:
+                    release_formats.append(fmt.get('packagetype'))
+                    published_on_date = fmt.get('upload_time')
+
+                release_formats = ' | '.join(release_formats)
+                print('{:<10}{:>15}{:>25}'.format(version, published_on_date, release_formats))
+        else:
+            print('No releases found for {}'.format(PYPI_PACKAGE_NAME))
+    else:
+        print('Package "{}" not found on Pypi.org'.format(PYPI_PACKAGE_NAME))
+
+
 if __name__ == "__main__":
     cli()