ó âdc@`s…dZddlmZmZmZmZddlTddlZddlZddl Z ddl Z dgZ de fd„ƒYZ dS(uLClass providing a string template to substitute fields and their arguments. i(tabsolute_importtdivisiontprint_functiontunicode_literals(t*Nu StringPatternt StringPatterncB`sÔeZdZdd„Zed„ƒZed„ƒZed„ƒZd„Z e d„ƒZ e d„ƒZ e d„ƒZe dd „ƒZe d „ƒZe d „ƒZe d „ƒZe d „ƒZd„ZRS(uD This class provides string substitution based on fields and their arguments. Fields are enclosed in square brackets (such as `"[field]"`). Field arguments are separated by commas (`","`). The number of arguments depends on the substitution function in the `fields` dictionary passed to `__init__`. To insert literal commas in field arguments, enclose the arguments in square brackets. To insert square brackets in field arguments, enclose the arguments in square brackets and double the square brackets (the ones inside the argument, not the enclosing ones). If the last argument is enclosed in square brackets, insert a comma after the argument. Attributes: * `pattern` - The original string pattern. * `pattern_parts` - Parts of `pattern` split into strings (parts of the pattern not containing the field) and fields (tuples describing the field). * `parsed_fields_and_matching_regexes` - Dictionary of `(parsed field, first matching field regular expression)` pairs. Examples: Suppose `fields` contains a field named `"date"` returning the current date (requiring a date format as a parameter). * "image" -> "image", "image", ... * "image_[date, %Y-%m-%d]" -> "image_2016-07-16", ... * "[[image]]" -> "[image]", ... * "[date, [[[%Y,%m,%d]]] ]" -> "[2016,07,16]", ... cC`sX||_tj|dk r!|ngƒ|_|j|j|jƒ\|_}|_dS(u« Parameters: * `pattern` - String containing fields to substitute. * `fields` - List of `(field regex, function)` tuples. `field regex` matches the fields in the pattern and `function` substitutes the field with the value returned by the function. The function must always specify at least one argument - the field to be substituted. Any unmatched fields will be silently ignored. Fields in the pattern are enclosed in square brackets (`"[field]"`). To insert literal square brackets, double the characters (`"[["`, `"]]"`). If `fields` is `None`, no fields in the pattern will be substituted. N(t_patternt collectionst OrderedDicttNonet_fieldst parse_patternt_pattern_partst#_parsed_fields_and_matching_regexes(tselftpatterntfieldstunused_((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyt__init__6s $cC`s|jS(N(R(R((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyRNscC`s|jS(N(R (R((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyt pattern_partsRscC`s|jS(N(R (R((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyt"parsed_fields_and_matching_regexesVscG`s_g}xI|jD]>}|j|ƒs5|j|ƒq|j|j||ƒƒqWdj|ƒS(up Substitute fields in the string pattern. Return the processed string. If any substitution function raises an exception, the original string pattern is returned. You may pass additional arguments if `fields` contains functions expecting more arguments outside the parsed arguments. These arguments are prepended to each function. u(R t _is_fieldtappendt_process_fieldtjoin(Rtadditional_argsRtpart((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyt substituteZs cC`si|j|ddƒ\}}}xD|D]<}|d}|d|koT|dknr%|dSq%WdS(u If the pattern contains a field at the given character position (starting from 0), return the field name, otherwise return `None`. RiiiN(R R (tclsRtpositionRt parsed_fieldst parsed_fieldtindices((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pytget_field_at_positionns   $ cC`sÃg}x­|D]¥}|j|ƒs2|j|ƒq |sGtdƒ‚n|dg}t|ƒdkr“|jg|dD]}t|ƒ^qwƒn|jdjdj|ƒƒƒq Wdj|ƒS(u Reconstruct a string pattern given the parsed `pattern_parts` returned from the `pattern_parts` attribute of a `StringPattern` instance. Raises: * `ValueError` - A list as an element of `pattern_parts` representing a field is empty. uBlists representing fields must always contain at least one elementiiu[{}]u, u(RRt ValueErrortlentextendtstrtformatR(RRtprocessed_pattern_partsRtfield_componentstarg((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pytreconstruct_pattern}s    -#c`st‡fd†|DƒdƒS(u· Given the field `parsed_field_str` and the list of field regular expressions, return the first matching field regular expression. Return `None` if there is no match. c3`s'|]}tj|ˆƒr|VqdS(N(tretsearch(t.0t field_regex(tparsed_field_str(sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pys £sN(tnextR (R/t field_regexes((R/sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pytget_first_matching_field_regex›sc `sAd}d‰d‰d}g‰g}i}d‡‡‡‡fd†}xå|tˆƒkr,ˆ|dkrP|jˆ|dƒ}|dkrÂ|rÂ||ƒˆjdƒ|d‰|d7}qHq|dkrò| rò||ƒ|‰|d7}q|dkr |d7}q|dkr-|r-|d7}qHq|dkr| r|d7}qnψ|dkr|jˆ|dƒ}|dkr¸|r¸||ƒˆjdƒ|d‰|d7}qHn‹|dkrÛ| rÛ|d7}qHnh|dkrô|d8}nO|dkr|r|d7}qHn-|dkrC| rC|d8}|d7}qHnˆˆd|!} t|j| ƒƒ| gˆd|fg} |dk r¦|j| d|ƒ} nd} |dksÙ| dk r|j| | |ƒrˆj| ƒ|j| ƒ| || d||dkrL|j||dƒrC|d7}qwqLt}n|d7}qwW|| |ƒfS( uÖParses the given field as a string. `field_str` must be specified without `[` and `]` at the beginning and end, respectively. A tuple of (field name, list of field arguments) is returned. u,iÿÿÿÿiicS`sŽg}x|D]y}|jƒ}|s+q n|ddkr[|ddkr[|dd!}n|jddƒjddƒ}|j|ƒq W|S(Niu[iÿÿÿÿu]iu[[u]](tstriptreplaceR(t field_argstprocessed_field_argst field_argt processed_arg((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyt_process_field_args*s   u[iu](tfindRAtFalseR#RR9tTrue( Rt field_strtfield_name_end_indext field_nametfield_args_strtis_in_field_argtlast_field_arg_end_indexR=RCRG((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyR;s<          cC`sA||}tj|ƒ}|jr=tdj|jƒƒ‚ntS(NuP{}: field functions with variable keyword arguments (**kwargs) are not supported(tinspectt getargspectkeywordsR"R&t__name__RJ(RRR.Rt field_functargspec((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyR<Rs  cC`s(|dt|ƒko'||d|kS(Ni(R#(RR=tsymbol((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyR9_scC`st|tjƒ S(N(t isinstancettypest StringTypes(t pattern_part((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyRcscC`s}|j|j|d}t|ƒ|dgt|dƒ}y||Œ}Wntk rndj|dƒSXt|ƒSdS(Niiu[{}]i(R R R:t ExceptionR&R%(RtfieldRRUtfield_func_argst return_value((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyRgs% N(RTt __module__t__doc__R RtpropertyRRRRt classmethodR!R*t staticmethodR2R R;R<R9RR(((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyRs !   j@ (Rat __future__RRRRtfuture.builtinsRRQR+RYt__all__tobjectR(((sN/home/josie/.config/GIMP/2.10/plug-ins/export_layers/pygimplib/path/pattern.pyts"      # -*- coding: utf-8 -*- """Functions to modify strings or file paths to make them unique.""" from __future__ import absolute_import, division, print_function, unicode_literals from future.builtins import * import os __all__ = [ 'uniquify_string', 'uniquify_filepath', 'uniquify_string_generic', ] def uniquify_string(str_, existing_strings, position=None, generator=None): """ If string `str_` is in the `existing_strings` list, return a unique string by inserting a substring that makes `str_` unique. Otherwise, return original `str_`. Parameters: * `str_` - String to uniquify. * `existing_strings` - List of strings to compare against `str_`. * `position` - See the `position` parameter in `uniquify_string_generic()` for more information. * `generator` - See the `generator` parameter in `uniquify_string_generic()`. """ return uniquify_string_generic( str_, lambda str_param: str_param not in existing_strings, position, generator) def uniquify_filepath(filepath, position=None, generator=None): """ If a file at the specified path already exists, return a unique file path. Parameters: * `filepath` - File path to uniquify. * `position` - See the `position` parameter in `uniquify_string_generic()` for more information. * `generator` - See the `generator` parameter in `uniquify_string_generic()`. """ return uniquify_string_generic( filepath, lambda filepath_param: not os.path.exists(filepath_param), position, generator) def uniquify_string_generic(str_, is_unique_func, position=None, generator=None): """ If string `str_` is not unique according to `is_unique_func`, return a unique string by inserting a substring that makes `str_` unique. Otherwise, return original `str_`. Parameters: * `str_` - String to uniquify. * `is_unique_func` - Function that returns `True` if `str_` is unique, `False` otherwise. `is_unique_func` must contain `str_` as its only parameter. * `position` - Position (index) where the substring is inserted. If the position is `None`, insert the substring at the end of `str_` (i.e. append it). * `generator` - A generator object that generates a unique substring in each iteration. If `None`, the generator yields default strings - " (1)", " (2)", etc. An example of a custom generator: def _generate_unique_copy_string(): substr = " - copy" yield substr substr = " - another copy" yield substr i = 2 while True: yield "{} {}".format(substr, i) i += 1 This generator yields " - copy", " - another copy", " - another copy 2", etc. """ def _get_uniquified_string(generator): return '{}{}{}'.format( str_[0:position], next(generator), str_[position:]) def _generate_unique_number(): i = 1 while True: yield ' ({})'.format(i) i += 1 if is_unique_func(str_): return str_ if position is None: position = len(str_) if generator is None: generator = _generate_unique_number() uniq_str = _get_uniquified_string(generator) while not is_unique_func(uniq_str): uniq_str = _get_uniquified_string(generator) return uniq_str