AVSynthesiser for Mac Engine

MANIFEST

@@ -10,4 +10,5 @@ pyttsx3\drivers\_espeak.py
 pyttsx3\drivers\dummy.py
 pyttsx3\drivers\espeak.py
 pyttsx3\drivers\nsss.py
+pyttsx3\drivers\avsynth.py
 pyttsx3\drivers\sapi5.py

README.md

@@ -106,9 +106,10 @@ https://pyttsx3.readthedocs.io/en/latest/
 
 #### Included TTS engines:
 
-* sapi5
-* nsss
-* espeak
+* sapi5 (Windows)
+* nsss (Mac OS)
+* avsynth (Mac OS)
+* espeak (Linux, Mac OS, Windows)
 
 Feel free to wrap another text-to-speech engine for use with ``pyttsx3``.
 

README.rst

@@ -80,6 +80,7 @@ Included TTS engines:
 *********************
 * sapi5
 * nsss
+* avsynth
 * espeak
 
 Feel free to wrap another text-to-speech engine for use with ``pyttsx3``.

docs/engine.rst

@@ -17,6 +17,7 @@ The Engine factory
 
       * `sapi5` - SAPI5 on Windows
       * `nsss` - NSSpeechSynthesizer on Mac OS X
+      * `avsynth` - AVSynthesizer on Mac OS X (NSSS Is deprecated)
       * `espeak` - eSpeak on every other platform
 
    :param debug: Enable debug output or not.

pyttsx3/driver.py

@@ -5,7 +5,7 @@
 
 
 class DriverProxy(object):
-    '''
+    """
     Proxy to a driver implementation.
 
     @ivar _module: Module containing the driver implementation
@@ -23,10 +23,10 @@ class DriverProxy(object):
     @type _debug: bool
     @ivar _iterator: Driver iterator to invoke when in an external run loop
     @type _iterator: iterator
-    '''
+    """
 
     def __init__(self, engine, driverName, debug):
-        '''
+        """
         Constructor.
 
         @param engine: Reference to the engine that owns the driver
@@ -36,13 +36,13 @@ def __init__(self, engine, driverName, debug):
         @type driverName: str
         @param debug: Debugging output enabled or not
         @type debug: bool
-        '''
+        """
         driverName = driverName or {
-            'darwin': 'nsss',
-            'win32': 'sapi5',
-        }.get(sys.platform, 'espeak')
+            "darwin": "avsynth",
+            "win32": "sapi5",
+        }.get(sys.platform, "espeak")
         # import driver module
-        self._module = importlib.import_module(f'pyttsx3.drivers.{driverName}')
+        self._module = importlib.import_module(f"pyttsx3.drivers.{driverName}")
         # build driver instance
         self._driver = self._module.buildDriver(weakref.proxy(self))
         # initialize refs
@@ -52,7 +52,7 @@ def __init__(self, engine, driverName, debug):
         self._name = None
         self._iterator = None
         self._debug = debug
-        self._current_text = ''
+        self._current_text = ""
 
     def __del__(self):
         try:
@@ -61,7 +61,7 @@ def __del__(self):
             pass
 
     def _push(self, mtd, args, name=None):
-        '''
+        """
         Adds a command to the queue.
 
         @param mtd: Method to invoke to process the command
@@ -70,138 +70,138 @@ def _push(self, mtd, args, name=None):
         @type args: tuple
         @param name: Name associated with the command
         @type name: str
-        '''
+        """
         self._queue.append((mtd, args, name))
         self._pump()
 
     def _pump(self):
-        '''
+        """
         Attempts to process the next command in the queue if one exists and the
         driver is not currently busy.
-        '''
+        """
         while (not self._busy) and len(self._queue):
             cmd = self._queue.pop(0)
             self._name = cmd[2]
             try:
                 cmd[0](*cmd[1])
             except Exception as e:
-                self.notify('error', exception=e)
+                self.notify("error", exception=e)
                 if self._debug:
                     traceback.print_exc()
 
     def notify(self, topic, **kwargs):
-        '''
+        """
         Sends a notification to the engine from the driver.
 
         @param topic: Notification topic
         @type topic: str
         @param kwargs: Arbitrary keyword arguments
         @type kwargs: dict
-        '''
-        if 'name' not in kwargs or kwargs['name'] is None:  # Avoid overwriting
-            kwargs['name'] = self._name
+        """
+        if "name" not in kwargs or kwargs["name"] is None:  # Avoid overwriting
+            kwargs["name"] = self._name
         self._engine._notify(topic, **kwargs)
 
     def setBusy(self, busy):
-        '''
+        """
         Called by the driver to indicate it is busy.
 
         @param busy: True when busy, false when idle
         @type busy: bool
-        '''
+        """
         self._busy = busy
-        if not self._busy:
+        if not self._busy and hasattr(self, "_queue"):
             self._pump()
 
     def isBusy(self):
-        '''
+        """
         @return: True if the driver is busy, false if not
         @rtype: bool
-        '''
+        """
         return self._busy
 
     def say(self, text, name):
-        '''
+        """
         Called by the engine to push a say command onto the queue.
 
         @param text: Text to speak
         @type text: unicode
         @param name: Name to associate with the utterance
         @type name: str
-        '''
+        """
         self._current_text = text
         self._push(self._driver.say, (text,), name)
 
     def stop(self):
-        '''
+        """
         Called by the engine to stop the current utterance and clear the queue
         of commands.
-        '''
+        """
         # clear queue up to first end loop command
-        while(True):
+        while True:
             try:
                 mtd, args, name = self._queue[0]
             except IndexError:
                 break
-            if(mtd == self._engine.endLoop):
+            if mtd == self._engine.endLoop:
                 break
             self._queue.pop(0)
         self._driver.stop()
 
     def save_to_file(self, text, filename, name):
-        '''
+        """
         Called by the engine to push a say command onto the queue.
 
         @param text: Text to speak
         @type text: unicode
         @param name: Name to associate with the utterance
         @type name: str
-        '''
+        """
         self._push(self._driver.save_to_file, (text, filename), name)
 
     def getProperty(self, name):
-        '''
+        """
         Called by the engine to get a driver property value.
 
         @param name: Name of the property
         @type name: str
         @return: Property value
         @rtype: object
-        '''
+        """
         return self._driver.getProperty(name)
 
     def setProperty(self, name, value):
-        '''
+        """
         Called by the engine to set a driver property value.
 
         @param name: Name of the property
         @type name: str
         @param value: Property value
         @type value: object
-        '''
+        """
         self._push(self._driver.setProperty, (name, value))
 
     def runAndWait(self):
-        '''
+        """
         Called by the engine to start an event loop, process all commands in
         the queue at the start of the loop, and then exit the loop.
-        '''
+        """
         self._push(self._engine.endLoop, tuple())
         self._driver.startLoop()
 
     def startLoop(self, useDriverLoop):
-        '''
+        """
         Called by the engine to start an event loop.
-        '''
+        """
         if useDriverLoop:
             self._driver.startLoop()
         else:
             self._iterator = self._driver.iterate()
 
     def endLoop(self, useDriverLoop):
-        '''
+        """
         Called by the engine to stop an event loop.
-        '''
+        """
         self._queue = []
         self._driver.stop()
         if useDriverLoop:
@@ -211,10 +211,10 @@ def endLoop(self, useDriverLoop):
         self.setBusy(True)
 
     def iterate(self):
-        '''
+        """
         Called by the engine to iterate driver commands and notifications from
         within an external event loop.
-        '''
+        """
         try:
             next(self._iterator)
         except StopIteration: