pveagle 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

pveagle/_eagle.py

@@ -16,7 +16,27 @@ from typing import Sequence, Tuple
 
 
 class EagleError(Exception):
-    pass
+    def __init__(self, message: str = '', message_stack: Sequence[str] = None):
+        super().__init__(message)
+
+        self._message = message
+        self._message_stack = list() if message_stack is None else message_stack
+
+    def __str__(self):
+        message = self._message
+        if len(self._message_stack) > 0:
+            message += ':'
+            for i in range(len(self._message_stack)):
+                message += '\n  [%d] %s' % (i, self._message_stack[i])
+        return message
+
+    @property
+    def message(self) -> str:
+        return self._message
+
+    @property
+    def message_stack(self) -> Sequence[str]:
+        return self._message_stack
 
 
 class EagleMemoryError(EagleError):
@@ -183,6 +203,20 @@ class EagleProfiler(object):
 
         library = cdll.LoadLibrary(library_path)
 
+        set_sdk_func = library.pv_set_sdk
+        set_sdk_func.argtypes = [c_char_p]
+        set_sdk_func.restype = None
+
+        set_sdk_func('python'.encode('utf-8'))
+
+        self._get_error_stack_func = library.pv_get_error_stack
+        self._get_error_stack_func.argtypes = [POINTER(POINTER(c_char_p)), POINTER(c_int)]
+        self._get_error_stack_func.restype = PicovoiceStatuses
+
+        self._free_error_stack_func = library.pv_free_error_stack
+        self._free_error_stack_func.argtypes = [POINTER(c_char_p)]
+        self._free_error_stack_func.restype = None
+
         # noinspection PyArgumentList
         self._eagle_profiler = POINTER(self.CEagleProfiler)()
 
@@ -198,7 +232,9 @@ class EagleProfiler(object):
             model_path.encode('utf-8'),
             byref(self._eagle_profiler))
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Profile initialization failed',
+                message_stack=self._get_error_stack())
 
         speaker_profile_size_func = library.pv_eagle_profiler_export_size
         speaker_profile_size_func.argtypes = [
@@ -209,7 +245,9 @@ class EagleProfiler(object):
         profile_size = c_int32()
         status = speaker_profile_size_func(self._eagle_profiler, byref(profile_size))
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Failed to get profile size',
+                message_stack=self._get_error_stack())
         self._profile_size = profile_size.value
 
         enroll_min_audio_length_sample_func = \
@@ -224,7 +262,9 @@ class EagleProfiler(object):
             self._eagle_profiler,
             byref(min_enroll_samples))
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Failed to get min audio length sample',
+                message_stack=self._get_error_stack())
         self._min_enroll_samples = min_enroll_samples.value
 
         self._delete_func = library.pv_eagle_profiler_delete
@@ -298,7 +338,9 @@ class EagleProfiler(object):
             byref(percentage))
         feedback = EagleProfilerEnrollFeedback(feedback_code.value)
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Enrollment failed',
+                message_stack=self._get_error_stack())
 
         return percentage.value, feedback
 
@@ -316,7 +358,9 @@ class EagleProfiler(object):
             byref(profile)
         )
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Export failed',
+                message_stack=self._get_error_stack())
 
         return EagleProfile(cast(profile, c_void_p), self._profile_size)
 
@@ -328,7 +372,9 @@ class EagleProfiler(object):
 
         status = self._reset_func(self._eagle_profiler)
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Profile reset failed',
+                message_stack=self._get_error_stack())
 
     def delete(self) -> None:
         """
@@ -361,6 +407,21 @@ class EagleProfiler(object):
 
         return self._version
 
+    def _get_error_stack(self) -> Sequence[str]:
+        message_stack_ref = POINTER(c_char_p)()
+        message_stack_depth = c_int()
+        status = self._get_error_stack_func(byref(message_stack_ref), byref(message_stack_depth))
+        if status is not PicovoiceStatuses.SUCCESS:
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](message='Unable to get Eagle error state')
+
+        message_stack = list()
+        for i in range(message_stack_depth.value):
+            message_stack.append(message_stack_ref[i].decode('utf-8'))
+
+        self._free_error_stack_func(message_stack_ref)
+
+        return message_stack
+
 
 class Eagle(object):
     """
@@ -400,6 +461,20 @@ class Eagle(object):
 
         library = cdll.LoadLibrary(library_path)
 
+        set_sdk_func = library.pv_set_sdk
+        set_sdk_func.argtypes = [c_char_p]
+        set_sdk_func.restype = None
+
+        set_sdk_func('python'.encode('utf-8'))
+
+        self._get_error_stack_func = library.pv_get_error_stack
+        self._get_error_stack_func.argtypes = [POINTER(POINTER(c_char_p)), POINTER(c_int)]
+        self._get_error_stack_func.restype = PicovoiceStatuses
+
+        self._free_error_stack_func = library.pv_free_error_stack
+        self._free_error_stack_func.argtypes = [POINTER(c_char_p)]
+        self._free_error_stack_func.restype = None
+
         # noinspection PyArgumentList
         self._eagle = POINTER(self.CEagle)()
 
@@ -423,7 +498,9 @@ class Eagle(object):
             profile_bytes,
             byref(self._eagle))
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Initialization failed',
+                message_stack=self._get_error_stack())
 
         self._delete_func = library.pv_eagle_delete
         self._delete_func.argtypes = [POINTER(self.CEagle)]
@@ -471,7 +548,9 @@ class Eagle(object):
 
         status = self._process_func(self._eagle, pcm, self._scores)
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Process failed',
+                message_stack=self._get_error_stack())
 
         # noinspection PyTypeChecker
         return [float(score) for score in self._scores]
@@ -485,7 +564,9 @@ class Eagle(object):
 
         status = self._reset_func(self._eagle)
         if status is not PicovoiceStatuses.SUCCESS:
-            raise _PICOVOICE_STATUS_TO_EXCEPTION[status]()
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](
+                message='Reset failed',
+                message_stack=self._get_error_stack())
 
     def delete(self) -> None:
         """
@@ -518,6 +599,21 @@ class Eagle(object):
 
         return self._version
 
+    def _get_error_stack(self) -> Sequence[str]:
+        message_stack_ref = POINTER(c_char_p)()
+        message_stack_depth = c_int()
+        status = self._get_error_stack_func(byref(message_stack_ref), byref(message_stack_depth))
+        if status is not PicovoiceStatuses.SUCCESS:
+            raise _PICOVOICE_STATUS_TO_EXCEPTION[status](message='Unable to get Eagle error state')
+
+        message_stack = list()
+        for i in range(message_stack_depth.value):
+            message_stack.append(message_stack_ref[i].decode('utf-8'))
+
+        self._free_error_stack_func(message_stack_ref)
+
+        return message_stack
+
 
 __all__ = [
     'Eagle',

{pveagle-0.1.0.dist-info → pveagle-0.2.0.dist-info}/METADATA

@@ -1,11 +1,13 @@
 Metadata-Version: 2.1
 Name: pveagle
-Version: 0.1.0
+Version: 0.2.0
 Summary: Eagle Speaker Recognition Engine
 Home-page: https://github.com/Picovoice/eagle
 Author: Picovoice
 Author-email: hello@picovoice.ai
+License: UNKNOWN
 Keywords: Speaker Recognition,Speaker Identification,Voice Recognition,Voice Identification
+Platform: UNKNOWN
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -139,7 +141,7 @@ eagle.delete()
 ```
 
 ## Demos
-<!-- markdown-link-check-disable -->
 [pveagledemo](https://pypi.org/project/pveagledemo/) provides command-line utilities for processing real-time
 audio (i.e. microphone) and files using Eagle.
-<!-- markdown-link-check-enable -->
+
+

pveagle-0.2.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+pveagle/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pveagle/__init__.py,sha256=5RRV_Nak7RhTLHEGAaLW35_j-R35suDmolZAtXPOu2g,570
+pveagle/_eagle.py,sha256=ftCdcNI3t054yQwcYx7SrxvGbINLf9pCAViyS1le1lQ,21705
+pveagle/_factory.py,sha256=VDMTJUGolPJ9PqRifp719ik3y5jqGFu4Ba4uc3EXUWA,3011
+pveagle/_util.py,sha256=5NtVephqCG_RWiNAZ2C_eHjwrdn6fxMiEcmnwWzkOrc,3150
+pveagle/lib/common/eagle_params.pv,sha256=k9WBjUOgN0lqGdfTz7kCwISCTMCRTTo53cSlFt4xwGw,7156210
+pveagle/lib/jetson/cortex-a57-aarch64/libpv_eagle.so,sha256=rEzMxGx42bIKztp9U11KIbxHnnGyCaIA8Z0SShn8CXY,233080
+pveagle/lib/linux/x86_64/libpv_eagle.so,sha256=kIVJRg2WamXWHftxI2HXadXyUi2_fR1Y_wmhToMg570,254048
+pveagle/lib/mac/arm64/libpv_eagle.dylib,sha256=p_nCDKqQ3l_hNrb8Yc9wD3gB5C9S5xEGeKU2bmauvT0,304526
+pveagle/lib/mac/x86_64/libpv_eagle.dylib,sha256=v0t66n6PRR0YaQcHHFbd5laYbpLOczLBQWsSClPC1Y4,318504
+pveagle/lib/raspberry-pi/cortex-a53/libpv_eagle.so,sha256=II6quUJXYqv74sqvPb02bkDwJiS9ON9Jkl6HxJCSl9Q,219464
+pveagle/lib/raspberry-pi/cortex-a53-aarch64/libpv_eagle.so,sha256=yX73X5eNykH0g2D_VeGMmEK-68WxooijSWoFemz0BNQ,233080
+pveagle/lib/raspberry-pi/cortex-a72/libpv_eagle.so,sha256=k_xCGIbKk93q0yxDUMq4d9uXRGIWW_nbWvBMoGZEE8E,223560
+pveagle/lib/raspberry-pi/cortex-a72-aarch64/libpv_eagle.so,sha256=O-0buzY4pb7NjOeDkR6V0hXES5U1YeIhwmCc4StdHEk,233080
+pveagle/lib/windows/amd64/libpv_eagle.dll,sha256=WeUyHhLBnoei4dSmo0YXyF2AIxeKQ7jBkAuZ3d0r3BQ,372736
+pveagle-0.2.0.dist-info/METADATA,sha256=dy6UNP5Em_aL-cJPvREi20dQfnemHfMN6L42BWoYAho,5480
+pveagle-0.2.0.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+pveagle-0.2.0.dist-info/top_level.txt,sha256=k2VZ1fNHirMrHCEeAoC3xi1ddfhyKl9qwhSSL_YlTIU,8
+pveagle-0.2.0.dist-info/RECORD,,

{pveagle-0.1.0.dist-info → pveagle-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.1)
+Generator: bdist_wheel (0.34.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pveagle-0.1.0.dist-info/RECORD

@@ -1,19 +0,0 @@
-pveagle/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-pveagle/__init__.py,sha256=5RRV_Nak7RhTLHEGAaLW35_j-R35suDmolZAtXPOu2g,570
-pveagle/_eagle.py,sha256=i8LjjdH_UNyI7hAjZKzAM1buO4RuEk-WC6CleANFD7Y,17717
-pveagle/_factory.py,sha256=VDMTJUGolPJ9PqRifp719ik3y5jqGFu4Ba4uc3EXUWA,3011
-pveagle/_util.py,sha256=5NtVephqCG_RWiNAZ2C_eHjwrdn6fxMiEcmnwWzkOrc,3150
-pveagle/lib/common/eagle_params.pv,sha256=aeZ1ucZg9WB1C3HXoixpGyNiqH1utriLol0ZVf1A8UI,7156210
-pveagle/lib/jetson/cortex-a57-aarch64/libpv_eagle.so,sha256=da02y_NYoQ_xrHnn2fYgpKzwPla5uwsnBChC_Lg-fqU,232080
-pveagle/lib/linux/x86_64/libpv_eagle.so,sha256=_JreaDI40fGJFM1Ak6qWIpeKNCVH61RYClZspKTPtPY,248864
-pveagle/lib/mac/arm64/libpv_eagle.dylib,sha256=cCfw-NebqNH-oX0NYYmQ_aSA7TWYKbsc6BdCjQcp8uw,304398
-pveagle/lib/mac/x86_64/libpv_eagle.dylib,sha256=uYk2WcqFlgPwMAWNEwur1mY_fK9iSfBIwSDEj31ErI4,318376
-pveagle/lib/raspberry-pi/cortex-a53/libpv_eagle.so,sha256=AG6LvhHetjgAJNj1Z72FFCOWG70a1HU4XcJWGmFUzDk,214932
-pveagle/lib/raspberry-pi/cortex-a53-aarch64/libpv_eagle.so,sha256=Cp3gcdgnmiaeOAqZV_G_jjdzhjGVwZX_hRsG9FObCJk,232168
-pveagle/lib/raspberry-pi/cortex-a72/libpv_eagle.so,sha256=Kjn-W6WxQN0ob6QI7d7z_ZjUOm0efcd6Vv04qwG_ra8,219028
-pveagle/lib/raspberry-pi/cortex-a72-aarch64/libpv_eagle.so,sha256=wKBTqO1iu9zOXP11WAy4qni1mxQcNrCPeuBDGyrJkck,232168
-pveagle/lib/windows/amd64/libpv_eagle.dll,sha256=4xtRy7_1dhiJn0Z61hwj_rimY5C83SGrsDAXSQDWOQc,376832
-pveagle-0.1.0.dist-info/METADATA,sha256=NctY4hUYDQCvuZJQuM_Kb3J70_v98v8-arJ625jiCT4,5516
-pveagle-0.1.0.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-pveagle-0.1.0.dist-info/top_level.txt,sha256=k2VZ1fNHirMrHCEeAoC3xi1ddfhyKl9qwhSSL_YlTIU,8
-pveagle-0.1.0.dist-info/RECORD,,