3 dB@sDdZddlZddlZddlZGdddeZGdddZeZdS)z1 Enthought Tool Suite configuration information. Nc@seZdZdZdddZdS)ETSToolkitErrorz Error raised by issues importing ETS toolkits Attributes ---------- message : str The message detailing the error. toolkit : str or None The toolkit associated with the error. NcGsF| r|rdj|}||_||_|r<|r2|f|}|f|}||_dS)Nzcould not import toolkit '{0}')formattoolkitmessageargs)selfrrrr /foo, regardless of if it was launched with "python /run.py" or "cd ; python run.py" - This is useful for library modules used in apps that need to store state, preferences, etc. for the specific app only, and not for all apps which use that library module. If the library module uses ETSConfig.application_home, they can store prefs for the app all in one place and do not need to know the details of where each app might reside. - Do not put anything in here that the user might want to navigate to e.g. projects, user home files etc. - The actual location differs between operating systems. N)r)rospathjoinr_get_application_dirname)rrr r r get_application_homes #   z"ETSConfigType.get_application_homecCs |jddS)z@ Property getter, see get_application_home's docstring. T)r)r)rr r r application_homeszETSConfigType.application_homecCs ||_dS)z# Property setter. N)r)rrr r r rscCs d|_dS)N)r)rr r r rscCs|jdkr|j|_|jS)z# Property getter. N)r_initialize_company)rr r r companys  zETSConfigType.companycCs ||_dS)z8 Property setter for the company name. N)r)rr!r r r r!scCs d|_dS)N)r)rr r r r!sc csD|jrd}t|j|j||_y dVWnd|_YnXdS)a| Perform an operation with toolkit provisionally set This sets the toolkit attribute of the ETSConfig object to the provided value. If the operation fails with an exception, the toolkit is reset to nothing. This method should only be called if the toolkit is not currently set. Parameters ---------- toolkit : string The name of the toolkit to provisionally use. Raises ------ ETSToolkitError If the toolkit attribute is already set, then an ETSToolkitError will be raised when entering the context manager. z)ETSConfig toolkit is already set to '{0}'Nr)rrrr)rrmsgr r r provisional_toolkits z!ETSConfigType.provisional_toolkitcCs$|jdkr|j|_|jjddS)z Property getter for the GUI toolkit. The value returned is, in order of preference: the value set by the application; the value specified by the 'ETS_TOOLKIT' environment variable; otherwise the empty string. N.r)r_initialize_toolkitsplit)rr r r rs  zETSConfigType.toolkitcCs,|jr"|j|kr"td||jf||_dS)a) Property setter for the GUI toolkit. The toolkit can be set more than once, but only if it is the same one each time. An application that is written for a particular toolkit can explicitly set it before any other module that gets the value is imported. z>cannot set toolkit to %s because it has already been set to %sN)r ValueError)rrr r r rs cCs d|_dS)N)r)rr r r rscCsddlm}|d|jS)a7 Deprecated: This property is no longer used. Property getter for the Enable backend. The value returned is, in order of preference: the value set by the application; the value specified by the 'ENABLE_TOOLKIT' environment variable; otherwise the empty string. r)warnz2Use of the enable_toolkit attribute is deprecated.)warningsr(r)rr(r r r enable_toolkits zETSConfigType.enable_toolkitcCsddlm}|ddS)a@ Deprecated. Property setter for the Enable toolkit. The toolkit can be set more than once, but only if it is the same one each time. An application that is written for a particular toolkit can explicitly set it before any other module that gets the value is imported. r)r(z2Use of the enable_toolkit attribute is deprecated.N)r)r()rrr(r r r r*,s cCsL|jdkrtdd|jkr,|jjddS|jdkrDtjdkrDdSdSdS) a Property getter for the Kiva backend. The value returned is dependent on the value of the toolkit property. If toolkit specifies a kiva backend using the extended syntax: [.] then the value of the property will be whatever was specified. Otherwise the value will be a reasonable default for the given enable backend. NzKThe kiva_backend attribute is dependent on toolkit, which has not been set.r$ZwxdarwinZquartzimage)rAttributeErrorr&rsysplatform)rr r r kiva_backend:s  zETSConfigType.kiva_backendcCs|jdkr|j|_|jS)z Property getter. This is a directory that users can safely write user accessible data to i.e. user-defined functions, edited functions, etc. The actual location differs between operating systems. N)r_initialize_user_data)rr r r user_dataQs  zETSConfigType.user_datacCs ||_dS)z# Property setter. N)r)rr3r r r r3bscCs d|_dS)N)r)rr r r r3kscCsJd}tjjdd}|dk rFt|drFtjj|j}tjjtjj |}|S)a Return the name of the directory (not a path) that the "main" Python script which started this process resides in, or "" if it could not be determined or is not appropriate. For example, if the script that started the current process was named "run.py" in a directory named "foo", and was launched with "python run.py", the name "foo" would be returned (this assumes the directory name is the name of the app, which seems to be as good of an assumption as any). r__main__N__file__) r/modulesgethasattrrrabspathr5basenamedirname)rr;Zmain_modZ main_mod_filer r r rys z&ETSConfigType._get_application_dirnameTc Cstjdkrd}|j}nd}d|jj}tjj|d}|dksF|dkrddl}ddlm }|j }tjjd d}|dk r|d |7}|d ||ftj j ||}|rtj j |rtj j|std |n tj||S) zH Initializes the (default) application data directory. win32APPDATAHOMEr$Nz/rootr)r(USERz_%sz?Environment variable "%s" not set, setting home directory to %szFile "%s" already exists)r/r0r!lowerrenvironr7tempfiler)r( gettempdirrrexistsisdirr'makedirs) rrZenvironment_variabledirectory_nameparent_directoryrBr(userrr r r rs0        z*ETSConfigType._initialize_application_datacCsdS)z5 Initializes the (default) company. Z Enthoughtr )rr r r r sz!ETSConfigType._initialize_companycCs$|jdk r|j}ntjjdd}|S)z+ Initializes the toolkit. NZ ETS_TOOLKITr)rrrAr7)rrr r r r%s z!ETSConfigType._initialize_toolkitc Cstjjd}|j}tjdkr|y*ddlm}m}|j }|j d|dd}Wqt k rxtjj |d}tjj |rt|}YqXn|j}tjj ||}tjj |rtjj|std|n tj||S)zA Initializes the (default) user data directory. ~r<r)shellshellconz My DocumentszFile "%s" already exists)rr expanduserr!r/r0win32com.shellrKrLZCSIDL_PERSONALSHGetFolderPath ImportErrorrrDr@rEr'rF)rrHrGrKrLZMY_DOCSZ desired_dirZusr_dirr r r r2s$        z#ETSConfigType._initialize_user_dataN)F)F)T)r r rrr rpropertyrsetterdeleterrrr! contextlibcontextmanagerr#rr*r1r3rrr r%r2r r r r r,s8      +          / r)rrTrr/ RuntimeErrorrrZ ETSConfigr r r r  se