Add more detailed error message for an exception

Author: njmei

allensdk/brain_observatory/behavior/session_apis/data_io/behavior_lims_api.py

@@ -99,7 +99,9 @@ def _get_ids(self) -> Dict[str, Optional[Union[int, List[int]]]]:
         """
         ids_response = self.lims_db.select(query)
         if len(ids_response) > 1 or len(ids_response) < 1:
-            raise OneResultExpectedError
+            raise OneResultExpectedError(
+                f"Expected length one result, received: "
+                f"{ids_response} results from query")
         ids_dict = ids_response.iloc[0].to_dict()
 
         #  Get additional ids if also an ophys session

allensdk/brain_observatory/behavior/session_apis/data_io/behavior_ophys_lims_api.py

@@ -151,6 +151,7 @@ def get_ophys_experiment_df() -> pd.DataFrame:
 
     @staticmethod
     def get_containers_df(only_passed=True) -> pd.DataFrame:
+        """Get a DataFrame of experiment containers"""
 
         api = (credential_injector(LIMS_DB_CREDENTIAL_MAP)
                (PostgresQueryMixin)())
@@ -174,6 +175,8 @@ def get_containers_df(only_passed=True) -> pd.DataFrame:
     @classmethod
     def get_api_list_by_container_id(cls, container_id
                                      ) -> List["BehaviorOphysLimsApi"]:
+        """Return a list of BehaviorOphysLimsApi instances for all
+        ophys experiments"""
         df = cls.get_ophys_experiment_df()
         container_selector = df['container_id'] == container_id
         oeid_list = df[container_selector]['ophys_experiment_id'].values