Home

Awesome

xmindparser

PyPI

Parse xmind file to programmable data type (e.g. json, xml). Python 3.x required. Now it supports XmindZen file type as well.

See also: xmind2testlink / 中文文档

Installation

pip install xmindparser

Usage - Command Line

cd /your/xmind/dir

xmindparser your.xmind -json
xmindparser your.xmind -xml

Note: Parse to xml file type require dicttoxml.

Usage - via Python

from xmindparser import xmind_to_dict

d = xmind_to_dict('/path/to/your/xmind')
print(d)

See example output: json

Configuration

If you use xmindparser via Python, it provides a config object, check this example:

import logging
from xmindparser import xmind_to_dict,config

config = {'logName': 'your_log_name',
          'logLevel': logging.DEBUG,
          'logFormat': '%(asctime)s %(levelname)-8s: %(message)s',
          'showTopicId': True, # internal id will be included, default = False
          'hideEmptyValue': False  # empty values will be hidden, default = True
          }

d = xmind_to_dict('/path/to/your/xmind')
print(d)

Limitations (for Xmind legacy version)

Please note, following xmind features will not be supported or partially supported.

XmindZen Supporting

xmindparser will auto detect xmind file created by XmindZen or XmindPro, you can pass in ZEN file as usual.

from xmindparser import xmind_to_dict

d = xmind_to_dict('/path/to/your/xmind_zen_file')
print(d)

Please note, there are a few differences between xmind legacy and xmind zen.

Since XmindZen has upgraded the internal content file as json, you can read it by code like this:

import json

def get_xmind_zen_json(file_path):
    name = "content.json"
    with ZipFile(file_path) as xmind:
        if name in xmind.namelist():
            content = xmind.open(name).read().decode('utf-8')
            return json.loads(content)

        raise AssertionError("Not a xmind zen file type!")

# xmindparser also provides a shortcut
from xmindparser import get_xmind_zen_builtin_json

content_json = get_xmind_zen_builtin_json(xmind_zen_file)

Examples

Xmind Example

License

MIT