+
    i                       ^ RI Ht ^ RIt^ RIt^ RIHt ^ RIHt ^ RIH	t	 ^ RIH
t
 ^ RIHt ^ RIHt ^ R	IHt ^ R
IHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIH t  ^ RIH!t! ^ RIH"t" ^ RIH#t$ ^ RIH%t% ^ RIH&t& ^ RIH't' ^ RIH(t( ^ RIH)t) ^ R I*H+t+ ^ R!I,H-t- R" R# lt.R\R% R& llt/R' R( lt0R)R$/R* R+ llt1R, R- lt2R. R/ lt3R0 R1 lt4R2 R3 lt5R4 R5 lt6R6R$R7R$R8R9/R: R; llt7R< R= lt8R> R? lt9R@ RA ltR]RB RC llt:R^RD RE llt;RF RG lt<RH RI lt=RJ RK lt>RL RM lt?RN RO lt@RP RQ ltARR RS ltBRT RU ltC]
! RV]RW7      tDRX RY ltERZ R[ ltFR# )_    )annotationsN)Mapping)IO)Iterable)TypeVar)parse_rfc3339)	Container)UnexpectedCharError)CUSTOM_ENCODERSAoT)Array)Bool)Comment)Date)DateTime)	DottedKey)Encoder)Float)InlineTable)Integer)Item)Key)	SingleKey)String)
StringType)Table)Time)Trivia
Whitespaceitem)ParserTOMLDocumentc                    V ^8  d   QhRRRR/#    stringzstr | bytesreturnr&    )formats   "+lib/python3.14/site-packages/tomlkit/api.py__annotate__r/   (   s      + ,     c                    \        V 4      # )z:
Parses a string into a TOMLDocument.

Alias for parse().
)parser*   s   &r.   loadsr4   (   s     =r0   Fc               $    V ^8  d   QhRRRRRR/# )r)   datar   	sort_keysboolr+   strr,   )r-   s   "r.   r/   r/   1   s!     % % %D %S %r0   c                   \        V \        \        \        34      '       g-   \        V \        4      '       d   \        \        V 4      VR7      p  V P                  4       #   \         d!   pR\        T 4       R2p\        T4      ThRp?ii ; i)z%
Dumps a TOMLDocument into a string.
)
_sort_keysz.Expecting Mapping or TOML Table or Container, z givenN)
isinstancer   r   r	   r   r#   dict	as_stringAttributeErrortype	TypeError)r6   r7   exmsgs   &&  r.   dumpsrD   1   s     dUK;<<gB B DJ95% ~~ %>tDzl&Qn"$%s   A B
*BB
c                    V ^8  d   QhRRRR/# )r)   fpzIO[str] | IO[bytes]r+   r&   r,   )r-   s   "r.   r/   r/   C   s        \ r0   c                4    \        V P                  4       4      # )z-
Load toml document from a file-like object.
)r2   read)rF   s   &r.   loadrI   C   s     r0   r7   c               (    V ^8  d   QhRRRRRRRR/# )	r)   r6   r   rF   zIO[str]r7   r8   r+   Noner,   )r-   s   "r.   r/   r/   J   s(     / /w /G /4 /D /r0   c               <    VP                  \        WR7      4       R# )z
Dump a TOMLDocument into a writable file stream.

:param data: a dict-like object to dump
:param sort_keys: if true, sort the keys in alphabetic order

:Example:

>>> with open("output.toml", "w") as fp:
...     tomlkit.dump(data, fp)
)r7   N)writerD   )r6   rF   r7   s   &&$r.   dumprN   J   s     HHU4-.r0   c                    V ^8  d   QhRRRR/# r(   r,   )r-   s   "r.   r/   r/   Y   s     " "+ ", "r0   c                4    \        V 4      P                  4       # )z/
Parses a string or bytes into a TOMLDocument.
)r$   r2   r3   s   &r.   r2   r2   Y   s     &>!!r0   c                   V ^8  d   QhRR/# )r)   r+   r&   r,   )r-   s   "r.   r/   r/   `   s      , r0   c                     \        4       # )z&
Returns a new TOMLDocument instance.
r%   r,   r0   r.   documentrS   `   s     >r0   c                    V ^8  d   QhRRRR/# )r)   rawz	str | intr+   r   r,   )r-   s   "r.   r/   r/   h   s       w r0   c                *    \        \        V 4      4      # )z/Create an integer item from a number or string.)r#   intrU   s   &r.   integerrY   h   s    C>r0   c                    V ^8  d   QhRRRR/# )r)   rU   zstr | floatr+   r   r,   )r-   s   "r.   r/   r/   m   s        r0   c                *    \        \        V 4      4      # )z-Create an float item from a number or string.)r#   floatrX   s   &r.   float_r]   m   s    c
r0   c                    V ^8  d   QhRRRR/# )r)   rU   r9   r+   r   r,   )r-   s   "r.   r/   r/   r   s        r0   c                    \        V R8H  4      # )z+Turn `true` or `false` into a boolean item.truer"   rX   s   &r.   booleanra   r   s    vr0   literal	multilineescapeTc          
     ,    V ^8  d   QhRRRRRRRRRR/# )	r)   rU   r9   rb   r8   rc   rd   r+   r   r,   )r-   s   "r.   r/   r/   w   s<     / /	/ / 	/
 / /r0   c               \    \         P                  ! W4      p\        P                  ! WV4      # )a  Create a string item.

By default, this function will create *single line basic* strings, but
boolean flags (e.g. ``literal=True`` and/or ``multiline=True``)
can be used for personalization.

For more information, please check the spec: `<https://toml.io/en/v1.0.0#string>`__.

Common escaping rules will be applied for basic strings.
This can be controlled by explicitly setting ``escape=False``.
Please note that, if you disable escaping, you will have to make sure that
the given strings don't contain any forbidden character or sequence.
)_StringTypeselectr   from_raw)rU   rb   rc   rd   type_s   &$$$ r.   r*   r*   w   s%    ( w2E??3v..r0   c                    V ^8  d   QhRRRR/# )r)   rU   r9   r+   r   r,   )r-   s   "r.   r/   r/            c d r0   c                    \        V 4      p\        V\        P                  4      '       g   \	        R4      h\        V4      # )zCreate a TOML date.z!date() only accepts date strings.)r   r<   	_datetimedate
ValueErrorr#   rU   values   & r.   ro   ro      3    #EeY^^,,<==;r0   c                    V ^8  d   QhRRRR/# )r)   rU   r9   r+   r   r,   )r-   s   "r.   r/   r/      rl   r0   c                    \        V 4      p\        V\        P                  4      '       g   \	        R4      h\        V4      # )zCreate a TOML time.z!time() only accepts time strings.)r   r<   rn   timerp   r#   rq   s   & r.   rv   rv      rs   r0   c                    V ^8  d   QhRRRR/# )r)   rU   r9   r+   r   r,   )r-   s   "r.   r/   r/      s      # ( r0   c                    \        V 4      p\        V\        P                  4      '       g   \	        R4      h\        V4      # )zCreate a TOML datetime.z)datetime() only accepts datetime strings.)r   r<   rn   datetimerp   r#   rq   s   & r.   ry   ry      s5    #EeY//00DEE;r0   c                    V ^8  d   QhRRRR/# )r)   rU   r9   r+   r   r,   )r-   s   "r.   r/   r/      s      s e r0   c                    \        V 4      # )zCreate an array item for its string representation.

:Example:

>>> array("[1, 2, 3]")  # Create from a string
[1, 2, 3]
>>> a = array()
>>> a.extend([1, 2, 3])  # Create from a list
>>> a
[1, 2, 3]
)rr   rX   s   &r.   arrayr|      s     :r0   c                    V ^8  d   QhRRRR/# )r)   is_super_tablezbool | Noner+   r   r,   )r-   s   "r.   r/   r/      s     ? ?+ ? ?r0   c                >    \        \        4       \        4       RV 4      # )a  Create an empty table.

:param is_super_table: if true, the table is a super table

:Example:

>>> doc = document()
>>> foo = table(True)
>>> bar = table()
>>> bar.update({'x': 1})
>>> foo.append('bar', bar)
>>> doc.append('foo', foo)
>>> print(doc.as_string())
[foo.bar]
x = 1
F)r   r	   r   )r~   s   &r.   tabler      s    " fh~>>r0   c                   V ^8  d   QhRR/# )r)   r+   r   r,   )r-   s   "r.   r/   r/      s     
8 
8k 
8r0   c                 >    \        \        4       \        4       RR7      # )zCreate an inline table.

:Example:

>>> table = inline_table()
>>> table.update({'x': 1, 'y': 2})
>>> print(table.as_string())
{x = 1, y = 2}
T)new)r   r	   r   r,   r0   r.   inline_tabler      s     y{FH$77r0   c                   V ^8  d   QhRR/# )r)   r+   r   r,   )r-   s   "r.   r/   r/      s      S r0   c                     \        . 4      # )zCreate an array of table.

:Example:

>>> doc = document()
>>> aot = aot()
>>> aot.append(item({'x': 1}))
>>> doc.append('foo', aot)
>>> print(doc.as_string())
[[foo]]
x = 1
r   r,   r0   r.   aotr      s     r7Nr0   c                    V ^8  d   QhRRRR/# )r)   kzstr | Iterable[str]r+   r   r,   )r-   s   "r.   r/   r/      s     , , ,3 ,r0   c                    \        V \        4      '       d   \        V 4      # \        V  Uu. uF  p\	        V4      NK  	  up4      # u upi )zCreate a key from a string. When a list of string is given,
it will create a dotted key.

:Example:

>>> doc = document()
>>> doc.append(key('foo'), 1)
>>> doc.append(key(['bar', 'baz']), 2)
>>> print(doc.as_string())
foo = 1
bar.baz = 2
)r<   r9   r   r   key)r   _ks   & r.   r   r      s<     !S|*"c"g*++*s   Ac                    V ^8  d   QhRRRR/# )r)   rU   r9   r+   _Itemr,   )r-   s   "r.   r/   r/      s      s u r0   c                    \        V 4      pVP                  4       pVP                  4       '       g"   VP                  \        VP
                  R7      hV# )zyParse a simple value from a string.

:Example:

>>> value("1")
1
>>> value("true")
True
>>> value("[1, 2, 3]")
[1, 2, 3]
)char)r$   _parse_valueendparse_errorr
   _current)rU   parservs   &  r.   rr   rr      sF     C[FA::<<  !46?? KKHr0   c                    V ^8  d   QhRRRR/# )r)   srcr9   r+   ztuple[Key, _Item]r,   )r-   s   "r.   r/   r/     s     * *3 *, *r0   c                4    \        V 4      P                  4       # )z[Parse a key-value pair from a string.

:Example:

>>> key_value("foo = 1")
(Key('foo'), 1)
)r$   _parse_key_valuer   s   &r.   	key_valuer     s     #;''))r0   c                    V ^8  d   QhRRRR/# )r)   r   r9   r+   r!   r,   )r-   s   "r.   r/   r/     s     ' 'C 'J 'r0   c                    \        V RR7      # )z"Create a whitespace from a string.T)fixedr    r   s   &r.   wsr     s    c&&r0   c                   V ^8  d   QhRR/# )r)   r+   r!   r,   )r-   s   "r.   r/   r/     s      J r0   c                     \        R4      # )zCreate a newline item.
)r   r,   r0   r.   nlr     s    d8Or0   c                    V ^8  d   QhRRRR/# )r)   r*   r9   r+   r   r,   )r-   s   "r.   r/   r/   $  s     C CC CG Cr0   c                <    \        \        RRV ,           R7      4      # )zCreate a comment item.z  z# )
comment_wscomment)r   r   r3   s   &r.   r   r   $  s    6T4&=ABBr0   E)boundc                    V ^8  d   QhRRRR/# )r)   encoderr   r+   r,   )r-   s   "r.   r/   r/   ,  s      a A r0   c                2    \         P                  ! V 4       V # )zAdd a custom encoder, which should be a function that will be called
if the value can't otherwise be converted. It should takes a single value
and return a TOMLKit item or raise a ``ConvertError``.
)r   appendr   s   &r.   register_encoderr   ,  s    
 7#Nr0   c                    V ^8  d   QhRRRR/# )r)   r   r   r+   rK   r,   )r-   s   "r.   r/   r/   5  s     ( ( (D (r0   c                    \         P                  ! \        4      ;_uu_ 4        \        P                  ! V 4       RRR4       R#   + '       g   i     R# ; i)zUnregister a custom encoder.N)
contextlibsuppressrp   r   remover   s   &r.   unregister_encoderr   5  s0    			Z	(	(w' 
)	(	(	(s   AA	)F)z[])N)G
__future__r   r   ry   rn   collections.abcr   typingr   r   r   tomlkit._utilsr   tomlkit.containerr	   tomlkit.exceptionsr
   tomlkit.itemsr   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rg   r   r   r   r!   r#   tomlkit.parserr$   tomlkit.toml_documentr&   r4   rD   rI   rN   r2   rS   rY   r]   ra   r*   ro   rv   r|   r   r   r   r   rr   r   r   r   r   r   r   r   r,   r0   r.   <module>r      s   "   #    ( ' 2 )    !  " # !  % ! '  #   3     $  ! .%$/% /"


/ / 	/
 /0?(
8 ,$&*'

C
 Cw(r0   