rda-python-globus 1.0.14__tar.gz → 1.0.18__tar.gz

{rda_python_globus-1.0.14/src/rda_python_globus.egg-info → rda_python_globus-1.0.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rda_python_globus
-Version: 1.0.14
+Version: 1.0.18
 Summary: Tools for managing Globus transfers supporting the NSF NCAR Geoscience Data Exchange (GDEX) project.
 Author-email: Thomas Cram <tcram@ucar.edu>
 Project-URL: Homepage, https://github.com/NCAR/rda-python-globus
@@ -20,7 +20,7 @@ Dynamic: license-file
 # dsglobus
 
 This application is a command-line tool for Globus data transfer and management of files 
-archived in the NSF NCAR Research Data Archive.
+archived in the [NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
 
 ## Installation
 
@@ -43,6 +43,7 @@ The `dsglobus` app is run with the following subcommands.  Each supports a
 dsglobus transfer --help
 dsglobus get-task --help
 dsglobus task-list --help
+dsglobus task-event-list --help
 dsglobus cancel-task --help
 dsglobus ls --help
 dsglobus mkdir --help
@@ -51,12 +52,12 @@ dsglobus delete --help
 ```
 
 ### Example usage
-1. Transfer a single file from the `NCAR RDA GLADE` endpoint to the `NCAR RDA Quasar`
+1. Transfer a single file from the `NCAR GDEX GLADE` endpoint to the `NCAR GDEX Quasar`
 endpoint:
 ```
 $ dsglobus transfer \
-    --source-endpoint rda-glade \
-    --destination-endpoint rda-quasar \
+    --source-endpoint gdex-glade \
+    --destination-endpoint gdex-quasar \
     --source-file /data/d999009/file.txt \
     --destination-file /d999009/file.txt
 ```

{rda_python_globus-1.0.14 → rda_python_globus-1.0.18}/README.md

@@ -1,7 +1,7 @@
 # dsglobus
 
 This application is a command-line tool for Globus data transfer and management of files 
-archived in the NSF NCAR Research Data Archive.
+archived in the [NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
 
 ## Installation
 
@@ -24,6 +24,7 @@ The `dsglobus` app is run with the following subcommands.  Each supports a
 dsglobus transfer --help
 dsglobus get-task --help
 dsglobus task-list --help
+dsglobus task-event-list --help
 dsglobus cancel-task --help
 dsglobus ls --help
 dsglobus mkdir --help
@@ -32,12 +33,12 @@ dsglobus delete --help
 ```
 
 ### Example usage
-1. Transfer a single file from the `NCAR RDA GLADE` endpoint to the `NCAR RDA Quasar`
+1. Transfer a single file from the `NCAR GDEX GLADE` endpoint to the `NCAR GDEX Quasar`
 endpoint:
 ```
 $ dsglobus transfer \
-    --source-endpoint rda-glade \
-    --destination-endpoint rda-quasar \
+    --source-endpoint gdex-glade \
+    --destination-endpoint gdex-quasar \
     --source-file /data/d999009/file.txt \
     --destination-file /d999009/file.txt
 ```

{rda_python_globus-1.0.14 → rda_python_globus-1.0.18}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rda_python_globus"
-version = "1.0.14"
+version = "1.0.18"
 authors = [
   { name="Thomas Cram", email="tcram@ucar.edu" },
 ]

{rda_python_globus-1.0.14 → rda_python_globus-1.0.18}/src/rda_python_globus/task_management.py

@@ -212,6 +212,55 @@ def task_list(
 
     print_table(tasks, fields)
 
+@click.command(
+    help="List events and show details about a Globus task, including faults and error messages.",
+)
+@click.argument(
+    "task-id",
+    type=click.UUID,
+)
+@click.option(
+    "--limit",
+    "-l",
+    type=int,
+    default=None,
+    show_default=True,
+    help="Limit the number of results returned.",
+)
+@click.option(
+    "--offset",
+    "-o",
+    type=int,
+    default=None,
+    help="Offset used in pagination.",
+)
+@click.option(
+    "--error-only",
+    "-e",
+    is_flag=True,
+    help="Only show events with error codes.",
+)
+@namespace_options
+@common_options
+def task_event_list(task_id: uuid.UUID, limit: int, offset: int, error_only: bool, namespace: str) -> None:
+    """ 
+    List the events associated with a Globus task.  This includes status
+    updates, error messages, and other information about the task's progress.
+    """
+    if not task_id:
+        raise click.UsageError("TASK_ID is required.")
+    
+    tc = transfer_client(namespace=namespace)
+    try:
+        if error_only:
+            filters = {"filter": "is_error:1"}
+        for event in tc.task_event_list(task_id, limit=limit, offset=offset, query_params=filters):
+            print(f"Event on Task({task_id}) at {event['time']}:\n{event['code']}\n{event['description']}\n{event['details']}\n")
+    except (GlobusAPIError, NetworkError) as e:
+        logger.error(f"Error: {e}")
+        click.echo("Failed to get task events.")
+        return
+
 @click.command(
     help="Cancel a Globus task.",
 )
@@ -241,4 +290,5 @@ def add_commands(group):
     """ Add task management commands to a click group. """
     group.add_command(get_task)
     group.add_command(task_list)
+    group.add_command(task_event_list)
     group.add_command(cancel_task)

{rda_python_globus-1.0.14 → rda_python_globus-1.0.18/src/rda_python_globus.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rda_python_globus
-Version: 1.0.14
+Version: 1.0.18
 Summary: Tools for managing Globus transfers supporting the NSF NCAR Geoscience Data Exchange (GDEX) project.
 Author-email: Thomas Cram <tcram@ucar.edu>
 Project-URL: Homepage, https://github.com/NCAR/rda-python-globus
@@ -20,7 +20,7 @@ Dynamic: license-file
 # dsglobus
 
 This application is a command-line tool for Globus data transfer and management of files 
-archived in the NSF NCAR Research Data Archive.
+archived in the [NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
 
 ## Installation
 
@@ -43,6 +43,7 @@ The `dsglobus` app is run with the following subcommands.  Each supports a
 dsglobus transfer --help
 dsglobus get-task --help
 dsglobus task-list --help
+dsglobus task-event-list --help
 dsglobus cancel-task --help
 dsglobus ls --help
 dsglobus mkdir --help
@@ -51,12 +52,12 @@ dsglobus delete --help
 ```
 
 ### Example usage
-1. Transfer a single file from the `NCAR RDA GLADE` endpoint to the `NCAR RDA Quasar`
+1. Transfer a single file from the `NCAR GDEX GLADE` endpoint to the `NCAR GDEX Quasar`
 endpoint:
 ```
 $ dsglobus transfer \
-    --source-endpoint rda-glade \
-    --destination-endpoint rda-quasar \
+    --source-endpoint gdex-glade \
+    --destination-endpoint gdex-quasar \
     --source-file /data/d999009/file.txt \
     --destination-file /d999009/file.txt
 ```