VhzddlmZddlZddlZddlmZddlmZddlm Z m Z m Z ddgZ d dZ dd Zd Zdd Zdd Zy)) annotationsN)EEXIST) AnsibleError)to_bytes to_nativeto_text unfrackpath makedirs_safect|dd}| ttjd}n>tjj |rtjj |}tjj tjjt|d}tjj|s tjj||}|rtjj|}ttjj|dS)a Returns a path that is free of symlinks (if follow=True), environment variables, relative path traversals and symbols (~) :arg path: A byte or text string representing a path to be canonicalized :arg follow: A boolean to indicate of symlinks should be resolved or not :arg basedir: A byte string, text string, PathLike object, or `None` representing where a relative path should be resolved from. `None` will be substituted for the current working directory. :raises UnicodeDecodeError: If the canonicalized version of the path contains non-utf8 byte sequences. :rtype: A text string (unicode on pyyhon2, str on python3). :returns: An absolute path with symlinks, environment variables, and tilde expanded. Note that this does not check whether a path exists. example:: '$HOME/../../var/mail' becomes '/var/spool/mail' surrogate_or_strictpassthru)errors nonstringr) rosgetcwdpathisfiledirname expanduser expandvarsisabsjoinrealpathrnormpath)rfollowbasedir b_basedir b_final_paths B/home/dcms/DCMS/lib/python3.12/site-packages/ansible/utils/path.pyr r s&)>*UIRYY[1FG  "GGOOI. 77%%bgg&8&8$Od9e&fgL 77== &ww||I|<  ww'' 5 277##L1:O PPc ft|}t|}tjj |s0 |rtj ||ytj |yy#t $r@}|jtk7r#tdt|dt|Yd}~yd}~wwxYw)a A *potentially insecure* way to ensure the existence of a directory chain. The "safe" in this function's name refers only to its ability to ignore `EEXIST` in the case of multiple callers operating on the same part of the directory chain. This function is not safe to use under world-writable locations when the first level of the path to be created contains a predictable component. Always create a randomly-named element first if there is any chance the parent directory might be world-writable (eg, /tmp) to prevent symlink hijacking and potential disclosure or modification of sensitive file contents. :arg path: A byte or text string representing a directory chain to be created :kwarg mode: If given, the mode to set the directory to :raises AnsibleError: If the directory cannot be created and does not already exist. :raises UnicodeDecodeError: if the path is not decodable in the utf-8 encoding. z#Unable to create local directories(z): N) r rrrexistsmakedirsOSErrorerrnorrr)rmoderpathb_rpathes r r r Cs  EuoG 77>>' " t GT* G$ #  tww& "S\]bScenopeq#rss! tsA'A'' B006B++B0cnt|d}d}tjj|r|}nW|dvrtj}n>tjj |rtjj |}|rtjj|}t|dS)z- returns directory for inventory or playbook r rN)N.) rrrisdirrrrabspathr)sourcednames r rr_s f%: ;F E ww}}V ? "   ' & 5!6 77r!c tjj|rm tjj|rt j |n6tjj |rtj|yyyy#t$rG}|r;ddl m }|}|jdjt|Yd}~yYd}~yd}~wwxYw#t$rYywxYw)a Removes temporary file or directory. Optionally display a warning if unable to remove the file or directory. :arg path: Path to file or directory to be removed :kwarg warn: Whether or not to display a warning when the file or directory cannot be removed r)Displayz#Unable to remove temporary file {0}N)rrr#r.shutilrmtreerunlink Exceptionansible.utils.displayr3displayformatr)rwarnr*r3r9s r cleanup_tmp_filer<qs 77>>$  _77==&MM$'WW^^D)IIdO*(  _=%iGOO$J$Q$QRYZ[R\$]^^  _    s;C"A)B C8CC"C"CC"" C.-C.cd}t|d}t|d}|r>tjj|}tjj|}|j tjj }|j tjj } |dt ||k(}|S#t$rY|SwxYw)z Compares paths to check if one is contained in the other :arg: child: Path to test :arg parent; Path to test against F)rN)r rrrsplitseplen IndexError)childparentrealtest abs_child abs_parentcps r is_subpathrJs DE%0IVE2J GG$$Y/ WW%%j1  $A%A #a&zQ K   K  s0C CC)TN)N)F) __future__rrr4r&ransible.errorsr+ansible.module_utils.common.text.convertersrrr__all__r r rr<rJr!r rPsD"# 'TT / *"QJt88$ 4r!