o ooi, @svdZddlZddlZddlZddlZddlmZddlmZddlmZdgZ e e Z Gdddej ejejZdS) zHSave DOT code objects, render with Graphviz ``dot``, and open in viewer.N)_tools)backend)savingRenderc!@sReZdZdZejddd          dddddddejej e dfd ejej e dfd e d e d ej e d ej e dej e deje e dfde de dejej e dfdej e de de de fddZdejej e fd e de ddfddZejddd     ddejej e dfd ejej e dfd e de de de f ddZdS) rz4Write source lines to file and render with Graphviz.rself)supported_number ignore_argNF)outfileengineraise_if_result_existsoverwrite_sourcefilename directoryviewcleanupformatrenderer formatter neato_no_opquiet quiet_viewr r r r returnc  Cst| } | dur|j| |d}|durt|j| } |j| ||||| | | |dd \}}| dur9|dur9|| }|j||dd}| ||j |i|}|r[t d|t || s_|rh|j||j| d|S)aS Save the source to file and render with the Graphviz engine. Args: filename: Filename for saving the source (defaults to ``name`` + ``'.gv'``).s directory: (Sub)directory for source saving and rendering. view (bool): Open the rendered result with the default application. cleanup (bool): Delete the source file after successful rendering. format: The output format used for rendering (``'pdf'``, ``'png'``, etc.). renderer: The output renderer used for rendering (``'cairo'``, ``'gd'``, ...). formatter: The output formatter used for rendering (``'cairo'``, ``'gd'``, ...). neato_no_op: Neato layout engine no-op flag. quiet (bool): Suppress ``stderr`` output from the layout subprocess. quiet_view (bool): Suppress ``stderr`` output from the viewer process (implies ``view=True``, ineffective on Windows platform). outfile: Path for the rendered output file. engine: Layout engine for rendering (``'dot'``, ``'neato'``, ...). raise_if_result_exists: Raise :exc:`graphviz.FileExistsError` if the result file exists. overwrite_source: Allow ``dot`` to write to the file it reads from. Incompatible with ``raise_if_result_exists``. Returns: The (possibly relative) path of the rendered file. Raises: ValueError: If ``engine``, ``format``, ``renderer``, or ``formatter`` are unknown. graphviz.RequiredArgumentError: If ``formatter`` is given but ``renderer`` is None. ValueError: If ``outfile`` is the same file as the source file unless ``overwite_source=True``. graphviz.ExecutableNotFound: If the Graphviz ``dot`` executable is not found. graphviz.CalledProcessError: If the returncode (exit status) of the rendering ``dot`` subprocess is non-zero. RuntimeError: If viewer opening is requested but not supported. Example: >>> doctest_mark_exe() >>> import graphviz >>> dot = graphviz.Graph(name='spam', directory='doctest-output') >>> dot.render(format='png').replace('\\', '/') 'doctest-output/spam.gv.png' >>> dot.render(outfile='spam.svg').replace('\\', '/') 'doctest-output/spam.svg' Note: The layout command is started from the directory of ``filepath``, so that references to external files (e.g. ``[image=images/camelot.png]``) can be given as paths relative to the DOT source file. N)rT) r rrrrrr r r verify)r skip_existingz delete %r)rr)rpromote_pathlike _get_formatpathlibPathr_get_render_parameters _get_filepathsaveappend_renderlogdebugosremove_view_format)rrrrrrrrrrrr r r r argskwargsfilepathrenderedr.F/home/ubuntu/.local/lib/python3.10/site-packages/graphviz/rendering.pyrenders6 M     z Render.renderr,cCstd|dtjjdtjjg}|D]}t||d}|dur!nqt|jd|dtjjd|||ddS)z9Start the right viewer based on file format and platform._view__Nz$ has no built-in viewer support for z on z platform)r)rviewingPLATFORMgetattr RuntimeError __class__)rr,rr methodnamesname view_methodr.r.r/r(s    z Render._viewcCs|j||d|||dS)aSave the source to file, open the rendered result in a viewer. Convenience short-cut for running ``.render(view=True)``. Args: filename: Filename for saving the source (defaults to ``name`` + ``'.gv'``). directory: (Sub)directory for source saving and rendering. cleanup (bool): Delete the source file after successful rendering. quiet (bool): Suppress ``stderr`` output from the layout subprocess. quiet_view (bool): Suppress ``stderr`` output from the viewer process (ineffective on Windows). Returns: The (possibly relative) path of the rendered file. Raises: graphviz.ExecutableNotFound: If the Graphviz executable is not found. graphviz.CalledProcessError: If the exit status is non-zero. RuntimeError: If opening the viewer is not supported. Short-cut method for calling :meth:`.render` with ``view=True``. Note: There is no option to wait for the application to close, and no way to retrieve the application's exit status. T)rrrrrr)r0)rrrrrrr.r.r/rs #z Render.view) NNFFNNNNFF)NNFFF)__name__ __module__ __qualname____doc__rdeprecate_positional_argstypingUnionr&PathLikestrboolOptionalintr0r(rr.r.r.r/rs        o )r>loggingr&rr@rrr__all__ getLoggerr;r$SaverViewr.r.r.r/s