(gx7dZdZddlZddlZddlmZmZm Z dZ ddddZ ddd Z d Z d d d Zie_dZddddZddddZdZdZdZdddZddddZdZd Zd!ZdS)"zm This module has a similar scope to os.path, containing utility functions for dealing with paths in Blender. )abspathbasename clean_name display_namedisplay_name_to_filepathdisplay_name_from_filepath ensure_extextensions_imageextensions_movieextensions_audio is_subdir module_namesnative_pathsep reduce_dirsrelpath resolve_ncaseN)r r r cR||dS)NF) path_resolveas_bytes)varattrs N/home/blender/git/blender-v430/install_release/4.3/scripts/modules/bpy/path.py_getattr_bytesr's$   D% ( ( 1 1 3 33)startlibraryct|tr|dr|r:tjt t|d}tj|7tjttj dn||ddSn|dr|r1tjt |j }tj|.tjtj j n||ddS|S)a Returns the absolute path relative to the current blend file using the "//" prefix. :arg start: Relative to this path, when not set the current filename is used. :type start: str | bytes :arg library: The library this path is from. This is only included for convenience, when the library is not None its path replaces *start*. :type library: :class:`bpy.types.Library` :return: The absolute path. :rtype: str //filepathN//) isinstancebytes startswith_ospathdirnamerrjoin_bpydatar)r&rrs rrr+sG$ ??5 ! !  B((N7J??@@BB8===   :!F!FGGG&+QRR    ??4   /((G,--//8===  !3444&+QRR  Kr)rct|trr|ds\|7tjt tjd}dtj ||zSnh|dsS|.tjtjj }dtj ||zS|S)a8 Returns the path relative to the current blend file using the "//" prefix. :arg path: An absolute path. :type path: str | bytes :arg start: Relative to this path, when not set the current filename is used. :type start: str | bytes :return: The relative path. :rtype: str rNrr!) r"r#r$r%r&r'rr)r*rr)r&rs rrrQs$ 8u%% 9}(( :)N)NOO38++D%888 8 9 t$$ 8}(();<<#(**4777 7 Krc\ddlm}m}m}|||}|||}t |t |krYt |t r|dn|}|| ||zrdSdS)z Returns true if *path* in a subdirectory of *directory*. Both paths must be absolute. :arg path: An absolute path. :type path: str | bytes :return: Whether or not the path is a subdirectory. :rtype: bool r)normpathnormcasesepasciiTF) os.pathr-r.r/lenr"r#encoder$rstrip)r& directoryr-r.r/s rr r ks0///////// 8HHTNN # #D),,--I 4yy3y>>!!%/ 5%A%AJcjj!!!s ??9++C0036 7 7 4 5r_)replacecdkr5tdkstdkrtdfd}|}||S)a Returns a name with characters replaced that may cause problems under various circumstances, such as writing to a file. All characters besides A-Z/a-z, 0-9 are replaced with "_" or the *replace* argument if defined. :arg name: The path name. :type name: str | bytes :arg replace: The replacement for non-valid characters. :type replace: str :return: The cleaned name. :rtype: str r6z&Value must be a single ascii characterctj}|}|-d}tfd|D}||<|S)N)rr9r   !"#$%&'()*+,./:;<=>?@[\]^`{|}~ci|]}|Sr).0charr7s r z6clean_name..maketrans_init..s"G"G"GT4"G"G"Gr)r _trans_cachegetstr maketrans) trans_cachetrans bad_charsr7s rmaketrans_initz"clean_name..maketrans_inits_ - (( =I4MM"G"G"G"GY"G"G"GHHE#(K  r)r2ord ValueError translate)namer7rrs ` rrrsy"#~~ w<<1  G s 2 2EFF F     D N  E >>%  rct|tkr|ddS|dddS)Nutf8r7)typer#decoder3rs r _clean_utf8rsI DzzU{{69---{{69--44V<<">"@"@44 J||J 33 <<S ! ! ( ( - -D$dllnn$zz||!!## t  D KrcptD]\}}|||}|S)z Performs the reverse of display_name using literal versions of characters which aren't supported in a filepath. :arg name: The display name to convert. :type name: str :return: The file path. :rtype: str )rrr7)rr r!s rrrs>#9">">"@"@44 J||J 33 Krctjt|d}t |}|S)z Returns the path stripped of directory and extension, ensured to be utf8 compatible. :arg name: The file path to convert. :type name: str :return: The display name. :rtype: str r)r%r&rrrr s rrrs6 8  Xd^^ , ,Q /D t  D Krc6fd|\}}|r|n|S)a Resolve a case insensitive path on a case sensitive system, returning a string with the path if found else return the original path. :arg path: The path name to resolve. :type path: str :return: The resolved path. :rtype: str c|rtj|r|dfStj|}tj|}|dd}|st |t |kr'|dt |t |z }tj|}tj|}tj|s||kr|dfS |\}}|s|dfStj|r* tj|}n#t$r|dfcYSwxYw|dfS| }d}|D]}| |kr|}n|r%tj |||zdfS|dfS)NTrF) r%r&existsrr'r2isdirlistdirPermissionErrorrr() r&filenamedirpathsuffixfoundfiles filename_low f_iter_nocasef_iter_ncase_path_founds rr2z(resolve_ncase.._ncase_path_founds sxt,, : 8$$T**(""4((bqb 07||c$ii''7s4yy3w<<778x((11Hh&&w//Gxw'' #$U{"..w77NGU #U{" 8>>' " "  # G,," # # #U{""" #; ~~''    F||~~-- & .  8==-886A4G G; sE((E98E9r)r& ncase_pathr-r2s @rrr sC11111f*)$//J (::D(rF)case_sensitivec|r||r|SnQ|t| d|r|S||zS)a Return the path with the extension added if it is not already set. :arg filepath: The file path. :type filepath: str :arg ext: The extension to check for, can be a compound extension. Should start with a dot, such as '.blend' or '.tar.gz'. :type ext: str :arg case_sensitive: Check for matching case when comparing extensions. :type case_sensitive: bool :return: The file path with the given extension. :rtype: str N)endswithr2r)rextr4s rrrMsx   S ! ! O  SXXIJJ  % % ' ' 0 0 = = O c>r) recursivepackagecLddlm}m}g}|r|dznd}tt j|D]}|dkr|s |dr5|dkr/|||}|||ddz|fU|ds|||} || d}||ra|||z|f|rEt| d D]3\} } |d ||z| | f4|S) a Return a list of modules which can be imported from *path*. :arg path: a directory to scan. :type path: str :arg recursive: Also return submodule names for packages. :type recursive: bool :arg package: Optional string, used as the prefix for module names (without the trailing "."). :type package: str :return: a list of string pairs (module_name, module_file). :rtype: list[str] r)r(isfile.r8modulesz.pyz __init__.pyT)r9z {:s}.{:s}) r1r(r<sortedr%r(r6appendr$r format) r&r9r:r(r<r>package_prefixr*fullpathr5mod_namemod_paths rr r fs%$$$$$$$G(/7gmmRN3;t,,--  ! !N !    u % % (m*C*CtD(++H NNNXad^;XF G G G G$$S)) T8,,ItI}55Hvh  98DEEE.:9PT.U.U.U*('..~/H(SS$( Nrcltj|dddvr |ddn|S)z Equivalent to ``os.path.basename``, but skips a "//" prefix. Use for Windows compatibility. :return: The base name of the given path. :rtype: str Nr >rr!)r%r&rr&s rrrs8 8  bqb])B)BT!""XX M MMrct|turrtjdkr|ddS|dr!d|ddddzS|ddStjdkr|ddS|dr!d|ddddzS|ddS) z Replace the path separator with the systems native ``os.sep``. :arg path: The path to replace. :type path: str :return: The path with system native separators. :rtype: str r\r!r N\/r)r rr%r/r7r$rHs rrrs DzzS 7c>><<c** *t$$ /d122h..sD9999||C... 7c>><<t,, ,u%% 1tABBx//e<<<<||D%000rctd|D}|dtt|dz ddD]s}t|D]a}t ||t||t||krn"t ||||r||=nbt|S)a' Given a sequence of directories, remove duplicates and any directories nested in one of the other paths. (Useful for recursive path searching). :arg dirs: Sequence of directory paths. :type dirs: Sequence[str] :return: A unique list of paths. :rtype: list[str] ch|]>}tjtj|?Sr)r%r&r-r)rds r zreduce_dirs..s8FFFA""38#3#3A#6#677FFFrc t|S)N)r2)rOs rzreduce_dirs..s CFFr)keyr9)listsortranger2printr )dirsijs rrrs FFFFF G GDII""I### 3t99q="b ) )q  A !QKKK47||s47||++47DG,, G  Kr)__doc____all__bpyr)osr% _bpy_pathr r r rrrr rrrrrrrrrr rrrrrrras   &444 #####L 4(!$8!8!8!8!8!v ===   #'4B       ?)?)?)D162%*2'''''T N N N1116r