← Back
Editing: ynl_gen_rst.cpython-312.pyc
� }j� � �4 � d Z ddlZddlZddlZddlZddlZej j ej e � j � j j � � ddlmZ dej fd�Zdededdfd�Zd d �Zed k( r e� yy) a� Script to auto generate the documentation for Netlink specifications. :copyright: Copyright (C) 2023 Breno Leitao <leitao@debian.org> :license: GPL Version 2, June 1991 see linux/COPYING for details. This script performs extensive parsing to the Linux kernel's netlink YAML spec files, in an effort to avoid needing to heavily mark up the original YAML file. It uses the library code from scripts/lib. � N)�YnlDocGenerator�returnc � � t j d�� } | j ddd�� | j ddd � � | j � }|j d d d � � | j � }|j r$t j t j �� |j r^t j j |j � s5t j d|j � t j d� |j s*t j" d� t j d� t j j |j � r t j$ d|j � |S )zParse arguments from userzNetlink RST generator)� descriptionz-vz --verbose� store_true)�actionz-oz--outputzOutput file name)�helpz-iz--inputzYAML file name)�levelz%s is not a valid file.���zNo output file specified.z"%s already exists. Overwriting it.)�argparse�ArgumentParser� add_argument� add_mutually_exclusive_group� parse_args�verbose�logging� basicConfig�DEBUG�input�os�path�isfile�warning�sys�exit�output�error�debug)�parser�group�argss �6/usr/lib/python3.12/site-packages/pyynl/ynl_gen_rst.py�parse_argumentsr# s � � � $� $�1H� I�F� ����k�,��?� ����j�/A��B� � /� /� 1�E� ���t�Y�-=��>� � � � �D� �|�|����'�-�-�0� �z�z�"�'�'�.�.����4����1�4�:�:�>� ���� � �;�;�� � �1�2� ���� � �w�w�~�~�d�k�k�"�� � �:�D�K�K�H� �K� �content�filenamec � � t j d|� t |dd�� 5 }|j | � ddd� y# 1 sw Y yxY w)z,Write the generated content into an RST filezSaving RST file to %s�wzutf-8)�encodingN)r r �open�write)r% r& �rst_files r" �write_to_rstfiler- 7 s7 � � �M�M�)�8�4� �h��g� .�(����w� � /� .� .�s �A � A c �� � t � } t � }| j rpt j d| j � |j t j j | j � � }t | j � yy# t $ rT}t j d| j � t j |� t j d� Y d}~�pd}~ww xY w)zCMain function that reads the YAML files and generates the RST filesz Parsing %szFailed to parse %s.r N)r# r r r r �parse_yaml_filer r �join� Exceptionr r r r- r )r! r r% � exceptions r" �mainr3 ? s� � � � �D� � �F� �z�z�� � �l�D�J�J�/� � �,�,�R�W�W�\�\�$�*�*�-E�F�G� ��$�+�+�.� �� � � �O�O� 1�4�:�:� >� �O�O�I� &� �H�H�R�L�L�� �s �8B � C/�A C*�*C/�__main__)r N)�__doc__�os.pathr �pathlibr r r r �append�Path�__file__�resolve�parent�as_posix�libr � Namespacer# �strr- r3 �__name__� r$ r" �<module>rC s� �� � � � � � � ����� �� � �X�&�.�.�0�7�7�@�@�B� C� ���+�+� �< �c� �S� �T� �/�& �z���F� r$
Save File
Cancel