�
x[h+ �
�r � S SK r S SKrS SKrS SKJrJr S SKJr S SKJ r \R " \ 5 r " S S\5 r
\R " S S\ R " S/ S Q5 5 5 rS
\S \S \4S
jrS\R( S
\S\S\S\4
S jrSSSS.S\S\S\\ S\S\S \
4 S jjrSS .S\S\S\4S jjrg) � N)�
NamedTuple�Optional)�features)�loggersc �* � \ rS rSr% \\S' \\S' Srg)�DeprecationLog�
� log_level�message� N)�__name__�
__module__� __qualname__�__firstlineno__�int�__annotations__�str�__static_attributes__r � �5/usr/lib/python3/dist-packages/cloudinit/lifecycle.pyr r
s � ��N�
�Lr r c � ^ � \ rS rSrSr SS\S\S\S\SS 4
U 4S jjjr\S \SS 4S
j5 r S r
S r S
r S r
S rSS S\4S jrSrU =r$ )�Version� a� A class for comparing versions.
Implemented as a named tuple with all ordering methods. Comparisons
between X.Y.N and X.Y always treats the more specific number as larger.
:param major: the most significant number in a version
:param minor: next greatest significant number after major
:param patch: next greatest significant number after minor
:param rev: the least significant number in a version
:raises TypeError: If invalid arguments are given.
:raises ValueError: If invalid arguments are given.
Examples:
>>> Version(2, 9) == Version.from_str("2.9")
True
>>> Version(2, 9, 1) > Version.from_str("2.9.1")
False
>>> Version(3, 10) > Version.from_str("3.9.9.9")
True
>>> Version(3, 7) >= Version.from_str("3.7")
True
�major�minor�patch�rev�returnc �. >� [ [ U ] XX#U5 $ )zHDefault of -1 allows us to tiebreak in favor of the most specific
number)�superr �__new__)�clsr r r r � __class__s �r r! �Version.__new__/ s �� �
�W�c�*�3�u�S�I�Ir �versionc
�X � U " [ [ [ UR S5 5 5 6 $ )z�Create a Version object from a string.
:param version: A period-delimited version string, max 4 segments.
:raises TypeError: Raised if invalid arguments are given.
:raises ValueError: Raised if invalid arguments are given.
:return: A Version object.
�.)�list�mapr �split)r" r% s r �from_str�Version.from_str6 s$ � � �T�#�c�7�=�=��#5�6�7�9�9r c �* � SU R U5 :H $ )N� )�_compare_version��self�others r �__gt__�Version.__gt__C s � ��D�)�)�%�0�0�0r c �� � U R UR :H =( aY U R UR :H =( a9 U R UR :H =( a U R UR :H $ �N�r r r r r0 s r �__eq__�Version.__eq__F sX � � �J�J�%�+�+� %�
&��
�
�e�k�k�)�
&��
�
�e�k�k�)�
&� ���E�I�I�%�
r c # � # � U R U R U R U R 4 H nUS:w a [ U5 v � M g g7f)z)Iterate over the version (drop sentinels)���N)r r r r r )r1 �ns r �__iter__�Version.__iter__N s< � � ��*�*�d�j�j�$�*�*�d�h�h�?�A��B�w��!�f� �� @�s �A Ac �$ � SR U 5 $ )Nr' )�join�r1 s r �__str__�Version.__str__V s � ��x�x��~� r c �* � [ [ U 5 5 $ r6 )�hashr rA s r �__hash__�Version.__hash__Y s � ��C��I�� r r2 c �� � X:X a gU R UR :� a gU R UR :� a gU R UR :� a gU R UR :� a gg)zzCompare this Version to another.
:param other: A Version object.
:return: -1 if self > other, 1 if self < other, else 0
r r. r; r7 r0 s r r/ �Version._compare_version\ s[ � � �=�� �:�:�� � � #�� �:�:�� � � #�� �:�:�� � � #�� �8�8�e�i�i� ��r r )r; r; r; r; )r
r r r �__doc__r r! � classmethodr r+ r3 r8 r= rB rF r/ r �
__classcell__)r# s @r r r s� �� ��4 LN�J��J�%(�J�69�J�EH�J� �J� J� �
:�s�
:�y�
:� �
:�1�
�� � ��i� �C� � r r r7 r% �boundary_versionr c �p � US:H =( d+ [ R U 5 [ R U5 :* $ )z�Determine if a deprecation message should be logged.
:param version: The version in which the thing was deprecated.
:param boundary_version: The version at which deprecation level is logged.
:return: True if the message should be logged, else False.
�devel)r r+ )r% rM s r �should_log_deprecationrP p s: � � �w� &� ,�'�*:�*:��+� � � �*� +�+,� ,r �logger�requested_level�msg�argsc � � [ U[ R 5 ( a U R " X#/UQ76 gU R " U/UQ76 g)aM Log a message at the requested level, if that is acceptable.
If the log level is too high due to the version boundary, log at DEBUG
level. Useful to add new warnings to previously unguarded code without
disrupting stable downstreams.
:param logger: Logger object to log with
:param version: Version string of the version that this log was introduced
:param level: Preferred level at which this message should be logged
:param msg: Message, as passed to the logger.
:param args: Message formatting args, as passed to the logger
:return: True if the message should be logged, else False.
N)rP r �DEPRECATION_INFO_BOUNDARY�log�debug)rQ r% rR rS rT s r �log_with_downgradable_levelrY } s9 � �, �g�x�'I�'I�J�J��
�
�?�/�$�/�� � �S� �4� r � F)�
extra_message�schedule�skip_log�
deprecated�deprecated_versionr[ r\ r] c � � [ [ S5 ( d [ [ S[ 5 5 U=( d Sn[ X- U- [ U5 - 5 n[ R U5 n[
UR U- UR 5 nU SU SU SU 3R 5 n [ U[ R 5 ( d [ R n
O6[ [ S5 ( a [" R$ n
O[ R& n
[) [ S5 n U( d+ Xk; a& U R+ U5 [ R- X�5 [/ X�5 $ )a� Mark a "thing" as deprecated. Deduplicated deprecations are
logged.
:param deprecated: Noun to be deprecated. Write this as the start
of a sentence, with no period. Version and extra message will
be appended.
:param deprecated_version: The version in which the thing was
deprecated
:param extra_message: A remedy for the user's problem. A good
message will be actionable and specific (i.e., don't use a
generic "Use updated key." if the user used a deprecated key).
End the string with a period.
:param schedule: Manually set the deprecation schedule. Defaults to
5 years. Leave a comment explaining your reason for deviation if
setting this value.
:param skip_log: Return log text rather than logging it. Useful for
running prior to logging setup.
:return: NamedTuple containing log level and log message
DeprecationLog(level: int, message: str)
Note: uses keyword-only arguments to improve legibility
rW � z is deprecated in z and scheduled to be removed in z. r^ )�hasattr� deprecate�setattr�setrE r r r+ r r �rstriprP r rV �logging�INFO�LOGr �
DEPRECATED�WARN�getattr�addrW r ) r^ r_ r[ r\ r] r �dedupr% �version_removed�
deprecate_msg�level� log_caches r rc rc � s � �< �9�e� $� $�� �5�#�%�(��!�r�G� ��%�(:�:�S��]�J� K�E�� � � 1�2�G� �g�m�m�h� 6��
�
�F�O� �,�(� �
� >� �
�2�g�Y� (�
�f�h� �
"��H� >� >� � � � � �� ��l� #� #��"�"��� � ��� �5�)�I� ��.��
�
�e� � ����%� �%� /�/r )r\ c � ^ ^^� U UU4S jnU$ )aN Mark a "thing" as deprecated. Deduplicated deprecations are
logged.
:param deprecated_version: The version in which the thing was
deprecated
:param extra_message: A remedy for the user's problem. A good
message will be actionable and specific (i.e., don't use a
generic "Use updated key." if the user used a deprecated key).
End the string with a period.
:param schedule: Manually set the deprecation schedule. Defaults to
5 years. Leave a comment explaining your reason for deviation if
setting this value.
Note: uses keyword-only arguments to improve legibility
c �N >^ � [ R " T 5 UUU U4S j5 nU$ )Nc �D >� T" U 0 UD6n[ TTR TTS9 U$ )N)r_ r^ r[ r\ )rc r
)rT �kwargs�outr_ r[ �funcr\ s ����r � decorator�2deprecate_call.<locals>.wrapper.<locals>.decorator� s3 �� � ��'��'�C� �#5� �=�=� +�!�
� �Jr )� functools�wraps)rx ry r_ r[ r\ s ` ���r �wrapper� deprecate_call.<locals>.wrapper� s& �� � � � �� � �
� � �r r )r_ r[ r\ r} s ``` r �deprecate_callr � s �� �&
� �Nr )� collectionsr{ rg �typingr r � cloudinitr �
cloudinit.logr � getLoggerr
ri r �total_ordering�
namedtupler r �boolrP �Loggerr �tuplerY rc r r r r �<module>r� s. �� � � � '� � !�
����!���Z� �
���Z����9�&H�I�Z� �Z�z
,�C�
,�3�
,�4�
,�!� �N�N�!� �!� � !�
� !� �
!�@ $(���
50��50� �50� �C�=� 50�
� 50� �
50� �50�r EF�"� �"�/2�"�>A�"r