Skip to main content

vsdx - A python library for processing .vsdx files

Project description

vsdx - A python library for processing Visio .vsdx files

Note: this is an early release with limited functionality

example 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.page_objects[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')

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


Change Log

  • 0.2.2: Added x & y location setters to Shape, and move(x_delta, y_delta) method - both with related tests
  • 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.4: Added find_replace(old, new) method to Shape and Page classes to recursively replace old with new
  • 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
  • v0.2.6: added Page.get_connectors_between() to get zero or many connectors between two shapes, by shape id or text
  • v0.2.7: add Shape.copy() method
  • 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.9: check that Page has shapes tag when in shape_copy(), add test to copy shape to new page

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vsdx-0.2.9.tar.gz (8.9 kB view hashes)

Uploaded Source

Built Distribution

vsdx-0.2.9-py3-none-any.whl (8.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page