D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
lib
/
python3
/
dist-packages
/
debian
/
__pycache__
/
Filename :
substvars.cpython-312.pyc
back
Copy
� Cf�c#: � �� � d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z ddl m Z ddl m Z ddlmZmZmZmZmZmZmZmZmZ ddlmZ eeeef Z ej: d � Z ej> d � Z G d � d � Z!ejD d k\ ser G d� dejF e e eef e� Z$n G d� dejJ e e e� Z$ G d� de$d � Z&y# e $ r Y ��w xY w)a Facilities for reading and writing Debian substvars files The aim of this module is to provide programmatic access to Debian substvars files to query and manipulate them. The format for the changelog is defined in `deb-substvars(5) <https://manpages.debian.org/stretch/dpkg-dev/deb-substvars.5.html>`_ Overview ======== The most common use-case for substvars is for package helpers to add or update a substvars (e.g., to add a dependency). This would look something like: >>> from debian.substvars import Substvars >>> from tempfile import TemporaryDirectory >>> import os >>> # Using a tmp dir for the sake of doctests >>> with TemporaryDirectory() as debian_dir: ... filename = os.path.join(debian_dir, "foo.substvars") ... with Substvars.load_from_path(filename, missing_ok=True) as svars: ... svars.add_dependency("misc:Depends", "bar (>= 1.0)") By default, the module creates new substvars as "mandatory" substvars (that triggers a warning by dpkg-gecontrol if not used. However, it does also support the "optional" substvars introduced in dpkg 1.21.8. See `Substvars.as_substvars` for an example of how to use the "optional" substvars. The :class:`Substvars` class is the key class within this module. Substvars Classes ----------------- � N)�ABC)� OrderedDict)�MutableMapping)� TracebackType) �Dict�Set�Optional�Union�Iterator�IO�Iterable� TYPE_CHECKING�Type)�PathLike�TzB^(?P<name>\w[-:\dA-Za-z]*)(?P<assignment_type>[?]?=)(?P<value>.*)$c �f � e Zd ZddgZ d d�Zed� � Zej d� � Zd� Zd� Z d� Z y ) �Substvar�_assignment_operator�_valuec � � || _ || _ y �N)r �assignment_operator)�self� initial_valuer s �2/usr/lib/python3/dist-packages/debian/substvars.py�__init__zSubstvar.__init__A s � � $�� �#6�� � c � � | j S r )r �r s r r z Substvar.assignment_operatorR s � � �(�(�(r c �6 � |dvrt d|z � �|| _ y )N> �?=�=z-Operator must be one of: "=", or "?=" - got: )� ValueErrorr )r � new_operators r r z Substvar.assignment_operatorW s% � � �{� *� � L�|� [�\� \�$0��!r c � � | j dk( r |h| _ y t | j t � r<| j j d� D �ch c] }|j � �� c}| _ | j j |� y c c}w )N� �,)r � isinstance�str�split�strip�add)r �dependency_clause�vs r �add_dependencyzSubstvar.add_dependency^ sg � � �;�;�"� �,�-�D�K� � �d�k�k�3� '�.2�k�k�.?�.?��.D�E��1�7�7�9�E�D�K� � � ���)�*�� Fs �B c � � t | j t � r$dj t | j � � S | j S )Nz, )r( r �set�join�sortedr s r �resolvezSubstvar.resolveh s2 � � �d�k�k�3� '��9�9�V�D�K�K� 0�1� 1��{�{�r c � � |�t |t � sy| j |j k7 ry| j � |j � k( S �NF)r( r r r4 �r �others r �__eq__zSubstvar.__eq__n sA � � �=� �5�(� ;�� � #� #�u�'@�'@� @���|�|�~�� � � �0�0r N)r& r" ) �__name__� __module__� __qualname__� __slots__r �propertyr �setterr/ r4 r9 � r r r r = sT � �'��2�I�%'�%(�7�" �)� �)� � � �1� �1� +�� 1r r )� � c � � e Zd Zy)�_Substvars_BaseN)r: r; r< r@ r r rD rD x s � � r rD c � � e Zd Zd� Zd� Zy)rD c � � | S r r@ r s r � __enter__z_Substvars_Base.__enter__� s � ��Kr c � � y r r@ )r �exc_type�exc_val�exc_tbs r �__exit__z_Substvars_Base.__exit__� s � �r N)r: r; r< rG rL r@ r r rD rD s � � � r c � � � e Zd ZdZddgZd� Zedd�� Zed� � Z e j d� � Z ed� � Z e j d � � Z d � Z � fd �Z d � Zd efd�Zd� Zd� Zd� Zd� Zed� � Zd� Zd� Zd� Zd� Zd� Z� xZS )� Substvarsa� Substvars is a dict-like object containing known substvars for a given package. >>> substvars = Substvars() >>> substvars['foo'] = 'bar, golf' >>> substvars['foo'] 'bar, golf' >>> substvars.add_dependency('foo', 'dpkg (>= 1.20.0)') >>> substvars['foo'] 'bar, dpkg (>= 1.20.0), golf' >>> 'foo' in substvars True >>> sorted(substvars) ['foo'] >>> del substvars['foo'] >>> substvars['foo'] Traceback (most recent call last): ... KeyError: 'foo' >>> substvars.get('foo') >>> # None >>> substvars['foo'] = "" >>> substvars['foo'] '' The Substvars object also provide methods for serializing and deserializing the substvars into and from the format used by dpkg-gencontrol. The Substvars object can be used as a context manager, which causes the substvars to be saved when the context manager exits successfully (i.e., no exceptions are raised). � _vars_dict�_substvars_pathc �0 � t � | _ d | _ y r )r rO rP r s r r zSubstvars.__init__� s � �%�-��� #�� r c � � | � } t |dd�� 5 }|j |� ddd� ||_ |S # 1 sw Y �xY w# t $ r*}|j t j k7 s|s� Y d}~�Cd}~ww xY w)a Shorthand for initializing a Substvars from a file The return substvars will have `substvars_path` set to the provided path enabling `save()` to work out of the box. This also makes it easy to combine this with the context manager interface to automatically save the file again. >>> import os >>> from tempfile import TemporaryDirectory >>> with TemporaryDirectory() as tmpdir: ... filename = os.path.join(tmpdir, "foo.substvars") ... # Obviously, this does not exist ... print("Exists before: " + str(os.path.exists(filename))) ... with Substvars.load_from_path(filename, missing_ok=True) as svars: ... svars.add_dependency("misc:Depends", "bar (>= 1.0)") ... print("Exists after: " + str(os.path.exists(filename))) Exists before: False Exists after: True :param substvars_path: The path to load from :param missing_ok: If True, then the path does not have to exist (i.e. FileNotFoundError causes an empty Substvars object to be returned). Combined with the context manager, this is useful for packaging helpers that want to append / update to the existing if it exists or create it if it does not exist. �r�utf-8��encodingN)�open�read_substvars�OSError�errno�ENOENT�substvars_path)�clsr\ � missing_ok� substvars�fd�es r �load_from_pathzSubstvars.load_from_path� sz � �6 �E� � ��n�c�G�<� -���(�(��,� -� $2� � ��� -� -��� ��w�w�%�,�,�&�j�� /9�� �s* �A �:�A �A�A � A9� A4�4A9c � � | j S r �rO r s r �_varszSubstvars._vars� s � � ��� r c � � || _ y r rd )r � vars_dicts r re zSubstvars._vars� s � � $��r c � � | j S r �rP r s r r\ zSubstvars.substvars_path� s � � �#�#�#r c � � || _ y r ri )r �new_paths r r\ zSubstvars.substvars_path� s � � (�� r c � � | j | }|j |� y# t $ r t � }|| j |< Y �6w xY w)a� Add a dependency clause to a given substvar >>> substvars = Substvars() >>> # add_dependency automatically creates variables >>> 'misc:Recommends' not in substvars True >>> substvars.add_dependency('misc:Recommends', "foo (>= 1.0)") >>> substvars['misc:Recommends'] 'foo (>= 1.0)' >>> # It can be appended to other variables >>> substvars['foo'] = 'bar, golf' >>> substvars.add_dependency('foo', 'dpkg (>= 1.20.0)') >>> substvars['foo'] 'bar, dpkg (>= 1.20.0), golf' >>> # Exact duplicates are ignored >>> substvars.add_dependency('foo', 'dpkg (>= 1.20.0)') >>> substvars['foo'] 'bar, dpkg (>= 1.20.0), golf' N)re �KeyErrorr r/ )r �substvarr- �variables r r/ zSubstvars.add_dependency� sL � �, ,��z�z�(�+�H� � � � 1�2�� � ,� �z�H�#+�D�J�J�x� � ,�s �# �"A�Ac �J �� |�| j � t �| � |||� S r )�save�superrL )r rI rJ rK � __class__s �r rL zSubstvars.__exit__ s( �� � � � �I�I�K��w� ��'�6�:�:r c �, � t | j � S r )�iterre r s r �__iter__zSubstvars.__iter__ s � ��D�J�J� � r �returnc �, � t | j � S r )�lenrO r s r �__len__zSubstvars.__len__ s � ��4�?�?�#�#r c � � || j v S r �re )r �items r � __contains__zSubstvars.__contains__ s � ��t�z�z�!�!r c �< � | j | j � S r )re r4 �r �keys r � __getitem__zSubstvars.__getitem__ s � ��z�z�#��&�&�(�(r c � � | j |= y r r| r� s r � __delitem__zSubstvars.__delitem__ s � � �J�J�s�Or c �4 � t |� | j |< y r )r re )r r� �values r � __setitem__zSubstvars.__setitem__$ s � �"�5�/�� � �3�r c � � | j S )a� Provides a mapping to the Substvars object for more advanced operations Treating a substvars file mostly as a "str -> str" mapping is sufficient for many cases. But when full control over the substvars (like fiddling with the assignment operator) is needed this attribute is useful. >>> content = ''' ... # Some comment (which is allowed but no one uses them - also, they are not preserved) ... shlib:Depends=foo (>= 1.0), libbar2 (>= 2.1-3~) ... random:substvar?=With the new assignment operator from dpkg 1.21.8 ... ''' >>> substvars = Substvars() >>> substvars.read_substvars(content.splitlines()) >>> substvars.as_substvar["shlib:Depends"].assignment_operator '=' >>> substvars.as_substvar["random:substvar"].assignment_operator '?=' >>> # Mutation is also possible >>> substvars.as_substvar["shlib:Depends"].assignment_operator = '?=' >>> print(substvars.dump(), end="") shlib:Depends?=foo (>= 1.0), libbar2 (>= 2.1-3~) random:substvar?=With the new assignment operator from dpkg 1.21.8 r| r s r � as_substvarzSubstvars.as_substvar( s � �6 �z�z�r c �Z � |�t |t � sy| j |j k( S r6 )r( rN re r7 s r r9 zSubstvars.__eq__E s& � � �=� �5�)� <���z�z�U�[�[�(�(r c �b � dj d� | j j � D � � S )z�Debug aid that generates a string representation of the content For persisting the contents, please consider `save()` or `write_substvars`. r& c 3 �x K � | ]2 \ }}d j ||j |j � � �� �4 y�w�z{}{}{} N��formatr r4 ��.0�kr. s r � <genexpr>z!Substvars.dump.<locals>.<genexpr>Q s7 � �� � � �1�a� "�(�(��A�,A�,A�1�9�9�;�O� �� �8:)r2 re �itemsr s r �dumpzSubstvars.dumpK s/ � � �w�w� �#'�:�:�#3�#3�#5�� � r c � � | j � t d� �t | j dd�� 5 }| j |� cddd� S # 1 sw Y yxY w)z�Save the substvars file Replace the path denoted by the `substvars_path` attribute with the in-memory version of the substvars. Note that the `substvars_path` property must be not None for this method to work. NzcThe substvar does not have a substvars_path: Please set substvars_path first or use write_substvars�wrT rU )rP � TypeErrorrW �write_substvars)r r` s r rq zSubstvars.saveU s^ � � � � � '�� O� P� P� �$�&�&��g� >� ,�"��'�'��+� ,� ,� ,�s �A � Ac �d � |j d� | j j � D � � y)z�Write a copy of the substvars to an open text file :param fileobj: The open file (should open in text mode using the UTF-8 encoding) c 3 �x K � | ]2 \ }}d j ||j |j � � �� �4 y�wr� r� r� s r r� z,Substvars.write_substvars.<locals>.<genexpr>j s7 � �� � � #�q�!� &�,�,�Q��0E�0E�q�y�y�{�S� �r� N)� writelinesre r� )r �fileobjs r r� zSubstvars.write_substvarsd s, � � ��� �'+�z�z�'7�'7�'9� � r c � � t � }|D ]i }|j � dk( s|d dk( r� t j |j d� � }|s�F|j � \ }}}t ||�� ||< �k || _ y)a Read substvars from an open text file in the format supported by dpkg-gencontrol On success, all existing variables will be discarded and only variables from the file will be present after this method completes. In case of any IO related errors, the object retains its state prior to the call of this method. >>> content = ''' ... # Some comment (which is allowed but no one uses them - also, they are not preserved) ... shlib:Depends=foo (>= 1.0), libbar2 (>= 2.1-3~) ... random:substvar?=With the new assignment operator from dpkg 1.21.8 ... ''' >>> substvars = Substvars() >>> substvars.read_substvars(content.splitlines()) >>> substvars["shlib:Depends"] 'foo (>= 1.0), libbar2 (>= 2.1-3~)' >>> substvars["random:substvar"] 'With the new assignment operator from dpkg 1.21.8' :param fileobj: An open file (in text mode using the UTF-8 encoding) or an iterable of str that provides line by line content. r& r �#z )r N)r r+ �_SUBSTVAR_PATTERN�match�rstrip�groupsr re )r r� rg �line�m�varnamer r� s r rX zSubstvars.read_substvarsn s� � �0 �M� �� Z�D��z�z�|�r�!�T�!�W��^��!�'�'�� � �F�(;�<�A���23�(�(�*� /�G�(�%�!)�%�EX�!Y�I�g� � Z� �� r )F) r: r; r< �__doc__r= r � classmethodrb r> re r? r\ r/ rL rv �intrz r~ r� r� r� r� r9 r� rq r� rX � __classcell__)rs s @r rN rN � s� �� � �> � 0�1�I�$� �"� �"�H � � � � �\�\�$� �$� �$� �$� ���(� �(�3�:;� �$�� $�"�)� �*� �� ��8)� � ,� �! r rN )'r� � contextlibrZ �re�sys�typing�abcr � collectionsr �collections.abcr �typesr r r r r r r r r r �osr r) �bytes�AnyPath� ImportError�TypeVarr �compiler� r � version_info�AbstractContextManagerrD �GenericrN r@ r r �<module>r� s� ��!�H � � � � � � #� *� � Z� Z� Z� ���H�c�5�(�)�G� �F�N�N�3��� �B�J�J�I�� � 71� 71�t ���v� � � �*�;�;�A�>��s�TW�x�@X�Z]� ��&�.�.��+�^�S� �G �� �,� G ��k � �� �s �C � C$�#C$