U d/e @svdZddlZddlZddlZddlZddlmZddlmZddlmZdgZ e e Z Gdddej ejejZdS) zHSave DOT code objects, render with Graphviz ``dot``, and open in viewer.N)_tools)backend)savingRenderc@seZdZdZejddddddddejej e dfejej e dfe e ej e ej e ej e eje e dfe e ejej e dfej e e e e ddd Zejej e fe e dd d d Zejdddejej e dfejej e dfe e e e d ddZdS)rz4Write source lines to file and render with Graphviz.)Zsupported_numberNF)outfileengineraise_if_result_existsoverwrite_source)filename directoryviewcleanupformatrenderer formatter neato_no_opquiet quiet_viewrr r r returnc  Cst| } | dk r6|j| |d}|dkr6t|j| } |j| ||||| | | |dd \}}| dk rr|dkrr|| }|j||dd}| ||j ||}|rt d|t || s|r|j||j| d|S)aR 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_exits: 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 rrrrrrr r verify)r Z skip_existingz delete %r)rr)rZpromote_pathlikeZ _get_formatpathlibPathr Z_get_render_parametersZ _get_filepathsaveappendZ_renderlogdebugosremove_view_format)selfr r rrrrrrrrrr r r argskwargsfilepathrenderedr'6/tmp/pip-unpacked-wheel-n8ok7rre/graphviz/rendering.pyrenders6M       z Render.render)r%rrrcCstd|dtjjdtjjg}|D]}t||d}|dk r&qdq&t|jd|dtjjd|||ddS)z9Start the right viewer based on file format and platform.Z_view__Nz$ has no built-in viewer support for z on z platform)r)rZviewingZPLATFORMgetattr RuntimeError __class__)r"r%rrZ methodnamesnameZ view_methodr'r'r(r s   z Render._view)r r rrrrcCs|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)r r rrrr)r))r"r r rrrr'r'r(rs # z Render.view) NNFFNNNNFF)NNFFF)__name__ __module__ __qualname____doc__rZdeprecate_positional_argstypingUnionrPathLikestrboolOptionalintr)r rr'r'r'r(rsj  o  )r2loggingrrr3rrr__all__ getLoggerr/rZSaverZViewr'r'r'r(s