Skip to content

Commit a475487

Browse files
updated docs and automation
1 parent 330e781 commit a475487

File tree

2 files changed

+50
-7
lines changed

2 files changed

+50
-7
lines changed

.github/workflows/python-publish.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,3 +29,4 @@ jobs:
2929
run: |
3030
python setup.py sdist bdist_wheel
3131
twine upload dist/*
32+
# twine upload --repository testpypi dist/*

README.md

Lines changed: 49 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,7 @@
33
[![PyPI](https://img.shields.io/pypi/v/pyvba)](https://pypi.org/project/pyvba/)
44
[![GitHub](https://img.shields.io/github/license/TheEric960/pyvba)](https://github.com/TheEric960/pyvba)
55

6-
The pyvba package was designed to gather data from VBA-based applications (e.g. Microsoft Excel, CATIA, etc.). It
7-
may also be used to assist programming VBA macro scripts in a more sensical language.
6+
The pyvba package was designed to gather data from VBA-based applications (e.g. Microsoft Excel, CATIA, etc.). It may also be used to assist programming VBA macro scripts using the Python language.
87

98
## Getting Started
109
Install the Python Package:
@@ -23,10 +22,53 @@ exporter = pyvba.XMLExport(active_document)
2322
exporter.save("output", r"C:\Documents")
2423
```
2524

26-
The current supported output types are XML and JSON formats.
25+
The current supported output types are XML and JSON formats. Both support a form the imitates the VBA object tree as well as a dictionary form where each unique object is in the outermost layer.
26+
27+
Example Output:
28+
> Note: `BrowserObject` denotes an object defined elsewhere in the output.
29+
```JSON
30+
{ "MainBody": [
31+
{ "Pad": [
32+
{ "Shapes": [
33+
{ "DirectionOrientation": 0 },
34+
{ "DirectionType": 0 },
35+
{ "FirstLimit": "BrowserObject" },
36+
{ "IsSymmetric": false },
37+
{ "IsThin": false },
38+
{ "MergeEnd": false },
39+
{ "Name": "Pad.1" },
40+
{ "NeutralFiber": false },
41+
{ "SecondLimit": "BrowserObject" },
42+
{ "Sketch": "BrowserObject" }
43+
]},
44+
{ "Shapes": [
45+
{ "DirectionOrientation": 0 },
46+
{ "DirectionType": 0 },
47+
{ "FirstLimit": "BrowserObject" },
48+
{ "IsSymmetric": false },
49+
{ "IsThin": false },
50+
{ "MergeEnd": false },
51+
{ "Name": "Pad.1" },
52+
{ "NeutralFiber": false },
53+
{ "SecondLimit": "BrowserObject" },
54+
{ "Sketch": "BrowserObject" }
55+
]},
56+
{ "Shapes": [
57+
{ "DirectionOrientation": 0 },
58+
{ "DirectionType": 0 },
59+
{ "FirstLimit": "BrowserObject" },
60+
{ "IsSymmetric": false },
61+
{ "IsThin": false },
62+
{ "MergeEnd": false },
63+
{ "Name": "Pad.3" },
64+
{ "NeutralFiber": false },
65+
{ "SecondLimit": "BrowserObject" },
66+
{ "Sketch": "BrowserObject" }
67+
]}
68+
]}
69+
]}
70+
```
71+
2772

2873
## Developer Notes
29-
This package is still in alpha. Hence, there are still some problematic bugs and issues that cause errors in certain
30-
applications. Contributors are welcome! The project is [hosted on GitHub](https://github.com/TheEric960/pyvba). Report
31-
any issues at [the issue tracker](https://github.com/TheEric960/pyvba/issues), but please check to see if the issue
32-
already exists!
74+
This package is in beta. Therefore, there are still some problematic bugs and issues that cause errors in certain applications. Contributors are welcome! The project is [hosted on GitHub](https://github.com/TheEric960/pyvba). Report any issues at [the issue tracker](https://github.com/TheEric960/pyvba/issues), but please check to see if the issue already exists!

0 commit comments

Comments
 (0)