| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Changelog
Version 0.18
Change of beaviour: File endings are now normalized so that all DOT source
outputs end with a final newline (Unix convention, simplifies concatenation).
This includes DOT source files written by .render(), .view(), or .save()
as well was .source generated or loaded from Source (or Source.from_file()).
Change of behaviour: Source instances created by Source.from_file() no nonger
write the content read into .source back into the
file. Use .save(skip_existing=False) before calling .render() or .view() if
you want to overwrite the file to produce the previous (less safe) behaviour.
Change of undocumented behaviour: When iterating over a Graph, Digraph,
or Source instance, the yielded lines now include a final newline ('\n').
This mimics iteration over file object lines in text mode.
When passing invalid parameters such as unknown engine, format, etc., .render()
now raises early before writing the file. Call .save() explicitly to produce
the previous (less safe) behaiour.
Add optional keyword-only encoding argument to pipe(). Returns the decoded
stdout from the rendering process (e.g. format='svg'). Delegates
encoding/decoding to subprocess in the common case (input and output encoding
are the same, e.g. default encoding='utf-8'). Used by the Jupyter notebook
integration.
Add optional keyword-only engine argument to .pipe() and .render().
Add optional keyword-only renderer and formatter arguments to Graph(),
Digraph(), Source() and Source.from_file() to set default renderers and
formatters (similar to format). Used by .pipe(), .render(), and .view() if
not given as method-argument.
Add pipe_string(), pipe_lines(), and pipe_lines_string(). Pipe input_string,
return string. Pipe input_lines incrementally, return bytes. Pipe input_lines
incrementally, return string.
Add set_default_engine() and set_default_format()
Add backend.DOT_BINARY and backend.UNFLATTEN_BINARY.
Restructure the internal class hierarchy using multiple-inheritance with
cooperative super() calling: Graph now inherits both from Dot and from Render,
and both of them inherit from Base which defines their common interface: Lines
of DOT source code that Dot generates (also Source) and rendering iterates over.
This might break some undocumented use of subclassing and require adatation
Improve test separation. Improve test coverage of running the tests with
--skip-exe.
Add pytype checking and flake8 to build workflow.
Extend type annotations.
Add https://mybinder.org config with head development environment. Add launch
badge to code repository.
Improve documentation and examples.
Add development docs.
Document release process.
Signed-off-by: Wang Mingyu <wangmy@fujitsu.com>
Signed-off-by: Khem Raj <raj.khem@gmail.com>
Signed-off-by: Trevor Gamblin <trevor.gamblin@windriver.com>
|
