o CZŽh\ã@s0ddlmZddlZddlZGdd„deƒZdS)é)ÚdriveréNc@sˆeZdZdZd!dd„Zdd„Zdd „Zd d „Zd"d d „Zdd„Z d"dd„Z dd„Z dd„Z dd„Z dd„Zd#dd„Zdd„Zdd „ZdS)$ÚEngineaz @ivar proxy: Proxy to a driver implementation @type proxy: L{DriverProxy} @ivar _connects: Array of subscriptions @type _connects: list @ivar _inLoop: Running an event loop or not @type _inLoop: bool @ivar _driverLoop: Using a driver event loop or not @type _driverLoop: bool @ivar _debug: Print exceptions or not @type _debug: bool NFcCs2t t |¡||¡|_i|_d|_d|_||_dS)a- Constructs a new TTS engine instance. @param driverName: Name of the platform specific driver to use. If None, selects the default driver for the operating system. @type: str @param debug: Debugging output enabled or not @type debug: bool FTN)rZ DriverProxyÚweakrefÚproxyÚ _connectsÚ_inLoopÚ _driverLoopÚ_debug)ÚselfZ driverNameÚdebug©r ú=/var/www/auris/lib/python3.10/site-packages/pyttsx3/engine.pyÚ__init__s   zEngine.__init__c KsJ|j |g¡D]}z |di|¤ŽWqty"|jr t ¡YqwdS)zÌ Invokes callbacks for an event topic. @param topic: String event name @type topic: str @param kwargs: Values associated with the event @type kwargs: dict Nr )rÚgetÚ Exceptionr Ú tracebackÚ print_exc)r ÚtopicÚkwargsÚcbr r rÚ_notify%s  €þýzEngine._notifycCs"|j |g¡}| |¡||dœS)aþ Registers a callback for an event topic. Valid topics and their associated values: started-utterance: name= started-word: name=, location=, length= finished-utterance: name=, completed= error: name=, exception= @param topic: Event topic name @type topic: str @param cb: Callback function @type cb: callable @return: Token to use to unregister @rtype: dict )rr)rÚ setdefaultÚappend)r rrÚarrr r rÚconnect5s  zEngine.connectcCsV|d}z|j|}Wn tyYdSw| |d¡t|ƒdkr)|j|=dSdS)z‘ Unregisters a callback for an event topic. @param token: Token of the callback to unregister @type token: dict rNrr)rÚKeyErrorÚremoveÚlen)r Útokenrrr r rÚ disconnectJs ÿ  ÿzEngine.disconnectcCs|dkrdS|j ||¡dS)a Adds an utterance to speak to the event queue. @param text: Text to speak @type text: unicode @param name: Name to associate with this utterance. Included in notifications about this utterance. @type name: str Nz%Argument value can't be none or empty)rÚsay)r ÚtextÚnamer r rr!Zs z Engine.saycCs|j ¡dS)zI Stops the current utterance and clears the event queue. N)rÚstop©r r r rr$isz Engine.stopcCs|j |||¡dS)aC Adds an utterance to speak to the event queue. @param text: Text to speak @type text: unicode @param filename: the name of file to save. @param name: Name to associate with this utterance. Included in notifications about this utterance. @type name: str N)rÚ save_to_file)r r"Úfilenamer#r r rr&os zEngine.save_to_filecCs |j ¡S)zl @return: True if an utterance is currently being spoken, false if not @rtype: bool )rÚisBusyr%r r rr(|s z Engine.isBusycCs |j |¡S)az Gets the current value of a property. Valid names and values include: voices: List of L{voice.Voice} objects supported by the driver voice: String ID of the current voice rate: Integer speech rate in words per minute volume: Floating point volume of speech in the range [0.0, 1.0] Numeric values outside the valid range supported by the driver are clipped. @param name: Name of the property to fetch @type name: str @return: Value associated with the property @rtype: object @raise KeyError: When the property name is unknown )rÚ getProperty)r r#r r rr)ƒs zEngine.getPropertycCs|j ||¡dS)a8 Adds a property value to set to the event queue. Valid names and values include: voice: String ID of the voice rate: Integer speech rate in words per minute volume: Floating point volume of speech in the range [0.0, 1.0] Numeric values outside the valid range supported by the driver are clipped. @param name: Name of the property to fetch @type name: str @param: Value to set for the property @rtype: object @raise KeyError: When the property name is unknown N)rÚ setProperty)r r#Úvaluer r rr*—szEngine.setPropertycCs(|jrtdƒ‚d|_d|_|j ¡dS)zõ Runs an event loop until all commands queued up until this method call complete. Blocks during the event loop and returns when the queue is cleared. @raise RuntimeError: When the loop is already running úrun loop already startedTN)rÚ RuntimeErrorr rÚ runAndWaitr%r r rr.«s zEngine.runAndWaitTcCs,|jrtdƒ‚d|_||_|j |j¡dS)a™ Starts an event loop to process queued commands and callbacks. @param useDriverLoop: If True, uses the run loop provided by the driver (the default). If False, assumes the caller will enter its own run loop which will pump any events for the TTS engine properly. @type useDriverLoop: bool @raise RuntimeError: When the loop is already running r,TN)rr-r rÚ startLoop)r Z useDriverLoopr r rr/¹s  zEngine.startLoopcCs&|jstdƒ‚|j |j¡d|_dS)zh Stops a running event loop. @raise RuntimeError: When the loop is not running úrun loop not startedFN)rr-rÚendLoopr r%r r rr1És zEngine.endLoopcCs*|jstdƒ‚|jrtdƒ‚|j ¡dS)zM Must be called regularly when using an external event loop. r0z$iterate not valid in driver run loopN)rr-r rÚiterater%r r rr2Ôs zEngine.iterate)NF)N)T)Ú__name__Ú __module__Ú __qualname__Ú__doc__rrrr r!r$r&r(r)r*r.r/r1r2r r r rrs       r)ÚrrrÚobjectrr r r rÚs