�
x6�g7 � �H � S r SSKrSSKrSSKrSSKrSSKJr " S S5 rg)�$Abstraction of packaging operations.� N)�Iterablec �n � \ rS rSrSrSrS rS\S\4S jrS\S\ \ 4S jr
S\S\4S jr S\S\S
- 4S jr S\S\
4S jrS\S\4S
jrS rS\S\ \ 4S jrS r S4S\S\
S\S
- S\S
- S\S
- S\S
- 4 S jjr\S\4S j5 r\S\4S j5 rS\4S jrS\SS
4S jrS5S jrS \S \S\4S jrS\
4S jr S\4S! jr S6S"\S#\S
- S\S$\ \ \\S
- 4 S%\
S&\S
- S'\
S(\S
- S)\ \ S
- S*\
S+\
S\4S, jjr S- r!S\S\
4S. jr"S\4S/ jr#S
r$\S0\S\4S1 j5 r%S\ \\4 4S2 jr&S3r'g
)7� PackageInfo� r z/etc/default/apportc � � [ S5 e)zXReturn the installed version of a package.
Throw ValueError if package does not exist.
�6this method must be implemented by a concrete subclass��NotImplementedError��self�packages �2/usr/lib/python3/dist-packages/apport/packaging.py� get_version�PackageInfo.get_version � � �
"� D�
�
� r �returnc � � [ S5 e)z_Return the latest available version of a package.
Throw ValueError if package does not exist.
r r
r s r �get_available_version�!PackageInfo.get_available_version" r r c � � [ S5 e)z/Return a list of packages a package depends on.r r
r s r �get_dependencies� PackageInfo.get_dependencies+ � � �!� D�
�
r c � � [ S5 e)z[Return the source package name for a package.
Throw ValueError if package does not exist.
r r
r s r �
get_source�PackageInfo.get_source1 r r Nc � � [ S5 e)z�Return package origin.
Return the repository name from which a package was installed, or None
if it cannot be determined.
Throw ValueError if package is not installed.
r r
r s r �get_package_origin� PackageInfo.get_package_origin: � � � "� D�
�
r c � � [ S5 e)z�Check package origin.
Return True if the package is a genuine distro package, or False if it
comes from a third-party source.
Throw ValueError if package does not exist.
r r
r s r �is_distro_package� PackageInfo.is_distro_packageF r" r c � � [ S5 e)z�Return the architecture of a package.
This might differ on multiarch architectures (e. g. an i386 Firefox
package on a x86_64 system)
r r
r s r �get_architecture� PackageInfo.get_architectureR � � � "� D�
�
r c � � [ S5 e)zXReturn list of files shipped by a package.
Throw ValueError if package does not exist.
r r
r s r � get_files�PackageInfo.get_files\ r r c � � [ S5 e)z/Return list of all modified files of a package.r r
r s r �get_modified_files� PackageInfo.get_modified_filese r r c � � 0 $ )a Return modified configuration files of a package.
Return a file name -> file contents map of all configuration files of
package. Please note that apport.hookutils.attach_conffiles() is the
official user-facing API for this, which will ask for confirmation and
allows filtering.
� r s r �get_modified_conffiles�"PackageInfo.get_modified_conffilesk s � � � r �file� uninstalled� map_cachedir�release�archc � � [ S5 e)a( Return the package a file belongs to.
Return None if the file is not shipped by any package.
If uninstalled is True, this will also find files of uninstalled
packages; this is very expensive, though, and needs network access and
lots of CPU and I/O resources. In this case, map_cachedir can be set to
an existing directory which will be used to permanently store the
downloaded maps. If it is not set, a temporary directory will be used.
Also, release and arch can be set to a foreign release/architecture
instead of the one from the current system.
r r
)r
r4 r5 r6 r7 r8 s r �get_file_package� PackageInfo.get_file_packagew s � �( "� D�
�
r c � � [ S5 e)zeReturn the architecture of the system.
This should use the notation of the particular distribution.
r r
r1 r r �get_system_architecture�#PackageInfo.get_system_architecture� r) r c � � [ S5 e)zvReturn the GNU multiarch triplet for of the system architecture, if
applicable, raises NotImplementedError otherwise.
zDthis method must be implemented by a concrete subclass if applicabler
r1 r r � get_native_multiarch_triplet�(PackageInfo.get_native_multiarch_triplet� s � �
"� R�
�
r c � � g)z�Return a list of default library search paths.
The entries should be separated with a colon ':', like for
$LD_LIBRARY_PATH. This needs to take any multiarch directories into
account.
z
/lib:/usr/libr1 �r
s r �get_library_paths� PackageInfo.get_library_paths� s � � r �urlc � � [ S5 e)z�Explicitly set a distribution mirror URL.
This might be called for operations that need to fetch distribution
files/packages from the network.
By default, the mirror will be read from the system configuration
files.
r r
)r
rF s r �
set_mirror�PackageInfo.set_mirror� s � � "� D�
�
r c � � [ S5 e)as Download source package and unpack it into output_dir.
This also has to care about applying patches etc., so that output_dir
will eventually contain the actually compiled source. output_dir needs
to exist and should be empty.
If version is given, this particular version will be retrieved.
Otherwise this will fetch the latest available version.
If sandbox is given, that sandbox is used to download the source
package, otherwise it uses the system configuration.
Return the directory that contains the actual source root directory
(which might be a subdirectory of output_dir). Return None if the
source is not available.
r r
)r
�
srcpackage�
output_dir�version�sandboxs r �get_source_tree�PackageInfo.get_source_tree� s � �" "� D�
�
r �ver1�ver2c � � [ S5 e)zdCompare two package versions.
Return -1 for ver < ver2, 0 for ver1 == ver2, and 1 for ver1 > ver2.
r r
)r
rQ rR s r �compare_versions� PackageInfo.compare_versions� r r c �� � [ U R SS9 nUR 5 nSSS5 [ R
" SW[ R 5 SL $ ! , ( d f N6= f! [ a gf = f)a� Return whether Apport should generate crash reports.
Signal crashes are controlled by /proc/sys/kernel/core_pattern, but
some init script needs to set that value based on a configuration file.
This also determines whether Apport generates reports for Python,
package, or kernel crashes.
Implementations should parse the configuration file which controls
Apport (such as /etc/default/apport in Debian/Ubuntu).
zutf-8)�encodingNTz^\s*enabled\s*=\s*0\s*$)�open�
configuration�read�OSError�re�search�M)r
� config_file�confs r �enabled�PackageInfo.enabled� se � � ��d�(�(�7�;�{�"�'�'�)�� <� �y�y�3�T�2�4�4�@�D�H�H�
<�;��� �� �s- �A( �A�A( �
A%�!A( �%A( �(
A5�4A5c � � [ S5 e)ztReturn the actual Linux kernel package name.
This is used when the user reports a bug against the "linux" package.
r r
rC s r �get_kernel_package� PackageInfo.get_kernel_package� r r �rootdir� configdir�packages�verbose� cache_dir�permanent_rootdir� architecture�origins� install_dbg� install_depsc � � [ S5 e)a� Install packages into a sandbox (for apport-retrace).
In order to work without any special permissions and without touching
the running system, this should only download and unpack packages into
the given root directory, not install them into the system.
configdir points to a directory with by-release configuration files for
the packaging system; this is completely dependent on the backend
implementation, the only assumption is that this looks into
configdir/release/, so that you can use retracing for multiple
DistroReleases. As a special case, if configdir is None, it uses the
current system configuration, and "release" is ignored.
release is the value of the report's 'DistroRelease' field.
packages is a list of ('packagename', 'version') tuples. If the version
is None, it should install the most current available version.
If cache_dir is given, then the downloaded packages will be stored
there, to speed up subsequent retraces.
If permanent_rootdir is True, then the sandbox created from the
downloaded packages will be reused, to speed up subsequent retraces.
If architecture is given, the sandbox will be created with packages of
the given architecture (as specified in a report's "Architecture"
field). If not given it defaults to the host system's architecture.
If origins is given, the sandbox will be created with apt data sources
for foreign origins.
If install_deps is True, then the dependencies of packages will also
be installed.
Return a string with outdated packages, or None if all packages were
installed.
If something is wrong with the environment (invalid configuration,
package servers down, etc.), this should raise a SystemError with a
meaningful error message.
r r
) r
rf rg r7 rh ri rj rk rl rm rn ro s r �install_packages� PackageInfo.install_packages� s � �n "� D�
�
r c � � [ S5 e)z2Return known package names which match given glob.r r
)r
�nameglobs r �package_name_glob� PackageInfo.package_name_glob0 r r c � � g)z�Check if a package is one which has been allow listed.
Return True for a package which came from an origin which is listed in
native-origins.d, False if it comes from a third-party source.
Fr1 r s r �is_native_origin_package�$PackageInfo.is_native_origin_package6 s � � r c � � U R S5 H- nU R U5 ( d M U R U5 M/ [ e! [ a Us s $ f = f)a Return a valid package name which is not installed.
Raises a ValueError in case no uninstalled package was found.
This is only used in the test suite. The default implementation should
work, but might be slow for your backend, so you might want to
reimplement this.
�*)ru r$ r �
ValueErrorr s r �get_uninstalled_package�#PackageInfo.get_uninstalled_packageA sa � � �-�-�c�2�G��)�)�'�2�2��
�� � ��)�� 3� ��� �
� ��
�s �A � A�A�namec �V � U R S5 ( a U R SS9S n U $ )Nz
GNU/Linux� )�maxsplitr )�endswith�rsplit)r s r � _sanitize_operating_system_name�+PackageInfo._sanitize_operating_system_nameV s- � � �=�=� � &� &��;�;��;�*�1�-�D�� r c � � U R ( a U R $ [ R " 5 nU R US 5 nUR S5 nU( a U( a X#4U l U R $ [ R " SS/S[ R [ R SS 9nUR R 5 R S
S 5 R 5 u p#UR 5 UR 5 4U l U R $ ! [
a, n[ R R U S35 SnAN�SnAff = f) z{Return (osname, osversion) tuple.
This is read from /etc/os-release, or if that doesn't exist,
'lsb_release -sir' output.
�NAME�
VERSION_IDz-. Falling back to calling 'lsb_release -sir'.N� lsb_releasez-sirFT)�check�stdout�stderr�text�
� )� _os_version�platform�freedesktop_os_releaser� �getr[ �sysr� �write�
subprocess�run�PIPEr� �strip�replace�split)r
�infor rM �errorr� s r �get_os_version�PackageInfo.get_os_version] s � � � � ��#�#� #� V��2�2�4�D��7�7��V� �E�D��h�h�|�,�G���$(�?�� ��'�'�'�
!�n�n�
�F� #�� �?�?� �?�?��
� � &�,�,�2�2�4�<�<�T�3�G�M�M�O��� �J�J�L�'�-�-�/�:���� � � �� � V� �J�J� � ��w�&S� T� U� U�� V�s �AD �
E�&"E
�
E)r� )FNNN)NN)FNFNNTF)(�__name__�
__module__� __qualname__�__firstlineno__�__doc__rY r �strr �listr r r �boolr$ r' r+ r. r2 r: � staticmethodr= r@ rD rH rO �intrT ra rd �tupler rq ru rx r} r� r� r� �__static_attributes__r1 r r r r s� � �.� *�M�
�
�S�
�S�
�
��
��S� �
�
�#�
�#�
�
�#�
�#��*�
�
��
��
�
��
��
�
�
�#�
�$�s�)�
�
� "�#'� "� �
��
� �
� �D�j�
�
�t��
� �D�j�
�
�t��
�0 �
�S�
� �
� �
�#�
� �
� �3� �
�c�
�d�
�
�*
�S�
��
��
�I�� I�(
�C�
� � $�"'�#'�(,� � "�9
��9
� ��:�9
� � 9
�
�u�S�#��*�_�-�.� 9
� �
9
� ��:�9
� �9
� �D�j�9
� �#� ��%�9
� �9
� �9
�
�9
�v
� �� �� ��� �& �K���c� �c� � �� ��c�3�h�� r r )r� r� r\ r� r� �collections.abcr r r1 r r �<module>r� s% �� *� � � �
� $�g � g r