vro-action-extractor

A Universal CLI tool to extract Scriptable Actions from vRealize Orchestrator (vRO) / VMware Aria Automation Orchestrator environments. It converts Workflows, Packages, and Folder structures into clean code files with automated documentation generation.

Features

• Polyglot Extraction: Extracts code for multiple runtimes:
  • JavaScript / Node.js (.js)
  • Python (.py)
  • PowerShell / PowerCLI (.ps1)
• Smart Documentation: Generates language-specific documentation automatically:
  • JSDoc for JavaScript (/** ... */)
  • Docstrings for Python (""" ... """)
  • Comment-Based Help for PowerShell (<# ... #>)
• Universal Import: Supports multiple source formats:
  • .package Files: Direct extraction from vRO exports (Zip).
  • Directory Structures: Recursively scans folders (e.g., from a Git repo).
  • Flat XMLs: Individual workflow files.
• Smart Naming: Uses display names for coherent file naming.
• Conflict Resolution: Handles duplicate action names automatically.

Installation

npm install -g vro-action-extractor

Usage

The tool exposes the vro-extract command:

1. Extract from a Package File

vro-extract "path/to/my-package.package"

Creates Actions and Workflows folders in the same directory as the package.

2. Extract from a Directory (e.g., Git Repo)

vro-extract "path/to/project_root"

Scans for all valid data and .xml files recursively and extracts them into Actions and Workflows folders relative to their source.

3. Extract from Single XML

vro-extract "path/to/workflow.xml" [output_directory]

Folder Structure & Examples

The tool organizes extracted scripts into Actions and Workflows directories.

Output Structure

.
├── Actions/
│   └── com/
│       └── vmware/
│           └── library/
│               └── myAction.js          (Action: com.vmware.library.myAction)
│               └── utilAction.py        (Action: com.vmware.library.utilAction)
└── Workflows/
    └── My_Complex_Workflow/
        ├── Validate_Inputs.js           (Scriptable Task)
        └── Call_External_API.py         (Scriptable Task)

Input vs Output

| Input Source | Output Location | Structure | |--------------|-----------------|-----------| | Package (my.package) | ./Actions/ ./Workflows/ | Actions are grouped by namespace (e.g. com/group/name). Workflows are in named folders. | | Directory (./src) | ./src/Actions/ ./src/Workflows/ | recursive extraction relative to found files. | | Single Workflow (wf.xml) | ./Workflows/Wf_Name/ | Creates a folder for the workflow relative to the input file. | | Single Action (action.xml) | ./Actions/com/group/ | Creates the group hierarchy relative to the input file. |

License

MIT