3 d@sTdZddlZddlZddlZddlZddlZddlZd ddZd ddZd d Z dS) zp Provides functions that mange strings to avoid characters that would be problematic in certain situations. NcCs^tjdtddtjd|jddjd}tjdd|j j }tjd d |}|dkrZ|S|S) a Make a user-supplied string safe for filename use. Returns an ASCII-encodable string based on the input string that's safe for use as a component of a filename or URL. The returned value is a string containing only lowercase ASCII letters, digits, and the characters '-' and '_'. This does not give a faithful representation of the original string: different input strings can result in the same output string. .. deprecated:: 6.3.0 This function will be removed in a future version of Traits. Parameters ---------- name : str The string to be made safe. replace_empty : str, optional The return value to be used in the event that the sanitised string ends up being empty. No validation is done on this input - it's up to the user to ensure that the default is itself safe. The default is to return the empty string. Returns ------- safe_string : str A filename-safe version of string. z;clean_filename is deprecated and will eventually be removed) stacklevelZNFKDasciiignorez[^\w\s-]rz[-\s]+-) warningswarnDeprecationWarning unicodedata normalizeencodedecoderesubstriplower)nameZ replace_empty safe_namer;/tmp/pip-build-7vycvbft/traits/traits/util/clean_strings.pyclean_filenames rFcCsRtjdtdd|dkr$tjj}n tj|}|s>|jdd}|jjdd}|S) a Return a timestamp that has been cleansed of characters that might cause problems in filenames, namely colons. If no datetime object is provided, then uses the current time. The timestamp is in ISO-8601 format with the following exceptions: * Colons ':' are replaced by underscores '_'. * Microseconds are not displayed if the 'microseconds' parameter is False. .. deprecated:: 6.3.0 This function will be removed in a future version of Traits. Parameters ---------- dt : None or datetime.datetime If None, then the current time is used. microseconds : bool Display microseconds or not. Returns ------- A string timestamp. z Attempt to make a valid Python identifier out of a name. r r)lenrrkeyword iskeywordisdigit)rrrr python_namezs   r()r)NF) __doc__rrr%rr rrr"r(rrrr s 3 /