hdforce 1.0.0__py3-none-any.whl

hdforce/AuthManager.py

@@ -0,0 +1,170 @@
+import os
+from dotenv import load_dotenv, set_key
+# Package imports
+from .LoggerConfig import LoggerConfig
+from .utils import TokenManager, varsManager, ConfigManager
+
+# Get a logger specific to this module
+logger = LoggerConfig.get_logger(__name__)
+
+# -------------------- #
+# Authenticator
+
+
+def AuthManager(authMethod: str = "env", refreshToken_name: str = "HD_REFRESH_TOKEN", refreshToken: str = None, env_file_name: str = None, region: str = "Americas") -> None:
+    """ Choose the authentication settings
+
+
+    Parameters
+    ----------
+    region : str required
+        The region that designates the url prefix.
+
+    authMethod : str required
+        Determine method of storing authentication variables, including refresh token. One of 'env', 'file', 'manual'. env = use of system environment. file = use of .env file. manual = no stored refresh token.
+
+    refreshToken_name : str
+        Specific name of refresh token variable saved in system environment or .env file
+
+    refreshToken : str
+        If used with authMethod='manual', token will be used to authenticate without being stored. Else token will be used set as the new refresh token value with method selected.
+
+    env_file_name : str
+        Required with authMethod='file'. Provides file name for variable storage.
+
+
+    Raises
+    ------
+    ValueError
+        If authMethod not one of env, file, or method.
+        If authMethod = 'file' and no file name provided
+        If authMethod='manual' and no refreshToken provided
+
+    """
+    # auth method options
+    methods = ['env', 'file', 'manual']
+
+    # Check for valid method choice
+    if authMethod not in methods:
+        logger.error(f"{authMethod} is invalid authentication method.")
+        raise ValueError(f"Invalid auth method. Allowed methods are: {methods}")
+    else:
+        logger.debug(f"Authentication method selected: {authMethod}.")
+
+    # Load environment file if necessary
+    if authMethod == 'file':
+        if env_file_name:
+            load_dotenv(str(env_file_name), override=True)
+            logger.debug(f"Environment variables loaded from {env_file_name}.")
+        else:
+            logger.error("No file name given")
+            raise ValueError("No file name given. Must be provided with authMethod='file'")
+
+    # Retrieve or set the refresh token
+    if authMethod == 'manual':
+        if refreshToken is None:
+            logger.error("No refresh token found given")
+            raise ValueError("Refresh token must be provided with 'manual' authentication method.")
+        else:
+            key = refreshToken
+            kabrv = key[0:6]
+            #logger.debug(f"Manual auth method used with token {kabrv}xxxx")
+    else:
+        key = varsManager(name=refreshToken_name, value=refreshToken, method=authMethod, file=env_file_name)
+        kabrv = key[0:6]
+        logger.debug(f"Refresh token: {kabrv}xxxx method: {authMethod}")
+
+    # Setup session assuming TokenManager handles authentication
+    session = TokenManager(refreshToken=key, region=region, fileName=env_file_name)
+
+    # Create objects of classes
+    accessToken = str(session.accessToken)
+    tokenExpiration = str(session.ExpirationVal)
+    expirationStr = str(session.ExpirationStr)
+    cloudURL = str(session.url_cloud)
+    fileName = str(session.fileName)
+
+    if authMethod == 'file':
+        load_dotenv(str(fileName), override=True)
+
+        # Set environment variables
+        set_key(fileName, "ACCESS_TOKEN", accessToken)
+        # Environment variable debugging: Access Token
+        if accessToken == os.getenv("ACCESS_TOKEN"):
+            logger.debug(f"New Access Token Set")
+        else:
+            logger.debug(f"Error: new token not found")
+
+        # Environment variable debugging: Token Expiration
+        set_key(fileName, "TOKEN_EXPIRATION", tokenExpiration)
+        if tokenExpiration == os.getenv("TOKEN_EXPIRATION"):
+            logger.debug(f"New expiration Set")
+        else:
+            logger.debug(f"Error: new expiration not passed")
+
+        # Environment variable debugging: Cloud URL
+        set_key(fileName, "CLOUD_URL", cloudURL)
+        if cloudURL == os.getenv("CLOUD_URL"):
+            logger.debug(f"New URL set")
+        else:
+            logger.debug(f"Error: new URL not passed")
+
+    else:
+        # Environment variable debugging: Access Token
+        os.environ['ACCESS_TOKEN'] = accessToken
+        if accessToken == os.getenv("ACCESS_TOKEN"):
+            logger.debug(f"New Access Token Set")
+        else:
+            logger.debug(f"Error: new token not found")
+
+        # Environment variable debugging: Token Expiration
+        os.environ['TOKEN_EXPIRATION'] = tokenExpiration
+        if tokenExpiration == os.getenv("TOKEN_EXPIRATION"):
+            logger.debug(f"New expiration Set")
+        else:
+            logger.debug(f"Error: new expiration not passed")
+
+        # Environment variable debugging: Cloud URL
+        os.environ['CLOUD_URL'] = cloudURL
+        if cloudURL == os.getenv("CLOUD_URL"):
+            logger.debug(f"New URL set")
+        else:
+            logger.debug(f"Error: new URL not passed")
+
+    # Set environment source in ConfigManager based on authMethod
+    if authMethod == 'file':
+        # Check if filename passed
+        if not isinstance(fileName, str):
+            logger.error("File path must be provided when source is 'file'")
+            raise ValueError("File path must be provided when source is 'file'")
+        # if filename exists and string initialize dotenv
+        load_dotenv(str(fileName), override=True)
+        # run configuration manager
+        ConfigManager.set_env_source(region=region, method=authMethod, fileName=fileName, token_name=refreshToken_name, token=key)
+        logger.debug(f"ConfigManager methods passed with file env: {fileName}")
+
+    # Using environment variables
+    elif authMethod == 'env' or 'manual':
+        # run configuration manager
+        ConfigManager.set_env_source(region=region, method=authMethod, fileName=fileName, token_name=refreshToken_name, token=key)
+        logger.debug(f"ConfigManager methods passed with {authMethod} method")
+
+    # Alert of missing variables
+    else:
+        # List to hold the names of empty variables
+        empty_variables = []
+
+        # Check each variable and add the name to the list if it is empty
+        if not accessToken:
+            empty_variables.append("Access Token")
+        if not tokenExpiration:
+            empty_variables.append("token Expiration")
+        if not cloudURL:
+            empty_variables.append("Cloud URL")
+
+        # Create a message based on which variables are empty
+        if empty_variables:
+            # Join the names of the empty variables into a comma-separated string
+            empty_vars_str = ", ".join(empty_variables)
+            logger.error(f"Missing variables: {empty_vars_str}.")
+            raise ValueError(f"The following variables are empty: {empty_vars_str}.")

hdforce/GetAthletes.py

@@ -0,0 +1,124 @@
+# Dependencies -----
+import requests
+import os
+import datetime
+import pandas as pd
+# Package imports
+from .AuthManager import AuthManager
+from .utils import ConfigManager
+from .LoggerConfig import LoggerConfig
+
+# Get a logger specific to this module
+logger = LoggerConfig.get_logger(__name__)
+
+# -------------------- #
+# Get Athletes
+
+
+def GetAthletes(inactive: bool = False) -> pd.DataFrame:
+    """Get the athlete information from an account.
+
+    Parameters
+    ----------
+    inactive : bool, optional
+        A boolean that specifies whether to include inactive athletes in the results. Default is False, meaning by default inactive athletes are not included.
+
+    Returns
+    -------
+    pd.DataFrame
+        A Pandas DataFrame containing the athletes' information, with columns:
+        - id: Athlete's unique identifier.
+        - names: Athlete's given full name.
+        - teams: A nested list of athlete's team ids as strings.
+        - groups: A nested list of athlete's group ids as strings.
+        - active: Boolean indicating if the athlete's profile is active (not archived).
+        - external: Columns dynamically created for each external attribute associated with the athletes. (example = external.ExternalId: value)
+
+    Raises
+    ------
+    Exception
+        If the HTTP response status is not 200, indicating an unsuccessful API request, or if there is a failure in parsing the JSON response.
+    """
+    # Retrieve Access Token and check expiration
+    a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+    tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+    logger.debug(f"Access Token retrieved. expires {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # get current time in timestamp
+    now = datetime.datetime.now()
+    nowtime = datetime.datetime.timestamp(now)
+    if nowtime < tokenExp:
+        logger.debug(f"Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # Validate refresh token and expiration
+    if a_token is None:
+        logger.error("No Access Token found.")
+        raise Exception("No Access Token found.")
+    elif int(nowtime) >= tokenExp:
+        logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+        # authenticate
+        try:
+            AuthManager(
+                region=ConfigManager.region,
+                authMethod=ConfigManager.env_method,
+                refreshToken_name=ConfigManager.token_name,
+                refreshToken=ConfigManager.refresh_token,
+                env_file_name=ConfigManager.file_name
+            )
+            # Retrieve Access Token and check expiration
+            a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+            logger.debug("New ACCESS_TOKEN retrieved")
+            tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+            logger.debug("TOKEN_EXPIRATION retrieved")
+            if a_token is None:
+                logger.error("No Access Token found.")
+                raise Exception("No Access Token found.")
+            elif int(nowtime) >= tokenExp:
+                logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+                raise Exception("Token expired")
+            else:
+                logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+                pass
+        except ValueError:
+            logger.error("Failed to authenticate. Try AuthManager")
+            raise Exception("Failed to authenticate. Try AuthManage")
+    else:
+        logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # API Cloud URL
+    url_cloud = os.getenv("CLOUD_URL")
+
+    # Create URL for request
+    url = f"{url_cloud}/athletes?inactive={inactive}"
+
+    # GET Request
+    headers = {"Authorization": f"Bearer {a_token}"}
+
+    # Create Response
+    response = requests.get(url, headers=headers)
+    if inactive:
+        logger.debug("GET Request: Athletes (inactive = true)")
+    else:
+        logger.debug("GET Request: Athletes (inactive = false)")
+
+    # Response Handling
+    # If Error show error
+    if response.status_code != 200:
+        logger.error(f"Error {response.status_code}: {response.reason}")
+        raise Exception(f"Error {response.status_code}: {response.reason}")
+
+    # If successful
+    try:
+        data = response.json()['data']
+        df = pd.json_normalize(data, meta=['count'], errors='ignore')
+
+        # Setting attributes
+        df.attrs['Count'] = int(len(df.index))
+        count = str(len(df.index))
+        logger.info(f"Request successful. Athletes returned: {count}")
+        return df
+
+    # Bad parse or none returned
+    except ValueError:
+        logger.error("Failed to parse JSON response or no data returned.")
+        raise Exception("Failed to parse JSON response or no data returned.")

hdforce/GetForceTime.py

@@ -0,0 +1,140 @@
+# Dependencies -----
+import requests
+import pandas as pd
+import os
+import datetime
+# Package imports
+from .utils import logger, ConfigManager
+from .AuthManager import AuthManager
+
+# -------------------- #
+# Get Force Time
+
+
+def GetForceTime(testId: str) -> pd.DataFrame:
+    """Get force-time data for an individual test trial from an account.
+
+    Parameters
+    ----------
+    testId : str
+        The unique ID given to each test trial.
+
+    Returns
+    -------
+    pd.DataFrame
+        A Pandas DataFrame containing details of the test trial, with columns:
+        - Time (s): Time elapsed in seconds.
+        - LeftForce (N): Force at time point from left plate.
+        - RightForce (N): Force at time point from right plate.
+        - CombinedForce (N): Combined force (Left + Right) at each time point.
+        - Velocity (m/s): Calculated center of mass velocity at each time point.
+        - Displacement (m): Calculated center of mass displacement from starting height at each time point.
+        - Power (W): Calculated power of mass at each time point.
+        - RSI: Calculated Reactive Strength Index (if applicable).
+
+    Raises
+    ------
+    Exception
+        If the HTTP response status is not 200, indicating an unsuccessful API request,
+        or if there is a failure in parsing the JSON response.
+    ValueError
+        If the 'testId' parameter is not a string.
+    """
+    # Retrieve Access Token and check expiration
+    a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+    tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+    logger.debug(f"Access Token retrieved. expires {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # get current time in timestamp
+    now = datetime.datetime.now()
+    nowtime = datetime.datetime.timestamp(now)
+    if nowtime < tokenExp:
+        logger.debug(f"Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # Validate refresh token and expiration
+    if a_token is None:
+        logger.error("No Access Token found.")
+        raise Exception("No Access Token found.")
+    elif int(nowtime) >= tokenExp:
+        logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+        # authenticate
+        try:
+            AuthManager(
+                region=ConfigManager.region,
+                authMethod=ConfigManager.env_method,
+                refreshToken_name=ConfigManager.token_name,
+                refreshToken=ConfigManager.refresh_token,
+                env_file_name=ConfigManager.file_name
+            )
+            # Retrieve Access Token and check expiration
+            a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+            logger.debug("New ACCESS_TOKEN retrieved")
+            tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+            logger.debug("TOKEN_EXPIRATION retrieved")
+            if a_token is None:
+                logger.error("No Access Token found.")
+                raise Exception("No Access Token found.")
+            elif int(nowtime) >= tokenExp:
+                logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+                raise Exception("Token expired")
+            else:
+                logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+                pass
+        except ValueError:
+            logger.error("Failed to authenticate. Try AuthManager")
+            raise Exception("Failed to authenticate. Try AuthManage")
+    else:
+        logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # API Cloud URL
+    url_cloud = os.getenv("CLOUD_URL")
+
+    # Test ID
+    if isinstance(testId, str):
+        tid = testId
+    else:
+        logger.error("TestId must be a string")
+        raise Exception("Error: TestId must be a string")
+
+    # Create URL for request
+    url = f"{url_cloud}/forcetime/{tid}"
+
+    # GET Request
+    headers = {"Authorization": f"Bearer {a_token}"}
+    response = requests.get(url, headers=headers)
+    logger.debug(f"GET Force-Time data for test: {tid}")
+
+    # Check response status and handle data accordingly
+    if response.status_code != 200:
+        logger.error(f"Error {response.status_code}: {response.reason}")
+        raise Exception(f"Error {response.status_code}: {response.reason}")
+
+    try:
+        # Flatten test data from response
+        data = response.json()
+
+        # Create DataFrame from the array data
+        df = pd.DataFrame({
+            "Time(s)": data["Time(s)"],
+            "LeftForce(N)": data["LeftForce(N)"],
+            "RightForce(N)": data["RightForce(N)"],
+            "CombinedForce(N)": data["CombinedForce(N)"],
+            "Velocity(m/s)": data["Velocity(m/s)"],
+            "Displacement(m)": data["Displacement(m)"],
+            "Power(W)": data["Power(W)"],
+            "rsi": [data["rsi"]] * len(data["Time(s)"])  # Assuming rsi is a constant value
+        })
+
+        # Setting attributes
+        df.attrs['Test ID'] = data['id']
+        df.attrs['Test Name'] = data['testType']['name']
+        df.attrs['Athlete Name'] = data['athlete']['name']
+        df.attrs['Athlete ID'] = data['athlete']['id']
+        df.attrs['Timestamp'] = pd.to_datetime(data['timestamp'], unit='s')
+        df.attrs['RSI'] = data['rsi']
+        logger.info(f"Request successful: {df.attrs['Test Name']} - {df.attrs['Test ID']} - {df.attrs['Timestamp']}")
+        return df
+
+    except ValueError:
+        logger.error("Failed to parse JSON response or no data returned.")
+        raise Exception("Failed to parse JSON response or no data returned.")

hdforce/GetGroups.py

@@ -0,0 +1,107 @@
+# Dependencies -----
+import requests
+import os
+import datetime
+import pandas as pd
+# Package imports
+from .utils import logger, ConfigManager
+from .AuthManager import AuthManager
+
+# -------------------- #
+# Get Groups -----
+
+
+def GetGroups() -> pd.DataFrame:
+    """Get group for an account. This function is designed to retrieve all groups within your organization.
+
+    Returns
+    -------
+    pd.DataFrame
+        A Pandas DataFrame containing the groups' information, with columns:
+        - id: Group's unique identifier.
+        - name: Group's name.
+
+    Raises
+    ------
+    Exception
+        If the HTTP response status is not 200, indicating an unsuccessful API request, or if there is a failure in parsing the JSON response.
+    """
+    # Retrieve Access Token and check expiration
+    a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+    tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+    logger.debug(f"Access Token retrieved. expires {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # get current time in timestamp
+    now = datetime.datetime.now()
+    nowtime = datetime.datetime.timestamp(now)
+    if nowtime < tokenExp:
+        logger.debug(f"Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # Validate refresh token and expiration
+    if a_token is None:
+        logger.error("No Access Token found.")
+        raise Exception("No Access Token found.")
+    elif int(nowtime) >= tokenExp:
+        logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+        # authenticate
+        try:
+            AuthManager(
+                region=ConfigManager.region,
+                authMethod=ConfigManager.env_method,
+                refreshToken_name=ConfigManager.token_name,
+                refreshToken=ConfigManager.refresh_token,
+                env_file_name=ConfigManager.file_name
+            )
+            # Retrieve Access Token and check expiration
+            a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+            logger.debug("New ACCESS_TOKEN retrieved")
+            tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+            logger.debug("TOKEN_EXPIRATION retrieved")
+            if a_token is None:
+                logger.error("No Access Token found.")
+                raise Exception("No Access Token found.")
+            elif int(nowtime) >= tokenExp:
+                logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+                raise Exception("Token expired")
+            else:
+                logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+                pass
+        except ValueError:
+            logger.error("Failed to authenticate. Try AuthManager")
+            raise Exception("Failed to authenticate. Try AuthManage")
+    else:
+        logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # API Cloud URL
+    url_cloud = os.getenv("CLOUD_URL")
+
+    # Create URL for request
+    url = f"{url_cloud}/groups"
+
+    # GET Request
+    headers = {"Authorization": f"Bearer {a_token}"}
+
+    # Create Response
+    response = requests.get(url, headers=headers)
+    logger.debug("GET Request: Groups")
+
+    # Response Handling
+    # If Error show error
+    if response.status_code != 200:
+        logger.error(f"Error {response.status_code}: {response.reason}")
+        raise Exception(f"Error {response.status_code}: {response.reason}")
+
+    # If successful
+    try:
+        # Flatten test data from response
+        data = response.json()
+        df = pd.json_normalize(data['data'], meta=['count'], errors='ignore')
+
+        df.attrs['Count'] = int(len(df.index))
+        count = str(len(df.index))
+        logger.info(f"Request successful. Groups returned: {count}")
+        return df
+
+    except ValueError:
+        logger.error("Failed to parse JSON response or no data returned.")
+        raise Exception("Failed to parse JSON response or no data returned.")

hdforce/GetMetrics.py

@@ -0,0 +1,118 @@
+# Dependencies -----
+import requests
+import os
+import datetime
+import pandas as pd
+# Package imports
+from .utils import logger, ConfigManager
+from .AuthManager import AuthManager
+
+# ----------------- #
+# Get Metrics
+
+
+def GetMetrics() -> pd.DataFrame:
+    """
+    Get the metrics and ids for all the metrics in the system
+
+    Returns
+    -------
+    pd.DataFrame
+        A Pandas DataFrame containing the test metrics, with columns:
+        - canonicalTestTypeId: The unique identifier for each test type.
+        - testTypeName: The name of each metric.
+        - id: The unique identifier for each metric.
+        - label: The label (common name) for each metric
+        - units: Units of measure
+        - description: Full description of metric and calculation*
+
+    Raises
+    ------
+    Exception
+        If the HTTP response status is not 200, indicating an unsuccessful API request, or if there is a failure in parsing the JSON response.
+    """
+    # Retrieve Access Token and check expiration
+    a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+    tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+    logger.debug(f"Access Token retrieved. expires {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # get current time in timestamp
+    now = datetime.datetime.now()
+    nowtime = datetime.datetime.timestamp(now)
+    if nowtime < tokenExp:
+        logger.debug(f"Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # Validate refresh token and expiration
+    if a_token is None:
+        logger.error("No Access Token found.")
+        raise Exception("No Access Token found.")
+    elif int(nowtime) >= tokenExp:
+        logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+        # authenticate
+        try:
+            AuthManager(
+                region=ConfigManager.region,
+                authMethod=ConfigManager.env_method,
+                refreshToken_name=ConfigManager.token_name,
+                refreshToken=ConfigManager.refresh_token,
+                env_file_name=ConfigManager.file_name
+            )
+            # Retrieve Access Token and check expiration
+            a_token = ConfigManager.get_env_variable("ACCESS_TOKEN")
+            logger.debug("New ACCESS_TOKEN retrieved")
+            tokenExp = int(ConfigManager.get_env_variable("TOKEN_EXPIRATION"))
+            logger.debug("TOKEN_EXPIRATION retrieved")
+            if a_token is None:
+                logger.error("No Access Token found.")
+                raise Exception("No Access Token found.")
+            elif int(nowtime) >= tokenExp:
+                logger.debug(f"Token Expired: {datetime.datetime.fromtimestamp(tokenExp)}")
+                raise Exception("Token expired")
+            else:
+                logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+                pass
+        except ValueError:
+            logger.error("Failed to authenticate. Try AuthManager")
+            raise Exception("Failed to authenticate. Try AuthManage")
+    else:
+        logger.debug(f"New Access Token valid through: {datetime.datetime.fromtimestamp(tokenExp)}")
+
+    # API Cloud URL
+    url_cloud = os.getenv("CLOUD_URL")
+
+    # Create URL for request
+    url = f"{url_cloud}/metrics" 
+
+    # GET Request
+    headers = {"Authorization": f"Bearer {a_token}"}
+
+    # Create Response
+    response = requests.get(url, headers=headers)
+    logger.debug("GET Request: Metrics.")
+
+    # Response Handling
+    # If Error show error
+    if response.status_code != 200:
+        logger.error(f"Error {response.status_code}: {response.reason}")
+        raise Exception(f"Error {response.status_code}: {response.reason}")
+    
+    # If successful
+    try:
+        # Flatten test data from response
+        data = response.json()
+        # Create DataFrame from JSON
+        df = pd.DataFrame(data)
+        # Explode 'metrics' column to expand each list element into a row
+        df = df.explode('metrics')
+        # Normalize 'metrics' column
+        metrics_df = pd.json_normalize(df['metrics'])
+        # Concatenate the original DataFrame with the normalized metrics DataFrame
+        result_df = pd.concat([df.drop('metrics', axis=1).reset_index(drop=True), metrics_df], axis=1)
+
+        result_df.attrs['Count'] = int(len(result_df))
+        logger.info("Request for Metrics successful")
+        return result_df
+
+    except ValueError:
+        logger.error("Failed to parse JSON response or no data returned")
+        raise Exception("Failed to parse JSON response or no data returned.")