A diff tool for VMware vRealize Orchestrator packages files
Project description
Project description
vRO-package-diff is a Python package to compare 2 VMware vRealize Orchestrator packages.
It provides a table-formated diff of two packages:
It is also possible to export unified diff files for each supported element:
tree -L 2 ./diff/ ./diff/ ├── conflict │ ├── action │ ├── configurationelement │ ├── resourceelement │ └── workflow ├── no_upgrade │ ├── action │ ├── configurationelement │ └── workflow └── upgrade ├── action ├── configurationelement ├── resourceelement └── workflow cat ./diff/conflict/action/af7b881d-ba59-40d0-8207-be9e9b2ae34d.diff
--- tests/data/package_v1.0.package - Action: this_is_action_a (0.0.1) +++ tests/data/package_v1.1.package - Action: this_is_action_a (0.0.1) @@ -13,7 +13,5 @@ // nothing, just for fun :) } -Plop; - System.debug("this_is_action_a stopped");]]></script>
Installing
Install and update using pip:
pip install vro-package-diff
vRO-package-diff supports Python 3.5 and newer.
Usage example
vro-diff --legend --reference_package tests/data/package_v1.0.package tests/data/package_v1.1.package
CLI help
You can get the usage help by using the -h/--help flag:
vro-diff -h Usage: vro-diff [OPTIONS] COMPARED_PACKAGE Compare two vRealize Orchestrator packages. Use the [-r/--reference_package] option to specify the reference package. Options: -r, --reference_package FILENAME Reference package to compare your package with. [required] -l, --legend Display the legend after the diff table -t, --test Exit with `0` if package can be safely imported. Else, returns the number of errors -a, --ascii Only use ASCII symbols to display results -b, --no_color Do not colorized the output -d, --diff PATH A folder where to generate unified diff files output -e, --empty-config Check for values in the configuration elements: if so, exit with failure status. -h, --help Show this message and exit.
License
History
2.2.2 (2020-12-15)
Add support for PolicyTemplate items #46
2.2.1 (2020-11-06)
Fix: Error in version comparaison #44
2.2.0 (2020-09-18)
Check for values in the configuration elements: if so, exit with failure status.
Add a new flag to enable this check:
-e, --empty-config Check for values in the configuration elements: if so, exit with failure status.
2.1.0 (2019-12-19)
Provide an option to export diff files to a specific folder when a conflict is detected
Add a new option to specify a diff destination folder:
-d, --diff PATH A folder where to generate unified diff files output
2.0.2 (2019-12-10)
Support for non UTF8 and non colorized output(s)
Add two new flag to enable specific output formating:
-a, --ascii Only use ASCII symbols to display results -b, --no_color Do not colorized the output
2.0.1 (2019-08-06)
MacOSX and Windows support
Note for Windows users:
Windows usage is supported with some limitations:
- No colored output.
- Currently I have no idea on how to fix this.
- Some UTF-8 symbols used in output are only with some fonts like
DejaVu Sans Mono.
- In future, I will try to implement a version of script that do not request UTF-8 support to return results.
2.0.0 (2019-08-06)
vro-package-diff is now a Pypi hosted project
Changes:
- vro-package-diff is now a Pypi hosted project: vro-package-diff and so, can be installed with pip install command.
- An endpoit vro-diff to access to the tool from any path location.
- Usage of `click` to manage:
- inputs packages
- help
- legend display
- test feature
- A test feature
- Documentation is hosted on vro-package-diff.readthedocs.io
- Travis pipeline
1.0.0 (2018-02-22)
- First release.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size vro_package_diff-2.2.2-py2.py3-none-any.whl (12.2 kB) | File type Wheel | Python version py2.py3 | Upload date | Hashes View |
Filename, size vro_package_diff-2.2.2.tar.gz (1.5 MB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for vro_package_diff-2.2.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9d3977e830a30be43aef605593019a9f0e1bdd650d289756d69ab4cfe5f49137 |
|
MD5 | 4a542d05eb09f131f22541258317921f |
|
BLAKE2-256 | 35842c2b7ecc3a3345099427a6761c51ecd176c5a857fa2c4c1c1baf9ca7b76b |