Skip to content

Latest commit

 

History

History
34 lines (23 loc) · 1.85 KB

README.md

File metadata and controls

34 lines (23 loc) · 1.85 KB

N|Solid

GV Frag - Fragmenting Utility Software for GAIA Projects

What it is

GV Frag is a work-in-progress, simple, open-source and experimental utility software that makes it easier for developers to work on a single GAIA Project indipendently and concurrently. So far, each GAIA deploy configuration rested in a single, huge XML file, making it a nightmare for medium-big sized projects that required multiple developers since changes had to be merged manually.

GVFrag solves that and provides a simple fragmenting structure that does not lose any data. Each developer can add features, modify services and merge each change into a single, up-to-date repository.

Requirements

  • Java JRE 1.11 (JDK 11) or above
  • GAIA (GreenVulcano ESB v4) working configuration XML file
  • Windows, Mac or Linux

Usage

Clone the gvfrag.jar file from this repository and place it anywhere.

Then, run by shell by typing the following command:

java -jar gvfrag.jar [OPTION] [/path/to/<GVCore.xml|GVFrag.xml>] [/optional/output/dir]

Options

  • -s (SPLIT) Takes GVCore.xml as input, and produces (in an output folder where the JAR file is located) multiple direcories that represent the tags, (such as GVServices/, GVSystems/, GVPolicy/, GVAdapters/) and a skeleton file (GVFrag.xml) that contains the remaining tags which were NOT split.

  • -m (MAKE) Takes GVFrag.xml as input, and searches for the necessary directories (such directories must be in the same folder as GVFrag.xml) and produces a fully functioning GVCore.xml file.

  • -h or --help Displays a useful help message.

WARNING: DO NOT USE IN PRODUCTION ENVIRONMENTS. GVFRAG IS AN EXPERIMENTAL FEATURE AND MAY RESULT IN XML DATA CORRUPTION.