o gw@sddlmZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl Z ddl mZe dddgZdd Zd d Zeejd d dZdddZGdddeZGdddeZGdddeeZddZedkr~eedSdS))print_functionN) namedtuple)MutableMapping PropertyTupledatametacCs,t|tjr |dpt|tjo|dS)z Check whether a metadata key refers to "runtime metadata" that should not be dumped when writing out property files. Such keys are those starting with two underscores, e. g. ``__foo``. Handles both unicode and byte metadata keys. __s__) isinstancesix text_type startswith binary_type)keyrX/var/www/html/portale_awareness/portale-venv/lib/python3.10/site-packages/jproperties.py_is_runtime_meta3s rcCs2dd}t|tjr|d}ttd||S)a Escape non-printable (or non-ASCII) characters using Java-compatible Unicode escape sequences. This function is based on code from the JSON library module shipped with Python 2.7.3 (json/encoder.py, function py_encode_basestring_ascii), which is Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006 Python Software Foundation; All Rights Reserved. See the file LICENSE included with jProperties for the full license terms. If that file is not available, then please see: https://www.python.org/download/releases/2.7.3/license/ Differences to the aforementioned original version of py_encode_basestring_ascii(): - Always tries to decode str objects as UTF-8, even if they don't contain any UTF-8 characters. This is so that we always return an unicode object. - Only processes non-printable or non-ASCII characters. Also _always_ replaces these characters with Java-compatible Unicode escape sequences (the original function replaced e. g. newlines with " " etc.). - Does not wrap the resulting string in double quotes ("). :type unicode_obj: unicode :param unicode_obj: The source string containing data to escape. :rtype : unicode :return: A unicode object. This does not contain any non-ASCII characters anymore. cSsT|d}t|}|dkrd|S|d8}d|d?d@B}d|d@B}d||S) Nrz \u{0:04x} z\u{0:04x}\u{1:04x})groupordformat)matchsns1s2rrrreplaceYs    z"_escape_non_ascii..replaceutf-8z[^ -~])r r r decoderesubr ) unicode_objrrrr_escape_non_asciiBs r%jproperties.jbackslashreplacecCs*t|ts|t|j|j|j|jfS)a Encoding error handler which replaces invalid characters with Java-compliant Unicode escape sequences. :param err: An `:exc:UnicodeEncodeError` instance. :return: See https://docs.python.org/2/library/codecs.html?highlight=codecs#codecs.register_error )r UnicodeEncodeErrorr%objectstartend)errrrr _jbackslashreplace_error_handlerps r,FcCst|tjr |d}n t|tjst|}tddtddtddi}|sD|tdd td d td d tddtddtddi||}|sR|dd}nt dd|}|r_t |}|S)a| Escape a string so that it can safely be written as a key/value to a property file. :type raw_str: unicode :param raw_str: The string to escape. :param only_leading_spaces: Controls which whitespace characters to escape (other illegal, non-whitespace characters are always escaped). If True, then only escape a possibly present single leading space character (this is used for the value of a key-value pair). If False, escape all whitespace characters. :param escape_non_printing: Whether to escape legal, but non-printable ASCII characters as well. :param line_breaks_only: Only escape , and and not characters like : and =. Note: This does not invalidate/influence the other parameters like only_leading_spaces -- spaces are always escaped as per only_leading_spaces. :rtype : unicode :return: The escaped string. r  z\r z\n z\f#z\#!z\!=z\=:z\:\z\\ z\t z\ z^ z\\ ) r r r r!r rupdate translaterr"r#r%)raw_stronly_leading_spacesescape_non_printingline_breaks_only trans_dict escaped_strrrr _escape_strs2     r?c@seZdZdZdS) PropertyErrorz>Base exception class for all exceptions raised by this module.N)__name__ __module__ __qualname____doc__rrrrr@sr@c@s"eZdZdZdddZddZdS) ParseErrora Raised on parse errors in property files. :ivar message: The error message (string). :ivar line_number: Number of the line where the error occurred (integer). :ivar file_obj: The file object we were reading from when the error occurred (may be None). NcCs||_||_||_dS)a Create a new ParseError exception. :param message: Error message. :param line_number: Line number of error. :param file_obj: File object we were reading from when the error occurred. :return: A new :exc:`.ParseError` object. N)message line_numberfile_obj)selfrFrGrHrrr__init__s  zParseError.__init__cCs*t|jdsdn|jj}d||j|jfS)z Get a human-readable string representation of this object. :return: Human-readable string representation of this object. filenamez zParse error in %s:%d: %s)hasattrrHrKrGrF)rIrKrrr__str__s zParseError.__str__N)rArBrCrDrJrMrrrrrEs  rEcs*eZdZdZdZdZeeZd<fdd ZddZd d Z d d Z d dZ ddZ e ddZejddZejddZddZddZddZddZddZd=d d!Zd"d#Zd$d%Zdd5d6Z  d?d8d9Z!e"j#fd:d;Z$Z%S)@ Propertiesz A parser for Java property files. This class implements parsing Java property files as defined here: http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html#load(java.io.Reader) z z Tcs0tt|j|i|||_||dS)a Create a new property file parser. :param process_escapes_in_values: If False, do not process escape sequences in values when parsing and try hard not to produce any escape sequences when writing, i. e. output strings literally. However, some things like leading whitespace and newlines are always escaped (since there is not good way around this). :return: A new :class:`.Properties`. N)superrOrJ_process_escapes_in_valuesresetclear)rIprocess_escapes_in_valuesargskwargs __class__rrrJs  zProperties.__init__cCs t|jSrN)len _propertiesrIrrr__len__  zProperties.__len__cCs@t|tjs td||jvrtdt|j||j|iSN,Property keys must be of type str or unicodez Key not found) r r string_types TypeErrorrZKeyErrorr _metadataget)rIitemrrr __getitem__ s   zProperties.__getitem__cCs|t|tjs tdd}t|tr|\}}t|tjstd|dur,t|ts,td||j|<|dur<||j|<dSdS)Nr_z.Property values must be of type str or unicode!Metadata needs to be a dictionary)r r r`ratupledictrZrc)rIrvaluemetadatarrr __setitem__s    zProperties.__setitem__cCsht|tjs td||jvrtd|j|=||jvr |j|=z |j|WdSt y3YdSwr^) r r r`rarZrbrc _key_orderremove ValueErrorrIrrrr __delitem__+s    zProperties.__delitem__cCs |jSrN)rZ__iter__r[rrrrr?r]zProperties.__iter__cCs|jSrNrZr[rrr propertiesBszProperties.propertiescCs ||_dSrNrs)rIrjrrrrtF cCs i|_dSrNrsr[rrrrtKrucCs|j|iS)z Get the metadata for a key. :param key: The key to get metadata for. :return: Metadata for the key (always a dictionary, but empty if there is no metadata). )rcrdrprrrgetmetaPszProperties.getmetacCs t|ts td||j|<dS)av Set the metadata for a key. If the key starts with "__", then it is added, but will not be output when the file is written. :param key: The key to set the metadata for. :param metadata: The metadata to set for the key. Needs to be a dictionary. :return: None. :raise: TypeError if the metadata is not a dictionary. rgN)r rirarc)rIrrkrrrsetmetaYs zProperties.setmetacCs0|jdur|jd}|dkrt||_|jS)a Peek at the next character in the input stream. This implements a lookahead of one character. Use _getc() to actually read (or skip) the next character. Repeated calls to this method return the same character unless _getc() is called inbetween. :return: Next character in input stream. :raise: EOFError on EOF. IOError on other errors. N) _lookahead _source_filereadEOFErrorrIcrrr_peekis zProperties._peekcCs|}d|_|S)aB Read the next character from the input stream and return it. To only peek at the next character, use _peek(). Calling _getc() honors a possibly present lookahead and clears it. :return: Next character in input stream. :raise: EOFError on EOF and IOError on other errors. N)rrzr~rrr_getc~s zProperties._getccCs|}|dkr.|jd7_|z|dkr!|WdSWdSty-YdSw|dkr?|jd7_|dSdS)z Skip a line terminator sequence (on of , or ) and increment the line number counter. This method is a no-op if the next character in the input stream is not or . :return: None. :raise: EOFError, IOError. r-rxr.N)r _line_numberrr}r~rrr _handle_eols    zProperties._handle_eolFcCs> |}||jvr dS||jvr|rdS|n|q)a& Skip all adjacent whitespace in the input stream. Properly increments the line number counter when encountering line terminators. :param stop_at_eol: Determines whether to skip line terminators as well. :return: None :raise: EOFError, IOError TN)r_ALLWHITESPACE_EOLrr)rI stop_at_eolrrrr_skip_whitespaces    zProperties._skip_whitespacecCsPd}z||jvr||7}||jvs |W|Sty'Y|Sw)zSkip a natural line. This simply skips all characters until a line terminator sequence is encountered (which is skipped as well). :return: The text on the line. :raise: IOError. ry)rrrrr})rIlinerrr_skip_natural_lines    zProperties._skip_natural_linecCs||dkr9|}|jr7|jr7|j|ji}|dd|dr-|dd}|d|d7<dS||d}| d}t |sSt d |j |j ||j|<dS) a Parse a comment line. Usually, comment lines are simply skipped, as expected. However, if the character AFTER the comment line marker (i. e. the hash or the colon) is a colon, then the line is parsed for a key-value pair (except that line continuation is disabled) and the resulting pair is recorded as metadata for the NEXT, real key-value pair. :return: None. :raise: EOFError and IOError. r3_docryr6rxNr.Tz$Empty key in metadata key-value pair)rrr_metadoc _prev_keyrc setdefaultr _parse_key _parse_valuerYrErr{_next_metadata)rIdocstr prev_metadatarrjrrr_parse_comments(       zProperties._parse_commentc Cs|dkr |z|}Wn tyYdSw||jvr;|r9z ||dWdSty8YdSwdS||dvrItd|S|dkr|j}zd}tdD]}||7}qWt |dd }d |krpd krnn^d}ztd D]}||7}qyWn tyYnw|d ddkst |d krt d||j t |dd dd }d|krdksnt d||j d} | |d@d>7} | |d@7} | }t d|dWSttfy} z t t| ||j d } ~ ww|S)aHandle escape sequences like , etc. Also handles line continuation. :param allow_line_continuation: If True, fold multiple natural lines into a single logical line if the line terminator is escaped. If False, then ignore line continuation attempts and drop the backslash used to escape the line terminator. :return: The evaluated escape sequence (string). :raise: EOFError and IOError. r4ryTrntfzu'\%s'u)baseriNz\uzgHigh surrogate unicode escape sequence not followed by another (low surrogate) unicode escape sequence.rizLow surrogate unicode escape sequence expected after high surrogate escape sequence, but got a non-low-surrogate unicode escape sequence.rrrz=Izutf-32)rrr}rrrevalrrangeintrYrEr{structpackr!rostr) rIallow_line_continuation escaped_charstart_linenumber codepoint_hexi codepointcodepoint2_hex codepoint2final_codepointerrr_handle_escapesp            zProperties._handle_escapecCsr||d} z|}Wn tyY|Sw|dkr&||| 7}q||jvs/|dvr2 |S||7}q)a2Parse and return the key of a key-value pair, possibly split over multiple natural lines. :param single_line_only: True to ignore line continuation, False to allow it. :rtype : unicode :return: The key, which may be empty. :raise: IOError, EOFError and ParseError. ryTr4:=)rrr}rrr)rIsingle_line_onlyrrrrrr`s"    zProperties._parse_keycCsz|d|dvr||dWn ty YdSwd} z|}Wn ty4Y|Sw|dkrE|jrE||| 7}q#||jvrQ| |S||7}q$)aI Parse and return the value of a key-value pair, possibly split over multiple natural lines. :param single_line_only: True to ignore line continuation, False to allow it. :rtype : unicode :return: The value, which may be an empty string. :raise: IOError, EOFError and ParseError. Trryr4)rrrr}rQrrr)rIrrjrrrrrs2       zProperties._parse_valuecCsz ||}Wn tyYdSw|dvr+z|WdSty*YdSwz |}|}Wn ty?YdSw||jvrK|j|||j|<t |j r^|j |j |<i|_ ||_ dS)a' Parse a single logical line which may consist of multiple natural lines. Actually this may skip multiple empty natural lines at once and thus "parse" multiple (empty) logical lines (since an empty natural line is a single logical line). In practice, this does not matter. :return: False if there is nothing more to parse, True if this method should be called again to continue parsing. A return value of False means that EOF was encountered in a non-error state. :raise: ParseError. Fz!#T) rrr}rrrrZrmappendrYrrcr)rIrrrjrrr_parse_logical_lines6            zProperties._parse_logical_linecCs|r |sdSdS)z Parse the entire input stream and record parsed key-value pairs. :return: None. :raise: See :meth:`._parse__parse_logical_line`. N)rr[rrr_parseszProperties._parsecCs(d|_d|_d|_i|_d|_||_dS)z Reset the parser state so that a new file can be parsed. Does not clear the internal property list so that multiple files can parsed consecutively. :return: None Nrx)r{rrzrrr)rImetadocrrrrRs   zProperties.resetcCsi|_i|_g|_dS)zU Remove all properties and related metadata. :return: None. N)rZrcrmr[rrrrSs zProperties.clear iso-8859-1cCsp||t|tjrt|||_nt|tjr"t||_n|dur/t |||_n||_| dS)aa Load, decode and parse an input stream (or string). :param source_data: Input data to parse. May be a :class:`str` which will be decoded according to `encoding`, a :class:`unicode` object or a file-like object. In the last case, if `encoding` is None, the file-like object is expected to provide transparent decoding to :class:`unicode` (see :func:`codecs.open`); otherwise, if `encoding` is not None, then data from the file-like object will be decoded using that encoding. :param encoding: If `source_data` is a :class:`str`, this specifies what encoding should be used to decode it. :return: None :raise: IOError, EOFError, ParseError, UnicodeDecodeError (if source_data needs to be decoded), LookupError (if encoding is unknown). N) rRr r r StringIOr!r{r codecs getreaderr)rI source_dataencodingrrrrloads    zProperties.loadNc Cst|}||d}|o|tdk} |dur5tdd|}tdd|}tdd |}td ||d |r_gd } gd } t} td| | j| | j d| j | j | j | j | jf|d t|j} t|j}| |8} t| }|t|j|D]H}||jvr||}|st|rt|D]}t|rqtdt|t||df|d qtdt|| dt|j|d| |j df|d q|dS)a Write a plain text representation of the properties to a stream. :param out_stream: The target stream where the data should be written. Should be opened in binary mode. :type initial_comments: unicode :param initial_comments: A string to output as an initial comment (a commented "header"). May safely contain unescaped line terminators. :param encoding: The encoding to write the data in. :param strict: Set to True to exactly behave like the Java property file writer. In particular, this will cause any non-printing characters in property keys and values to be escaped using "uXXXX" escape sequences if the encoding is set to iso-8859-1. False causes sane behaviour, i. e. only use unicode escape sequences if the characters cannot be represented in the target encoding. :param strip_meta: Whether to strip metadata when writing. :param timestamp: True to write a comment line with the current time and date after the initial comments. :return: None. :raise: LookupError (if encoding is unknown), IOError, UnicodeEncodeError (if data cannot be encoded as `encoding`. r&latin_1Nz (\r\n|\r)r.z \n(?![#!])z #z (\n[#!]):z\g<1>\:r0file)MonTueWedThuFriSatSun) JanFebMarAprMayJunJulAugSepOctNovDecz##%s %s %02d %02d:%02d:%02d UTC %04drxz#: %s=%sT%s=%s)r;)r;r<)rlookup streamwriterr"r#printtimegmtimetm_wdaytm_montm_mdaytm_hourtm_mintm_sectm_yearsetrZrmlistsort itertoolschainrvrYsortedrr?rQ)rI out_streaminitial_commentsrstrict strip_meta timestampout_codec_infowrapped_out_streamproperties_escape_nonprinting day_of_weekmonthnowunordered_keys ordered_keysunordered_keys_xsrrkmkeyrrrstore6s             zProperties.storecCs:td|d|jD]}d||j|f}t||dq dS)z Debugging method: Print an unsorted list of properties to `out_stream`. :param out_stream: Where to print the property list. :return: None z-- listing properties --rrN)rrZ)rIrrmsgrrrrs  zProperties.list)T)F)rF)NrTTT)&rArBrCrDr _WHITESPACErrJr\rfrlrqrrpropertyrtsetterdeleterrvrwrrrrrrrrrrrrRrSrrsysstderrr __classcell__rrrWrrOsL       . \ +4  # rOc Cstjtjd}ttjdkstjddkrZtdtjdtdtjdtdtjdtd |tjdtd tjdtd tjdtd tjdtd tjdtdtjddSttjdkrcdntjd}ttjdkrqdntjd}ttjdkptjddk}zt tjdd}t |}| ||Wn t t tttfy}ztd|tjdWYd}~dSd}~wwz|tjrtjjntjd||f|dWdStt tfy}ztd|tjdWYd}~dSd}~ww)a Main function for interactive use. Loads a property file and dumps it to stdout, optionally converting between encodings. Escape sequence handling in property values can also be disabled (it is enabled by default). Reads parameters from `sys.argv`: - Input file path. - Optional: Input file encoding, defaults to `utf-8`. - Optional: Output encoding, defaults to `utf-8`. - Optional: `false` to take escape sequences in property values literally instead of parsing them. This will also try hard not to output any escape sequences in values and thus will output everything literally, as long as this does not lead to invalid output. :rtype: int :return: 0 on success, non-zero on error. rrrxz-hzVLoads a property file and dumps it to stdout, optionally converting between encodings.rzJEscape sequence handling can also be disabled (it is enabled by default). zUsage:zI %s [-h] input_file [input_encoding [output_encoding [process_escapes]]] zNThe input and output encodings default to `utf-8'. If `false' is given for thezO`process_escapes' parameter, then escape sequences in property values are takenzNliterally, i. e. they are treated like normal characters. This will also causezOthe writer to try hard not to output any escape sequences in values and thus itzRwill output everything literally, as long as this does not lead to invalid output.r rfalserbz!Error: Could not read input file:Nz,File generated by %s (escapes in values: %s)Fz!Error: Could not dump properties:)ospathbasenamerargvrYrrloweropenrOrIOErrorr}rEUnicodeDecodeError LookupErrorrr PY3stdoutbufferr') prog_namein_encout_encrTfprrrrmainsV  r__main__)FFF) __future__rr functoolsrrr"rrr collectionsrr six.moves.collections_abcrrrr%partialregister_errorr,r? Exceptionr@rEr(rOrrAexitrrrrs<    .  >$c?