a
    ¨ˆcn  ã                   @   sb   d Z ddlmZ ddlZddlmZmZmZ ddlm	Z	 ddl
mZ e e¡ZG dd	„ d	eƒZdS )
z< An object that can be initialized from a preferences node. é    )Úliteral_evalN)Ú	HasTraitsÚInstanceÚStré   )ÚIPreferences©Úget_default_preferencesc                       sn   e Zd ZdZeeƒZeZ‡ fdd„Z	dd„ Z
dd„ Zdd	„ Zd
d„ Zdd„ Zdd„ Zddd„Zdd„ Z‡  ZS )ÚPreferencesHelperaA   A base class for objects that can be initialized from a preferences
    node.

    Additional traits defined on subclasses will be listened to. Changes
    are then synchronized with the preferences. Note that mutations on nested
    containers e.g. List(List(Str)) cannot be synchronized and should be
    avoided.
    c                    s,   t t| ƒjf i |¤Ž | jr(|  | j¡ dS )z Constructor. N)Úsuperr
   Ú__init__ÚpreferencesÚ_initialize)ÚselfZtraits©Ú	__class__© új/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/apptools/preferences/preferences_helper.pyr   8   s    zPreferencesHelper.__init__c                 C   s   t ƒ S )z Trait initializer. r   )r   r   r   r   Ú_preferences_defaultG   s    z&PreferencesHelper._preferences_defaultc                 C   sx   | j du rdS |  |¡r4| j  d|  ¡ |f |¡ n@| d¡rt|dd… }|  |¡rt| j  d|  ¡ |f t| |ƒ¡ dS )ú Static trait change handler. Nú%s.%sZ_itemsiúÿÿÿ)r   Ú_is_preference_traitÚsetÚ	_get_pathÚendswithÚgetattr)r   Ú
trait_nameÚoldÚnewr   r   r   Ú_anytrait_changedP   s    



þz#PreferencesHelper._anytrait_changedc                 C   s4   |dur|  | j|  ¡ ¡ |dur0| j|dd� dS )r   NT)Únotify)Zremove_preferences_listenerÚ_preferences_changed_listenerr   r   )r   r   r   r   r   r   Ú_preferences_changedf   s    
ÿz&PreferencesHelper._preferences_changedc                 C   s$   ||   ¡ v r t| ||  ||¡ƒ dS )z5 Listener called when a preference value is changed. N)Útrait_namesÚsetattrÚ
_get_value)r   ÚnodeÚkeyr   r   r   r   r   r!   v   s    z/PreferencesHelper._preferences_changed_listenerc                 C   sJ   t | jƒdkr| j}n0t| ddƒ}|du r8td|  ƒ‚nt d|  ¡ |S )z* Return the path to our preferences node. r   ZPREFERENCES_PATHNzno preferences path, %sz%DEPRECATED: use "preferences_path" %s)ÚlenÚpreferences_pathr   ÚSystemErrorÚloggerÚwarn)r   Úpathr   r   r   r   ~   s    zPreferencesHelper._get_pathc                 C   sd   |   |¡}|j}t|tƒsB|jr"n zt|ƒ}W n ty@   Y n0 |jdur\| | ||¡}n|}|S )zÿGet the actual value to set.

        This method makes sure that any required work is done to convert the
        preference value from a string. Str traits or those with the metadata
        'is_str=True' will just be passed the string itself.

        N)ÚtraitÚhandlerÚ
isinstancer   Zis_strr   Ú	ExceptionÚvalidate)r   r   Úvaluer.   r/   Z	validatedr   r   r   r%   Ž   s    	

zPreferencesHelper._get_valueFc           	      C   sx   |   ¡ }| |¡}i }|  ¡ D ]2}||v rd||f }|  || |¡¡}|||< q| jf d|i|¤Ž | | j|¡ dS )z; Initialize the object's traits from the preferences node. r   Ztrait_change_notifyN)r   Úkeysr#   r%   ÚgetZ	trait_setZadd_preferences_listenerr!   )	r   r   r    r-   r4   Ztraits_to_setr   r'   r3   r   r   r   r   ±   s    

ÿzPreferencesHelper._initializec                 C   s0   |  d¡s | d¡s |t ¡ v r$dS ||  ¡ v S )z7 Return True if a trait represents a preference value. Ú_F)Ú
startswithr   r
   Zclass_traitsZeditable_traits)r   r   r   r   r   r   Ç   s    ÿþ
ýz&PreferencesHelper._is_preference_trait)F)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r   r)   r   r   r   r"   r!   r   r%   r   r   Ú__classcell__r   r   r   r   r
      s   	#
r
   )r;   Úastr   ÚloggingZ
traits.apir   r   r   Zi_preferencesr   Zpackage_globalsr	   Ú	getLoggerr8   r+   r
   r   r   r   r   Ú<module>
   s   
