@agiledigital/mule-preview

Mule Preview

Summary

This is the core module of the Mule Preview project.

It is a self contained bundle that can be included in other projects to render Mule XML files in a browser context using React.

See the Mule Preview Browser Extension for example usage.

Instructions

The module exposes four components that can be imported and used in a React project:

• <MulePreviewDiffUrl contentUrls={["https://a.xml", "https://b.xml"] contentRoot="."} />
• <MulePreviewDiffContent contentStrings={["<mule></mule>", "<mule></mule>"] contentRoot="."} />
• <MulePreviewUrl contentUrl="https://a.xml" contentRoot="."} />
• <MulePreviewContent contentString="<mule></mule>" contentRoot="."} />

where:

• contentUrls is a tuple of two URLs to be diffed

• contentStrings is a tuple of two strings with XML content to be diffed

• contentUrl is a URL to be rendered as a preview

• contentString is a string with XML to be rendered as a preview

• contentRoot is the a prefix to prepend to any requests for the Mule component image files.

    import React from "react";
    import ReactDOM from "react-dom";
    import {
        MulePreviewDiffUrl,
    } from "mule-preview";
  
  
    ReactDOM.render(
        <MulePreviewDiffUrl
          contentUrls={["https://example.com/muleA.xml", "https://example.com/muleB.xml"]}
          contentRoot="."
        />,
        document.getElementById('root-node')
    );
  

Preparing

On a fresh checkout of the codebase you will need to extract the mappings and icon assets from Anypoint Studio using mule-metadata-extractor.

Download the latest release of mule-metadata-extractor and run the following commands:

export ANYPOINT_STUDIO_INSTALLATION=/opt/AnypointStudio
java -jar mule-metadata-extractor-1.0.14-standalone.jar -d "${ANYPOINT_STUDIO_INSTALLATION}" -o public/ generate-mappings
java -jar mule-metadata-extractor-1.0.14-standalone.jar -d "${ANYPOINT_STUDIO_INSTALLATION}" -o public/img/icons extract-images
java -jar mule-metadata-extractor-1.0.14-standalone.jar-d "${ANYPOINT_STUDIO_INSTALLATION}" -o public/img/icons apply-light-theme

At some point we may provide pre-extracted bundles that can be used with Mule Preview. We are still unsure about the licencing conditions around bundling and redistributing Mulesoft assets. We are waiting for a response from Mulesoft. In the meantime feel free to extract the files yourself for personal use.

Developing

To work on this module, the following command will mount Mule Preview in a test environment with hot reloading.

$ npm start

Simply navigate to http://localhost:8080 in a browser to view the test environment

Building

Simply run these command to produce a production build

$ npm run build

The release files will be placed in the "dist" folder

Acknowledgements

Math icons made by Freepik from www.flaticon.com

License