vsdx

library0.6.1pypypi✓ verified 85d ago

vsdx is a Python library for reading and writing Microsoft Visio .vsdx files. Version 0.6.1 supports Python >=3.7 and provides APIs to manipulate shapes, pages, masters, and connections. The project is actively maintained with regular releases.

devops productivity

pip install vsdx

github ↗homepage ↗

INSTALL

IMPORT

SIG · VSDX

vsdx

devopspythonv0.6.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

VisioFile

✓ from vsdx import VisioFile

Standard import path. No common wrong pattern documented.

Open a .vsdx file and iterate over shapes and their text on each page.

from vsdx import VisioFile with VisioFile('diagram.vsdx') as vdx: for page in vdx.pages: for shape in page.shapes: if shape.text: print(f"Shape: {shape.name}, Text: {shape.text}")

Debug

Known issues

gotchaShape IDs may not be unique across different pages or masters. Always scope lookups to a specific page.

fix

Use page.shapes or page.connectors to retrieve shapes within a page context.

affects: all

gotchaThe library may not preserve all Visio formatting (e.g., color, line style) when writing back. It focuses on structure and text.

fix

For formatting preservation, consider using the Visio interop or a different tool.

affects: all

Errors

Common errors & fixes

AttributeError: 'VisioFile' object has no attribute 'pages'

VisioFile.pages is accessed after the file has been closed or the context manager exited.

fix

Ensure all file operations are inside the 'with VisioFile(...) as vdx:' block.

ValueError: Invalid vsdx file

The file is not a valid .vsdx file (e.g., corrupted or a different format).

fix

Verify the file integrity and ensure it's a Visio .vsdx file (not .vsd).

Upgrade

Version history

0.6.1latest on PyPI · released Jan 4, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

78 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/dave-howard/vsdx ↗

homepagehttps://github.com/dave-howard/vsdx ↗