quapp-common 0.0.13.dev2__tar.gz → 0.0.13.dev4__tar.gz

{quapp_common-0.0.13.dev2/quapp_common.egg-info → quapp_common-0.0.13.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quapp-common
-Version: 0.0.13.dev2
+Version: 0.0.13.dev4
 Summary: Quapp common library supporting Quapp Platform for Quantum Computing
 Author-email: "CITYNOW Co. Ltd. " <corp@citynow.vn>
 License: The MIT License (MIT)

{quapp_common-0.0.13.dev2 → quapp_common-0.0.13.dev4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quapp-common"
-version = "0.0.13.dev2"
+version = "0.0.13.dev4"
 description = "Quapp common library supporting Quapp Platform for Quantum Computing"
 readme = "README.md"
 authors = [{ name = "CITYNOW Co. Ltd. ", email = "corp@citynow.vn" }]

{quapp_common-0.0.13.dev2 → quapp_common-0.0.13.dev4}/quapp_common/enum/provider_tag.py

@@ -16,6 +16,7 @@ class ProviderTag(BaseEnum):
     AZURE_QUANTUM = 'AZURE_QUANTUM'
     RIKEN = 'RIKEN'
     QUAPP_HPC = 'QUAPP_HPC'
+    QUANDELA = 'QUANDELA'
 
     @staticmethod
     def resolve(provider_tag: str):

{quapp_common-0.0.13.dev2 → quapp_common-0.0.13.dev4}/quapp_common/enum/sdk.py

@@ -17,6 +17,7 @@ class Sdk(BaseEnum):
     QIBO = "qibo"
     QULACS = "qulacs"
     QUANTUM_HPC = "quantum hpc"
+    PERCEVAL = "perceval"
 
     @staticmethod
     def resolve(sdk: str):

{quapp_common-0.0.13.dev2 → quapp_common-0.0.13.dev4}/quapp_common/util/response_utils.py

@@ -2,6 +2,9 @@
 #  response_utils.py
 #  Copyright © CITYNOW Co. Ltd. All rights reserved.
 
+import json
+from typing import Optional
+
 from .http_utils import CUSTOM_HEADER_VALUE
 from ..component.backend.job_fetcher import JobFetcher
 from ..data.promise.post_processing_promise import PostProcessingPromise
@@ -97,6 +100,33 @@ def build_done_job_response(fetcher: JobFetcher = None,
             status_code=StatusCode.DONE)
 
 
+def _humanize_exception(exception: Exception) -> Optional[str]:
+    """
+    Return a short, user-friendly explanation for common input-related
+    exceptions raised by a function handler, or None when there is no
+    friendlier form.
+
+    Rationale: the raw ``str`` of some exceptions is cryptic for end users --
+    most notably ``KeyError``, whose ``str`` is just the repr of the missing
+    key (e.g. ``str(KeyError('Q'))`` -> ``"'Q'"``). Classifying the common
+    cases lets us surface an actionable, plain-language message instead. Full
+    technical detail (traceback, step, exception type) stays in the function
+    logs -- it is not surfaced to the end user here.
+    """
+    if isinstance(exception, KeyError):
+        # KeyError.args[0] is the missing key itself (not quoted).
+        key = exception.args[0] if exception.args else exception
+        return f"Missing required input field: '{key}'."
+
+    if isinstance(exception, json.JSONDecodeError):
+        return "Input is not valid JSON."
+
+    if isinstance(exception, IndexError):
+        return "An input field has fewer items than expected."
+
+    return None
+
+
 def build_error_job_response(exception: Exception,
                              job_response: JobResponse = None,
                              fetcher: JobFetcher = None,
@@ -148,8 +178,19 @@ def build_error_job_response(exception: Exception,
                                                  post_promise)
     job_response.status_code = StatusCode.ERROR
     job_response.job_status = JobStatus.ERROR.value
-    job_response.job_result = {'message'  : message or 'Unknown error occurred.',
-                               'exception': str(exception)}
+
+    # User-facing message: plain language, no internal jargon / step names.
+    # Full technical detail (traceback, step, exception type) is emitted to the
+    # function logs via logger.exception(exc_info=True) at each call site, where
+    # the dev team can inspect it -- it does NOT belong in the user response.
+    # The `message` argument (internal step label like "Error when prepare
+    # circuit") is intentionally NOT surfaced to the user.
+    hint = _humanize_exception(exception)
+    job_response.job_result = {
+        'message'  : hint or 'The function raised an error while running. '
+                             'Please check the function logs for details.',
+        'exception': str(exception),
+    }
     return job_response
 
 

{quapp_common-0.0.13.dev2 → quapp_common-0.0.13.dev4/quapp_common.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quapp-common
-Version: 0.0.13.dev2
+Version: 0.0.13.dev4
 Summary: Quapp common library supporting Quapp Platform for Quantum Computing
 Author-email: "CITYNOW Co. Ltd. " <corp@citynow.vn>
 License: The MIT License (MIT)