Update example notebook for return of dataframe

Author: Serge Rey

libpysal/examples/__init__.py

@@ -2,6 +2,8 @@
     example datasets as well as functions to fetch larger datasets.
 """
 
+
+import pandas as pd
 from .base import example_manager
 from .remotes import datasets as remote_datasets
 from .builtin import datasets as builtin_datasets
@@ -20,7 +22,6 @@ def fetch_all():
     names = list(datasets.keys())
     names.sort()
     for name in names:
-        print(name)
         example = datasets[name]
         try:
             example.download()
@@ -29,8 +30,8 @@ def fetch_all():
     example_manager.add_examples(datasets)
 
 
-def available() -> str:
-    """List available datasets."""
+def available() -> pd.DataFrame:
+    """Return a dataframe with available datasets."""
     fetch_all()
 
     return example_manager.available()

libpysal/examples/base.py

@@ -148,7 +148,7 @@ def get_path(self, file_name, verbose=True) -> Union[str, None]:
             if file_name == base_name:
                 return file_path
         if verbose:
-            print("{} is not a file in this example".format(file_name))
+            print(f'{file_name} is not a file in this example.')
         return None
 
     def downloaded(self) -> bool:
@@ -179,9 +179,7 @@ def explain(self) -> None:
     def download(self, path=get_data_home()):
         """Download the files for the example."""
 
-        if self.downloaded():
-            print("Already downloaded")
-        else:
+        if not self.downloaded():
             request = requests.get(self.download_url)
             archive = zipfile.ZipFile(io.BytesIO(request.content))
             target = join(path, self.root)
@@ -253,11 +251,10 @@ def load(self, example_name: str) -> Example:
             if example.installed:
                 return example
             else:
-                "Downloading: {}".format(example_name)
                 example.download()
                 return example
         else:
-            print("Example not available: {}".format(example_name))
+            print(f'Example not available: {example_name}')
             return None
 
     def download_remotes(self):
@@ -271,7 +268,7 @@ def download_remotes(self):
             try:
                 example.download()
             except:
-                print("Example not downloaded: {}".format(name))
+                print(f'Example not downloaded: {name}.')
 
     def get_installed_names(self) -> list:
         """Return names of all currently installed datasets."""