Added list-of-RICs and performance information.

Author: wasin-waeosri

.gitignore

@@ -133,6 +133,6 @@ note.md
 # for development purposes, ignore these notebooks
 notebook/ld_get_data_async.ipynb
 notebook/ld_notebook_async_taskgroup.ipynb 
-notebook/ld_notebook_gather_performance.ipynb
+#notebook/ld_notebook_gather_performance.ipynb
 notebook/ld_notebook_taskgroup_performance.ipynb 
 notebook/test_notebook.ipynb

notebook/.env.example

@@ -1,4 +1,4 @@
-# LSEG Data Library for Python Platform Session Credentials
+# LSEG Data Library for Python Platform Session Credentials (V1)
 
 # API Key for authentication (required)
 LSEG_API_KEY=your_api_key_here

notebook/ld_notebook_async_gather.ipynb

@@ -1691,6 +1691,22 @@
     "ld.close_session()"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "8d050ac7",
+   "metadata": {},
+   "source": [
+    "## What about the list of RICs?\n",
+    "\n",
+    "The Historical Pricing definitions universe parameter accept both single-RIC and list-of-RICs inputs.\n",
+    "\n",
+    "**Single-RIC approach** (recommended): Each request returns its own dataframe and raw json response, making it easy to handle successes and failures individually.\n",
+    "\n",
+    "**List-of-RICs approach**: A single request returns a [multi-index](https://pandas.pydata.org/docs/user_guide/advanced.html#multiindex-advanced-indexing) dataframe with data from all RICs combined along with an array of JSON data. This is harder to manage and parse errors per individual instrument.\n",
+    "\n",
+    "**Recommendation**: Use multiple single-RIC requests with `asyncio.gather()` for better control and error handling."
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "79d61f12",
@@ -1724,6 +1740,12 @@
     "- Monitoring jobs where partial data is still valuable.\n",
     "- Exploratory workflows where you want both data and errors in one run.\n",
     "\n",
+    "### Performance\n",
+    "\n",
+    "Please check the [ld_notebook_gather_performance.ipynb](./ld_notebook_gather_performance.ipynb) for the 30 instruments interday requests demonstration.\n",
+    "\n",
+    "The performance demonstration notebook uses `response.data.raw` statement to display the raw output data in JSON format. If you instead use `response.data.df` statement to retrieve the data as a DataFrame, please note that additional time is required to convert the JSON data into a DataFrame.\n",
+    "\n",
     "### Important note\n",
     "\n",
     "`return_exceptions=True` does not hide errors. It returns them as list items, so your code should explicitly handle both successful responses and exceptions."
@@ -1747,8 +1769,16 @@
     "\n",
     "Among these approaches, `TaskGroup` is now a common choice and is frequently compared with `gather` in modern asyncio design discussions.\n",
     "\n",
-    "In the next section, I will show how to use Data Library Historical Pricing `get_data_async` with `asyncio.TaskGroup`."
+    "### What Next?\n",
+    "\n",
+    "I will show how to use Data Library Historical Pricing `get_data_async` with `asyncio.TaskGroup`."
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2993b364",
+   "metadata": {},
+   "source": []
   }
  ],
  "metadata": {