+
    Ji	,              	          R t ^ RIt^ RIt^ RIHtHt ^ RIHt ^ RIH	t	H
t
HtHt ^RIHt ^RIHt ^RIHtHt R/RRR	RR
RR]/R R lllt]! RR]R7      R R l4       t]! RR7      R 4       t]! RRR7      R 4       t]! RR7      R 4       t]! RRR7      R 4       t]! RRR7      R 4       t]! RRR7      R0R  l4       t]! RR7      R! 4       t]! RR7      R" 4       t]! RR7      R# 4       t ]! RR7      R1R$ l4       t!]! RR7      R2R% l4       t"]! RR7      R& 4       t#]! RR7      R' 4       t$]! ]PJ                  R(RR7      t%]! ]PL                  R)RR7      t&]! ]PN                  R*RR7      t']! ]PP                  R+RR7      t(]! ]PR                  R,RR7      t)]! ]PT                  R-RR7      t*]! ]PV                  R.RR7      t+R# )3zA
Contains all deprecated functions.

.. autofunction: deprecated
N)partialwraps)	FrameType)TypeCallableOptionalcast)cli)Version)	DecoratorFreplaceversionremovecategoryc                    V ^8  d   QhR\         \        ,          R\         \        ,          R\         \        ,          R\         \        ,          R\        \        ,          R\
        /# )   funcr   r   r   r   return)r   r   strr   Warningr   )formats   "2lib/python3.14/site-packages/semver/_deprecated.py__annotate__r      sb     A A
1+A c]A c]	A
 SMA 7mA A    c               v   a aaaa S f   \        \        SSSSR7      # \        S 4      R VV VVV3R ll4       pV# )a&  
Decorates a function to output a deprecation warning.

:param func: the function to decorate
:param replace: the function to replace (use the full qualified
    name like ``semver.version.Version.bump_major``.
:param version: the first version when this function was deprecated.
:param category: allow you to specify the deprecation warning class
    of your choice. By default, it's  :class:`DeprecationWarning`, but
    you can choose :class:`PendingDeprecationWarning` or a custom class.
:return: decorated function which is marked as deprecated
)r   r   r   r   c                >    V ^8  d   QhR\         R\        3,          /# )r   r   .)r   r   )r   s   "r   r    deprecated.<locals>.__annotate__1   s      %  %HS!V$4  %r   c                    < R .pS'       d   VP                  R4       S	'       g   VP                  R4       MVP                  \        S	4      4       S
'       d   VP                  R4       MVP                  R4       \        \        S4      P                  pS
;'       g    Tp\        \
        \        \
        \        P                  ! 4       4      P                  4      pRP                  V4      p\        P                  ! VP                  W4SR7      S\        P                  ! VP                  4      VP                  R7       ?S! V / VB # )z$Function 'semver.{f}' is deprecated.zDeprecated since version {v}. z*This function will be removed in semver 3.zUse {r!r} instead.z0Use the respective 'semver.Version.{r}' instead. )frv)r   filenamelineno)appendr   r   r   __qualname__r   inspectcurrentframef_backjoinwarningswarn_explicitr   getfilef_codef_lineno)argskwargsmsg_listr    r!   framemsgr   r   r   r   r   s   *,     r   wrapperdeprecated.<locals>.wrapper0   s    :;OO<=OOHIOOCK(OO01OONODM&&LLqYY0D0D0F G N NOhhx JJ7J+__U\\2>>		
 T$V$$r   )r   
deprecatedr   )r   r   r   r   r   r5   s   fdddd r   r7   r7      sK    * |
 	
 4[ %  %  %D Nr   z3.0.0z$Still under investigation, see #258.)r   r   r   c                <    V ^8  d   QhR\         R\         R\        /# )r   ver1ver2r   )r   int)r   s   "r   r   r   [   s!     - -# -S -S -r   c                L    \         P                  ! V 4      P                  V4      # )a  
Compare two versions strings.

.. deprecated:: 3.0.0
   The situation of this function is unclear and it might
   disappear in the future.
   If possible, use :meth:`semver.version.Version.compare`.
   See :gh:`258` for details.

:param ver1: first version string
:param ver2: second version string
:return: The return value is negative if ver1 < ver2,
         zero if ver1 == ver2 and strictly positive if ver1 > ver2

>>> semver.compare("1.0.0", "2.0.0")
-1
>>> semver.compare("2.0.0", "1.0.0")
1
>>> semver.compare("2.0.0", "2.0.0")
0
)r
   parsecomparer9   r:   s   &&r   r>   r>   V   s    6 ==&&t,,r   z2.10.0r   c                J    \         P                  ! V 4      P                  4       # )a   
Parse version to major, minor, patch, pre-release, build parts.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.parse` instead.

:param version: version string
:return: dictionary with the keys 'build', 'major', 'minor', 'patch',
         and 'prerelease'. The prerelease or build keys can be None
         if not provided
:rtype: dict

>>> ver = semver.parse('3.4.5-pre.2+build.4')
>>> ver['major']
3
>>> ver['minor']
4
>>> ver['patch']
5
>>> ver['prerelease']
'pre.2'
>>> ver['build']
'build.4'
)r
   r=   to_dictr@   s   &r   r=   r=   t   s    4 ==!))++r   zsemver.version.Version.parse)r   r   c                .    \         P                  ! V 4      # )a  
Parse version string to a Version instance.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.parse` instead.
.. versionadded:: 2.7.2
   Added :func:`semver.parse_version_info`

:param version: version string
:return: a :class:`VersionInfo` instance

>>> version_info = semver.Version.parse("3.4.5-pre.2+build.4")
>>> version_info.major
3
>>> version_info.minor
4
>>> version_info.patch
5
>>> version_info.prerelease
'pre.2'
>>> version_info.build
'build.4'
)r
   r=   r@   s   &r   parse_version_inforD      s    2 ==!!r   c                P    \         P                  ! V 4      pVP                  V4      # )a"  
Compare two versions strings through a comparison.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.match` instead.

:param str version: a version string
:param str match_expr: operator and version; valid operators are
      <   smaller than
      >   greater than
      >=  greator or equal than
      <=  smaller or equal than
      ==  equal
      !=  not equal
:return: True if the expression matches the version, otherwise False
:rtype: bool

>>> semver.match("2.0.0", ">=1.0.0")
True
>>> semver.match("1.0.0", ">1.0.0")
False
)r
   r=   match)r   
match_exprvers   && r   rF   rF      s!    0 --
 C99Z  r   maxz2.10.2c                J    \        \        W\        P                  R7      4      # )a  
Returns the greater version of two versions strings.

.. deprecated:: 2.10.2
   Use :func:`max` instead.

:param ver1: version string 1
:param ver2: version string 2
:return: the greater version of the two
:rtype: :class:`Version`

>>> semver.max_ver("1.0.0", "2.0.0")
'2.0.0'
key)r   rI   r
   r=   r?   s   &&r   max_verrM            s47==122r   minc                J    \        \        W\        P                  R7      4      # )a  
Returns the smaller version of two versions strings.

.. deprecated:: 2.10.2
   Use Use :func:`min` instead.

:param ver1: version string 1
:param ver2: version string 2
:return: the smaller version of the two
:rtype: :class:`Version`

>>> semver.min_ver("1.0.0", "2.0.0")
'1.0.0'
rK   )r   rO   r
   r=   r?   s   &&r   min_verrQ      rN   r   zstr(versionobject)c           	     .    \        \        WW#V4      4      # )a$  
Format a version string according to the Semantic Versioning specification.

.. deprecated:: 2.10.0
   Use ``str(Version(VERSION)`` instead.

:param int major: the required major part of a version
:param int minor: the required minor part of a version
:param int patch: the required patch part of a version
:param str prerelease: the optional prerelease part of a version
:param str build: the optional build part of a version
:return: the formatted string
:rtype: str

>>> semver.format_version(3, 4, 5, 'pre.2', 'build.4')
'3.4.5-pre.2+build.4'
)r   r
   )majorminorpatch
prereleasebuilds   &&&&&r   format_versionrX      s    & wuU>??r   c                \    \        \        P                  ! V 4      P                  4       4      # )z
Raise the major part of the version string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.bump_major` instead.

:param: version string
:return: the raised version string
:rtype: str

>>> semver.bump_major("3.4.5")
'4.0.0'
)r   r
   r=   
bump_majorr@   s   &r   rZ   rZ     !     w}}W%00233r   c                \    \        \        P                  ! V 4      P                  4       4      # )z
Raise the minor part of the version string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.bump_minor` instead.

:param: version string
:return: the raised version string
:rtype: str

>>> semver.bump_minor("3.4.5")
'3.5.0'
)r   r
   r=   
bump_minorr@   s   &r   r]   r]     r[   r   c                \    \        \        P                  ! V 4      P                  4       4      # )z
Raise the patch part of the version string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.bump_patch` instead.

:param: version string
:return: the raised version string
:rtype: str

>>> semver.bump_patch("3.4.5")
'3.4.6'
)r   r
   r=   
bump_patchr@   s   &r   r_   r_   )  r[   r   c                ^    \        \        P                  ! V 4      P                  V4      4      # )a2  
Raise the prerelease part of the version string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.bump_prerelease` instead.

:param version: version string
:param token: defaults to 'rc'
:return: the raised version string
:rtype: str

>>> semver.bump_prerelease('3.4.5', 'dev')
'3.4.5-dev.1'
)r   r
   r=   bump_prereleaser   tokens   &&r   ra   ra   ;  s#      w}}W%55e<==r   c                ^    \        \        P                  ! V 4      P                  V4      4      # )a4  
Raise the build part of the version string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.bump_build` instead.

:param version: version string
:param token: defaults to 'build'
:return: the raised version string
:rtype: str

>>> semver.bump_build('3.4.5-rc.1+build.9')
'3.4.5-rc.1+build.10'
)r   r
   r=   
bump_buildrb   s   &&r   re   re   N  s#      w}}W%00788r   c                `    \         P                  ! V 4      p\        VP                  4       4      # )a\  
Remove any prerelease and build metadata from the version string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.finalize_version` instead.

.. versionadded:: 2.7.9
   Added :func:`finalize_version`

:param version: version string
:return: the finalized version string
:rtype: str

>>> semver.finalize_version('1.2.3-rc.5')
'1.2.3'
)r
   r=   r   finalize_version)r   verinfos   & r   rg   rg   a  s&    $ mmG$Gw'')**r   c                `    \        \        P                  ! V 4      P                  ! R/ VB 4      # )a  
Replace one or more parts of a version and return the new string.

.. deprecated:: 2.10.0
   Use :meth:`~semver.version.Version.replace` instead.
.. versionadded:: 2.9.0
   Added :func:`replace`

:param version: the version string to replace
:param parts: the parts to be updated. Valid keys are:
  ``major``, ``minor``, ``patch``, ``prerelease``, or ``build``
:return: the replaced version string
:raises TypeError: if ``parts`` contains invalid keys

>>> import semver
>>> semver.replace("1.2.3", major=2, patch=10)
'2.2.10'
 )r   r
   r=   r   )r   partss   &,r   r   r   w  s&    ( w}}W%--6677r   zsemver.cli.cmd_bumpzsemver.cli.cmd_checkzsemver.cli.cmd_comparezsemver.cli.cmd_nextverzsemver.cli.createparserzsemver.cli.processzsemver.cli.main)N)NN)rc)rW   ),__doc__r'   r+   	functoolsr   r   typesr   typingr   r   r   r    r	   r   r
   _typesr   r   DeprecationWarningr7   PendingDeprecationWarningr>   r=   rD   rF   rM   rQ   rX   rZ   r]   r_   ra   re   rg   r   cmd_bump	cmd_checkcmd_comparecmd_nextvercreateparserprocessmainrj   r   r   <module>r|      sl     $  1 1    A "A "	A
 !A 1A AH 1&
-
-2 H, ,8 2HE" F"6 H! !6 E8,3 -3$ E8,3 -3$ ((;@ <@* H4 4" H4 4" H4 4" H> >$ H9 9$ H+ +* H8 8. cll,A7Ss}}.DgV	OO5w OO5w 7 S[[*>
P#(($5wGr   