vsdx · PyPI

vsdx - A python library for processing Visio .vsdx files

PyPI PyPI - Downloads

PyPI - Python Version

.vsdx files can be processed in two ways, directly via python code as in example 1 below, or indirectly using a jinja template as in example 2

For quick start documentation please see https://vsdx.readthedocs.io/en/latest/quickstart.html

Example 1 code to find a shape with specific text, remove it, and then save the updated .vsdx file:

from vsdx import VisioFile

filename = 'my_file.vsdx'
# open a visio file
with VisioFile(filename) as vis:
    # get page shapes collection
    shapes = vis.pages[0].shapes
    # get shape to remove by its text value
    s = shapes[0].find_shape_by_text('Shape to remove')  # type: VisioFile.Shape
    # remove the shape if found
    if s:
        s.remove()
        # save a new copy
        vis.save_vsdx('shape_removed.vsdx')

Example 2 creating a new vsdx file from a template and context data using jinja.
Note that as vsdx does not lend itself well to ordered statements like {% if something %}my content{% endif %} or {% for x in list_value %}x={{ x }}{% endfor %} this package provides mechanisms to help - refer to tests for more details.

from vsdx import VisioFile

filename = 'my_template_file.vsdx'  # file containing jinja code
context = {'value1': 10, 'list_value': [1,2,3]}  # data for the template
with VisioFile('my_template_file.vsdx') as vis: 
    vis.jinja_render_vsdx(context=context)
    vis.save_vsdx('my_new_file.vsdx')

Please refer to tests/test.py for more usage examples in the form of pytest tests.

Change Log

v0.4.8: Support nested loops/showifs and combo of loop and if in same shape.
v0.4.7: Python 3.10.0rc1 added to test suite. Add Shape.data_properties property, and new class ShapeProperty to represent Visio Shape Data
v0.4.6: Add support for nested jinja loops in one shape
v0.4.5: Fix bug where some shapes have no parent, and inserting shape into empty page
v0.4.4: Added support for master page shape inheritance, ability to get Shape.master_shape, ability to update master shapes and persist changes to master shapes in save_vsdx()
v0.4.3: Added support for including/excluding pages via Jinja with {% showif <statement> %} in page name
v0.4.2: Added VisioFile.add_page_at() method taking index to allow insertion at a specific point; Added VisionFile.copy_page() method to copy an existing page and insert at a specific index or relative to copied page (using PagePosition enum).
v0.4.1: Added support for self referencing calculations in Jinja statements, such as {% set self.x = self x + n * 3.2 %}
v0.4.0: Added VisioFile.jinja_set_selfs to allow setting shape x and y properties in Jinja template. Setting values, calculations, or if statements are supported e.g. {% set self.x = 1.5 %} or {% set self.y = n * 3 %} or {% set self.x = 1.0 if n else 2.0 %}
v0.3.5: Added VisioFile.add_page() method and tests
v0.3.4: Added VisioFile.remove_page_by_index() method to remove a page, with associated test
v0.3.3: Added code of conduct and contributing guides
v0.3.2: updated README and updated tests for improved compatibility
v0.3.1: add jinja rendering support for if statements, via VisioFile.jinja_render_vsdx() - similar to for loops but using a {% showif statement %} in text of group shape controls whether that group shape is included in vsdx file rendered. Note that the showif statement is replaced with a standard if statement around the group shape prior to rendering. Refer to test.py::test_jinja_if() for an example
v0.3.0: update jinja rendering to support for loops, where for statement is at start of group shape text, endfor is automatically inserted before processing. Refer to test.py::test_basic_jinja_loop() for code and test_jinja_loop.vsdx for content.
v0.2.10: add VisioFile.jinja_render_vsdx() - applying jinja processing to Shape.text only
v0.2.9: check that Page has shapes tag when in shape_copy(), add test to copy shape to new page
v0.2.8: find max shape ID in Page before creating Shape in Shape.copy(). Find and load master pages when file is opened, store in VisioFile.master_page_objects and .master_pages
v0.2.7: add Shape.copy() method
v0.2.6: added Page.get_connectors_between() to get zero or many connectors between two shapes, by shape id or text
0.2.5: Add new Shape properties connected_shapes (list of Shape objects) and connects (list of Connect objects) properties to allow related shapes to be identified (i.e. shapes and connectors) and provide information on the relationship, in new Connect object. Also new properties of shape begin_x/y, end_x/y, plus height/width setters
0.2.4: Added find_replace(old, new) method to Shape and Page classes to recursively replace old with new
0.2.3: Updated tests to output files to an /out folder. Added test vsdx file with compound shape. Updated Shape text getter/setter
0.2.2: Added x & y location setters to Shape, and move(x_delta, y_delta) method - both with related tests

Metadata

Release files for vsdx 0.4.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vsdx 0.4.8
File	Size	Uploaded
vsdx-0.4.8.tar.gz	20.2 kB	Aug 8, 2021	Details

Built distribution (wheel)

Table of built distributions (wheels) for vsdx 0.4.8
File	Interpreter	ABI	Platform	Reset
vsdx-0.4.8-py3-none-any.whl 17.7 kB Aug 8, 2021	Python 3	none	any	Details

Total release size: 37.8 kB

Release files / vsdx-0.4.8.tar.gz

Download URL	vsdx-0.4.8.tar.gz
Size	20.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`4fdf0e33a59ccecdb3c0ac449e8b4e3cea9addb53700237e4b065779aead33a6`
BLAKE2b-256 checksum How to use checksums	`68e21d57bec0a37d01524150d3df4bcc277c567431787d225dac8eb8b914900b`
Upload date	Aug 8, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.8.8`

Release files / vsdx-0.4.8-py3-none-any.whl

Download URL	vsdx-0.4.8-py3-none-any.whl
Size	17.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5f0bf6e0fe5187463f2c8d618556fab5a91961d77497de0371f53787e5f63af6`
BLAKE2b-256 checksum How to use checksums	`96f1994bb6edcebac77689bf7b9ff20206cdc9d1c5ce3c587fe47a829540f816`
Upload date	Aug 8, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.8.8`