aplos-nca-saas-sdk 0.0.11__py3-none-any.whl → 0.0.13__py3-none-any.whl

aplos_nca_saas_sdk/nca_resources/nca_file_download.py

@@ -0,0 +1,130 @@
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
+
+import time
+from typing import Any, Dict, List
+from datetime import datetime, timedelta
+from aws_lambda_powertools import Logger
+from aplos_nca_saas_sdk.nca_resources._api_base import NCAApiBaseClass
+from aplos_nca_saas_sdk.nca_resources.aws_s3_presigned_upload import (
+    S3PresignedUrlUpload,
+)
+
+from aplos_nca_saas_sdk.utilities.http_utility import HttpUtilities
+import requests
+
+logger = Logger(service="nca-file-download")
+
+
+class NCAFileDownload(NCAApiBaseClass):
+    """NCA File Download"""
+
+    def __init__(self, host: str) -> None:
+        super().__init__(host)
+
+    def upload(
+        self,
+        input_file_path: str,
+        user_name: str | None = None,
+        password: str | None = None,
+    ) -> Dict[str, Any]:
+        """
+        Uploads a file to the Aplos NCA Cloud
+
+        Args:
+            input_file_path (str): local path to the file
+
+        Raises:
+            ValueError: _description_
+
+        Returns:
+            Dict: {"file_id": id, "statu_code": 204}
+        """
+        if input_file_path is None or not input_file_path:
+            raise ValueError("Valid input_file_path is required.")
+
+        if not self.authenticator.cognito.jwt:
+            if not user_name or not password:
+                raise ValueError(
+                    "Valid user_name and password are required or you can set the authenticator object."
+                )
+            self.authenticator.authenticate(username=user_name, password=password)
+
+        uploader: S3PresignedUrlUpload = S3PresignedUrlUpload(self.host)
+        uploader.authenticator = self.authenticator
+
+        upload_response: Dict[str, Any] = uploader.upload_file(
+            input_file=input_file_path
+        )
+
+        return upload_response
+
+    def download(
+        self,
+        file_id: str,
+        user_name: str | None = None,
+        password: str | None = None,
+    ) -> Dict[str, Any]:
+        """
+        Downloads a file from the Aplos NCA Cloud
+
+        Args:
+            file_id (str): the id of the file to download
+
+        Raises:
+            ValueError: _description_
+
+        Returns:
+            Dict: {"file_id": id, "statu_code": 204}
+        """
+
+        logger.info({"message": "Downloading file", "file_id": file_id})
+
+        file_info_endpoint = self.endpoints.file(
+            file_id,
+        )
+
+        if not self.authenticator.cognito.jwt:
+            if not user_name or not password:
+                raise ValueError(
+                    "Valid user_name and password are required or you can set the authenticator object."
+                )
+            self.authenticator.authenticate(username=user_name, password=password)
+
+        max_wait_in_minutes: int = 3
+        headers = HttpUtilities.get_headers(self.authenticator.cognito.jwt)
+        current_time = datetime.now()
+
+        # Create a timedelta object representing 3 minutes
+        time_delta = timedelta(minutes=max_wait_in_minutes)
+        # Add the timedelta to the current time
+        max_time = current_time + time_delta
+
+        complete = False
+        json_response: Dict[str, Any] = {}
+        while not complete:
+            response = requests.get(file_info_endpoint, headers=headers, timeout=60)
+            json_response: dict = response.json()
+            errors: List[Dict[str, Any]] = []
+            errors.extend(json_response.get("errors") or [])
+            status = json_response.get("workable_state")
+            complete = status == "ready"
+
+            if status == "invalid" or len(errors) > 0:
+                break
+            if complete:
+                break
+            if not complete:
+                time.sleep(5)
+            if datetime.now() > max_time:
+                error = (
+                    "Timeout attempting to get conversion file status. "
+                    f"The current timeout limit is {max_wait_in_minutes} minutes. "
+                    "You may need to up the timeout period, or check for errors. "
+                )
+                raise RuntimeError(error)
+
+        return json_response

aplos_nca_saas_sdk/nca_resources/nca_file_upload.py

@@ -1,41 +1,28 @@
 """
-Copyright 2024 Aplos Analytics
+Copyright 2024-2025 Aplos Analytics
 All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
 Property of Aplos Analytics, Utah, USA
 """
 
 from typing import Any, Dict
-from aplos_nca_saas_sdk.aws_resources.aws_s3_presigned_upload import S3PresignedUpload
-from aplos_nca_saas_sdk.nca_resources.nca_login import NCALogin
-from aplos_nca_saas_sdk.utilities.http_utility import HttpUtilities
+from aplos_nca_saas_sdk.nca_resources._api_base import NCAApiBaseClass
+from aplos_nca_saas_sdk.nca_resources.aws_s3_presigned_upload import (
+    S3PresignedUrlUpload,
+)
 
 
-class NCAFileUpload:
+class NCAFileUpload(NCAApiBaseClass):
     """NCA File Upload"""
 
-    def __init__(self, nca_login: NCALogin) -> None:
-        if nca_login is None or nca_login.jwt is None or not nca_login.jwt:
-            raise ValueError("Authenticated nca_login is required.")
+    def __init__(self, host: str) -> None:
+        super().__init__(host)
 
-        self.__api_domain: str = nca_login.domain
-        self.__tenant_id: str = nca_login.cognito.tenant_id
-        self.__user_id: str = nca_login.cognito.user_id
-        self.__jwt: str = nca_login.jwt
-
-    @property
-    def api_root(self) -> str:
-        """Gets the base url"""
-
-        if self.__api_domain is None:
-            raise RuntimeError("Missing Aplos Api Domain")
-
-        url = HttpUtilities.build_url(self.__api_domain)
-        if isinstance(url, str):
-            return f"{url}/tenants/{self.__tenant_id}/users/{self.__user_id}"
-
-        raise RuntimeError("Missing Aplos Api Domain")
-
-    def upload(self, input_file_path: str) -> Dict[str, Any]:
+    def upload(
+        self,
+        input_file_path: str,
+        user_name: str | None = None,
+        password: str | None = None,
+    ) -> Dict[str, Any]:
         """
         Uploads a file to the Aplos NCA Cloud
 
@@ -51,7 +38,18 @@ class NCAFileUpload:
         if input_file_path is None or not input_file_path:
             raise ValueError("Valid input_file_path is required.")
 
-        uploader: S3PresignedUpload = S3PresignedUpload(self.__jwt, str(self.api_root))
-        upload_response: Dict[str, Any] = uploader.upload_file(input_file_path)
+        if not self.authenticator.cognito.jwt:
+            if not user_name or not password:
+                raise ValueError(
+                    "Valid user_name and password are required or you can set the authenticator object."
+                )
+            self.authenticator.authenticate(username=user_name, password=password)
+
+        uploader: S3PresignedUrlUpload = S3PresignedUrlUpload(self.host)
+        uploader.authenticator = self.authenticator
+
+        upload_response: Dict[str, Any] = uploader.upload_file(
+            input_file=input_file_path
+        )
 
         return upload_response

aplos_nca_saas_sdk/nca_resources/nca_validations.py

@@ -0,0 +1,34 @@
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
+
+import requests
+
+from aplos_nca_saas_sdk.nca_resources._api_base import NCAApiBaseClass
+
+
+class NCAValidation(NCAApiBaseClass):
+    """NCA Analysis Validation API"""
+
+    def __init__(self, host: str) -> None:
+        super().__init__(host)
+
+    def validate(self, jwt: str) -> bool:
+        """
+        Validates the JWT
+
+        Args:
+            jwt (str): JWT
+
+        Returns:
+            bool: True if the JWT is valid
+        """
+        url = self.endpoints.validations
+        response = requests.post(url, json={"jwt": jwt}, timeout=30)
+
+        if response.status_code != 200:
+            return False
+
+        return True

aplos_nca_saas_sdk/run_analysis_execution.py

@@ -0,0 +1,148 @@
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
+
+import json
+import os
+from pathlib import Path
+
+from aws_lambda_powertools import Logger
+
+from aplos_nca_saas_sdk.nca_resources.nca_analysis import NCAAnalysis
+from aplos_nca_saas_sdk.utilities.commandline_args import CommandlineArgs
+
+logger = Logger()
+
+
+def main():
+    """Run Main when then file is run directly"""
+    try:
+        print("Welcome to the NCA Engine Upload & Execution Demo")
+        args = CommandlineArgs()
+        files_path = os.path.join(
+            Path(__file__).parent, "sample_files", "analysis_files", "single_ev"
+        )
+
+        # set up some defaults to make the demos quicker
+        args.analysis_file_default = os.path.join(files_path, "input.csv")
+        args.config_file_default = os.path.join(files_path, "config.json")
+        args.metadata_file_default = os.path.join(files_path, "meta_data.json")
+        args.output_directory_default = os.path.join(files_path, ".output")
+        if not args.is_valid():
+            print("\n\n")
+            print("Missing some arguments.")
+            exit()
+
+        analysis_api = NCAAnalysis(host=str(args.host))
+        analysis_api.verbose = True
+
+        print("\tLoading analysis configurations")
+        print(f"\t\t...{os.path.basename(args.config_file)}")
+        config_data: dict = read_json_file(str(args.config_file))
+
+        print("\tLoading analysis meta data")
+        print(f"\t\t...{os.path.basename(args.metadata_file)}")
+        meta_data = optional_json_loads(read_text_file(str(args.metadata_file)))
+
+        wait_for_results = True
+        max_wait_in_seconds = 900  # 15 minutes
+        resutls = analysis_api.execute(
+            username=str(args.username),
+            password=str(args.password),
+            input_file_path=str(args.analysis_file),
+            config_data=config_data,
+            meta_data=meta_data,
+            output_directory=str(args.output_directory),
+            wait_for_results=wait_for_results,
+            max_wait_in_seconds=max_wait_in_seconds,
+        )
+
+        if not wait_for_results:
+            exec_id = resutls.get("execution", {}).get("execution_id", "")
+            print(
+                "Analysis execution has been queued.  We're not waiting for the results."
+            )
+            print(f"Please check your results with execution id {exec_id}.")
+
+        print("🙌 Thank you for using the NCA API for an Analysis Execution Demo. 🙌")
+    except Exception as e:  # pylint: disable=w0718
+        print(
+            "🚨 An error occured ... exiting with an error.  Please check your settings and try again."
+        )
+        print(
+            "If you believe this is bug please create a support ticket and include the execution id (if available)."
+        )
+        print(
+            "If it's not reported in the error below check your account for the failed execution."
+        )
+
+        print(str(e))
+
+
+def optional_json_loads(data: str | dict) -> str | dict:
+    """
+    Attempts to load the data as json, fails gracefull and retuns the data is if it fails
+    Args:
+        data (str): data as string
+
+    Returns:
+        str | dict: either the data as is or a converted dictionary/json object
+    """
+    if isinstance(data, dict):
+        return data
+
+    try:
+        data = json.loads(str(data))
+    finally:
+        pass
+    return data
+
+
+def read_json_file(file_path: str) -> dict:
+    """
+    Reads a file and returns the json
+    Args:
+        file_path (str): _description_
+
+    Raises:
+        FileNotFoundError: _description_
+
+    Returns:
+        dict: _description_
+    """
+    if not os.path.exists(file_path):
+        raise FileNotFoundError(f"File Not Found: {file_path}")
+
+    data = None
+    with open(file_path, mode="r", encoding="utf8") as file:
+        data = json.load(file)
+
+    return data
+
+
+def read_text_file(file_path: str) -> str:
+    """
+    Read files contents
+    Args:
+        file_path (str): path to the file
+
+    Raises:
+        FileNotFoundError: if the file is not found
+
+    Returns:
+        str: the files data
+    """
+    if not os.path.exists(file_path):
+        raise FileNotFoundError(f"File Not Found: {file_path}")
+
+    data = None
+    with open(file_path, mode="r", encoding="utf8") as file:
+        data = file.read()
+
+    return data
+
+
+if __name__ == "__main__":
+    main()

aplos_nca_saas_sdk/utilities/commandline_args.py

@@ -1,17 +1,27 @@
-import os
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
+
 import argparse
 import getpass
+import os
 from pathlib import Path
 from typing import List
-from aplos_nca_saas_sdk.utilities.environment_vars import EnvironmentVars
+
 from dotenv import load_dotenv
 
+from aplos_nca_saas_sdk.utilities.environment_vars import EnvironmentVars
+
 # load the environment (.env) file if any
 # this may or may not be the desired results
 load_dotenv(override=True)
 
 
 class CommandlineArgs:
+    """Wrapper fro commandline args"""
+
     def __init__(self) -> None:
         # command line args
         self.parser = argparse.ArgumentParser(
@@ -35,19 +45,17 @@ class CommandlineArgs:
             "-m", "--metadata-file", required=False, help="Path to the metadata file"
         )
 
-        self.parser.add_argument("-a", "--api-url", required=False, help="The api url")
         self.parser.add_argument(
-            "-i", "--client-id", required=False, help="The client id to cognito"
+            "-d",
+            "--host",
+            required=False,
+            help="The api host/host. Eg. api.aplos-nca.com, api.tenant.aplos-nca.com",
         )
 
         self.parser.add_argument(
             "-v", "--verbose", required=False, help="Detailed logging information"
         )
 
-        self.parser.add_argument(
-            "-r", "--region", required=False, help="AWS Region. For Cognito Login"
-        )
-
         self.parser.add_argument(
             "-s",
             "--skip",
@@ -69,12 +77,12 @@ class CommandlineArgs:
             help="The full path to an environment file (.env file).",
         )
 
+        # auth information
         self.username: str | None = None
         self.password: str | None = None
-        self.api_domain: str | None = None
-        self.cognito_client_id: str | None = None
-        self.aws_region: str | None = None
+        self.host: str | None = None
 
+        # excuction setup
         self.config_file: str | None = None
         self.config_file_default: str | None = None
         self.analysis_file: str | None = None
@@ -102,9 +110,8 @@ class CommandlineArgs:
         self.config_file = args.config_file
         # anything with a dash (in the args) is accessed with an underscore
         self.analysis_file = args.analyis_file
-        self.api_domain = args.api_domain
-        self.cognito_client_id = args.client_id
-        self.aws_region = args.region
+        self.host = args.host
+
         self.metadata_file = args.metadata_file
         self.skip = args.skip
         self.output_directory = args.output_directory
@@ -128,24 +135,12 @@ class CommandlineArgs:
                 self.password = self.prompt_for_input(
                     "password", env.password, is_sensitive=True
                 )
-        if not self.aws_region:
-            if self.skip and env.aws_region:
-                self.aws_region = env.aws_region
-            else:
-                self.aws_region = self.prompt_for_input("AWS Region", env.aws_region)
-        if not self.api_domain:
-            if self.skip and env.api_domain:
-                self.api_domain = env.api_domain
-            else:
-                self.api_domain = self.prompt_for_input("Api Domain", env.api_domain)
 
-        if not self.cognito_client_id:
-            if self.skip and env.client_id:
-                self.cognito_client_id = env.client_id
+        if not self.host:
+            if self.skip and env.host:
+                self.host = env.host
             else:
-                self.cognito_client_id = self.prompt_for_input(
-                    "Cognito Client Id", env.client_id
-                )
+                self.host = self.prompt_for_input("Api Domain", env.host)
 
         if not self.analysis_file:
             if self.skip and self.analysis_file_default or env.analysis_file:
@@ -196,11 +191,9 @@ class CommandlineArgs:
         required_fields = [
             self.username,
             self.password,
-            self.aws_region,
-            self.cognito_client_id,
             self.analysis_file,
             self.config_file,
-            self.api_domain,
+            self.host,
         ]
         for field in required_fields:
             if not field:
@@ -314,15 +307,16 @@ def main():
         pwd = "************" if args.password else "empty"
         print(f"username = {args.username}")
         print(f"password = {pwd}")
-        print(f"aws_region = {args.aws_region}")
-        print(f"api_domain = {args.api_domain}")
-        print(f"cognito_client_id = {args.cognito_client_id}")
+
+        print(f"host = {args.host}")
+        print(f"analysis_file = {args.analysis_file}")
+
         print(f"config_file = {args.config_file}")
         print(f"metadata_file = {args.metadata_file}")
-        print(f"analysis_file = {args.analysis_file}")
+
         print(f"output_directory = {args.output_directory}")
 
-        print("were good to go")
+        print("✅ All required parameters are accounted for.")
 
     else:
         print("Missing some required fields.")

aplos_nca_saas_sdk/utilities/environment_services.py

@@ -1,6 +1,7 @@
 """
-Aplos Analytics
-
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
 """
 
 import os

aplos_nca_saas_sdk/utilities/environment_vars.py

@@ -1,3 +1,9 @@
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
+
 import os
 
 
@@ -6,7 +12,7 @@ class EnvironmentVars:
 
     def __init__(self) -> None:
         # load defaults
-        self.api_domain = os.getenv("APLOS_API_DOMAIN", "")
+        self.host = os.getenv("APLOS_host", "")
 
         self.aws_region = os.getenv("COGNITO_REGION")
         self.client_id = os.getenv("COGNITO_CLIENT_ID")
@@ -17,7 +23,14 @@ class EnvironmentVars:
         self.metadata_file = os.getenv("METADATA_FILE")
         self.analysis_file = os.getenv("ANALYSIS_FILE")
 
-        if self.api_domain is not None and "https://" in self.api_domain:
-            self.api_domain = self.api_domain.replace("https://", "")
+        if self.host is not None and "https://" in self.host:
+            self.host = self.host.replace("https://", "")
+
+        self.aplos_api_url = f"https://{self.host}"
 
-        self.aplos_api_url = f"https://{self.api_domain}"
+    @staticmethod
+    def is_running_in_aws_lambda():
+        """
+        A quick way to check if we are running in an AWS Lambda Environment
+        """
+        return "AWS_LAMBDA_FUNCTION_NAME" in os.environ

aplos_nca_saas_sdk/utilities/file_utility.py

@@ -0,0 +1,33 @@
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
+
+import os
+
+
+from aplos_nca_saas_sdk.utilities.environment_services import EnvironmentServices
+
+
+class FileUtility:
+    """General File Utilities"""
+
+    @staticmethod
+    def load_filepath(file_path: str) -> str:
+        """Load the file_path"""
+        if not file_path:
+            raise RuntimeError("file_path is required")
+        elif file_path.startswith("${module}"):
+            # find the path
+            es: EnvironmentServices = EnvironmentServices()
+            root = es.find_module_path()
+            if not root:
+                raise RuntimeError(
+                    "Unable to find the module path.  Please use the ${module} syntax to define the file path"
+                )
+            file_path = file_path.replace("${module}", root)
+
+        # get the correct os path separator
+        file_path = os.path.normpath(file_path)
+        return file_path

aplos_nca_saas_sdk/utilities/http_utility.py

@@ -1,22 +1,13 @@
-class Routes:
-    """NCA Saas Routes"""
-
-    NCA_EXECUTIONS = "nca/executions"
-    NCA_GENERATE_UPLOAD = "nca/files"
+"""
+Copyright 2024-2025 Aplos Analytics
+All Rights Reserved.   www.aplosanalytics.com   LICENSED MATERIALS
+Property of Aplos Analytics, Utah, USA
+"""
 
 
 class HttpUtilities:
     """Http Utilties"""
 
-    @staticmethod
-    def build_url(domain_name: str) -> str:
-        """Build the url"""
-        domain_name = domain_name.strip()
-        if domain_name.startswith("http"):
-            return domain_name
-        else:
-            return f"https://{domain_name}"
-
     @staticmethod
     def get_headers(jwt: str) -> dict:
         """Get the Http Headers"""

aplos_nca_saas_sdk/version.py

@@ -1,4 +1,4 @@
 # Aplos NCA SaaS SDK Version File
 # This is automatically generated during the build process. 
 # DO NOT UPDATE IT DIRECTLY. IT WILL BE OVERWRITTEN. 
-__version__ = '0.0.11'
+__version__ = '0.0.13'

{aplos_nca_saas_sdk-0.0.11.dist-info → aplos_nca_saas_sdk-0.0.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aplos_nca_saas_sdk
-Version: 0.0.11
+Version: 0.0.13
 Summary: Aplos NCA SaaS SDK
 Project-URL: Homepage, https://aplosanalytics.com/
 Project-URL: Documentation, https://docs.aplosanalytics.com/