Current File : //lib/python3/dist-packages/janitor/plugincore/__pycache__/cruft.cpython-312.pyc
�
QK f� � �H � e Zd gZddlmZ e� ZddlmZ G d� d � Zy)�Cruft� )�
setup_gettext)�UnimplementedMethodc � � e Zd ZdZd� Zed� � Zd� Zed� � Zd� Z ed� � Z
d� Z ed � � Z d
� Z
d � Zed � � Zd
� Zed� � Zd� Zy)r a3 One piece of cruft to be cleaned out.
A piece of cruft can be a file, a package, a configuration tweak that is
missing, or something else.
This is a base class, which does nothing. Subclasses do the actual work,
though they must override the `get_shortname()` and `cleanup()` methods.
c �. � | j j S )a� Return the unique prefix used to group this type of cruft.
For example, the .deb package called 'foo' would have a prefix
of 'deb'. This way, the package foo is not confused with the
file foo, or the username foo.
Subclasses SHOULD define this. The default implementation
returns the name of the class, which is rarely useful to
the user.
)� __class__�__name__��selfs �:/usr/lib/python3/dist-packages/janitor/plugincore/cruft.py�
get_prefixzCruft.get_prefix% s � � �~�~�&�&�&� c �" � | j � S �N)r
r
s r �prefixz Cruft.prefix2 s � ���� � r c �" � | j � S )z4Return human-readable description of class of cruft.��get_descriptionr
s r �get_prefix_descriptionz Cruft.get_prefix_description6 � � ��#�#�%�%r c �" � | j � S r )r r
s r �prefix_descriptionzCruft.prefix_description: s � ��*�*�,�,r c �, � t | j � �)a� Return the name of this piece of cruft.
The name should be something that the user will understand. For
example, it might be the name of a package, or the full path to a
file.
The name should be unique within the unique prefix returned by
`get_prefix()`. The prefix MUST NOT be included by this method, the
`get_name()` method does that instead. The intent is that
`get_shortname()` will be used by the user interface in contexts where
the prefix is shown separately from the short name, and `get_name()`
when a single string is used.
Subclasses MUST define this. The default implementation raises an
exception.
)r �
get_shortnamer
s r r zCruft.get_shortname> s � �" "�$�"4�"4�5�5r c �" � | j � S r )r r
s r � shortnamezCruft.shortnameQ s � ��!�!�#�#r c �N � dj | j | j � S )aJ Return prefix plus name.
See `get_prefix()` and `get_shortname()` for a discussion of the
prefix and the short name. This method will return the prefix, a
colon, and the short name.
The long name will used to store state/configuration data: _this_
package should not be removed.
z{}:{})�formatr r r
s r �get_namezCruft.get_nameU s � � �~�~�d�k�k�4�>�>�:�:r c �" � | j � S r )r r
s r �namez
Cruft.namea s � ��}�}�� r c �b � dj | j j | j � S )Nz <{} "{}">)r r r r! r
s r �__repr__zCruft.__repr__e s# � ��!�!�$�.�.�"9�"9�4�9�9�E�Er c � � y)a� Return a description of this piece of cruft.
This may be arbitrarily long. The user interface will take care of
breaking it into lines or otherwise presenting it to the user in a
nice manner. The description should be plain text UTF-8 unicode.
The default implementation returns the empty string. Subclasses MAY
override this as they wish.
� � r
s r r zCruft.get_descriptionh s � � r c �" � | j � S r r r
s r � descriptionzCruft.descriptiont r r c � � y)a` Return amount of disk space reserved by this piece of cruft.
The unit is bytes.
The disk space in question should be the amount that will be freed if
the cruft is cleaned up. The amount may be an estimate (i.e. a
guess). It is intended to be shown to the user to help them decide
what to remove and what to keep.
This will also be used by the user interface to better estimate how
much remaining time there is when cleaning up a lot of cruft.
For some types of cruft, this is not applicable and they should return
`None`. The base class implementation does that, so subclasses MUST
define this method if it is useful for them to return something else.
The user interface will distinguish between None (not applicable) and
0 (no disk space being used).
Nr& r
s r �get_disk_usagezCruft.get_disk_usagex s � �( r c �" � | j � S r )r* r
s r �
disk_usagezCruft.disk_usage� s � ��"�"�$�$r c �, � t | j � �)a Clean up this piece of cruft.
Depending on the type of cruft, this may mean removing files,
packages, modifying configuration files, or something else.
The default implementation raises an exception. Subclasses MUST
override this.
)r �cleanupr
s r r. z
Cruft.cleanup� s � � "�$�,�,�/�/r N)r �
__module__� __qualname__�__doc__r
�propertyr r r r r r r! r# r r( r* r, r. r& r r r r s� � �� '� �!� �!�&� �-� �-�6�& �$� �$�
;� � � � �F�
� �&� �&��, �%� �%� 0r N) �type�
__metaclass__�__all__�janitor.plugincore.i18nr �_� janitor.plugincore.exceptionsr r r& r r �<module>r9 s0 �� �
� �)�� 2��O�� >�@0� @0r
Mini Shell