xmlcreate

WebJar for xmlcreate

License

License

GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

xmlcreate
Last Version

Last Version

2.0.1
Release Date

Release Date

Type

Type

jar
Description

Description

xmlcreate
WebJar for xmlcreate
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/michaelkourlas/node-xmlcreate

Download xmlcreate

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/xmlcreate/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>xmlcreate</artifactId>
    <version>2.0.1</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/xmlcreate/
implementation 'org.webjars.npm:xmlcreate:2.0.1'
// https://jarcasting.com/artifacts/org.webjars.npm/xmlcreate/
implementation ("org.webjars.npm:xmlcreate:2.0.1")
'org.webjars.npm:xmlcreate:jar:2.0.1'
<dependency org="org.webjars.npm" name="xmlcreate" rev="2.0.1">
  <artifact name="xmlcreate" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='xmlcreate', version='2.0.1')
)
libraryDependencies += "org.webjars.npm" % "xmlcreate" % "2.0.1"
[org.webjars.npm/xmlcreate "2.0.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

xmlcreate

Build Status npm version

Overview

xmlcreate is a Node.js module that can be used to build XML using a simple API.

Features

xmlcreate allows you to use a series of chained function calls to build an XML tree.

Once the tree is built, it can be serialized to text. The formatting of the text is customizable.

xmlcreate can perform some basic validation to check that the resulting XML is well-formed.

Installation

The easiest way to install xmlcreate is using npm:

npm install xmlcreate

You can also build xmlcreate from source using npm:

git clone https://github.com/michaelkourlas/node-xmlcreate.git
npm install
npm run-script build

The build script will build the production variant of xmlcreate, run all tests, and build the documentation.

You can build the production variant without running tests using the script prod. You can also build the development version using the script dev. The only difference between the two is that the development version includes source maps.

Usage

The documentation for the current version is available here.

You can also build the documentation using npm:

npm run-script docs

Examples

The following TypeScript example illustrates the basic usage of xmlcreate:

import {document} from "xmlcreate";

const tree = document();
tree
    .decl({encoding: "UTF-8"})
        .up()
    .dtd({
             name: "html",
             pubId: "-//W3C//DTD XHTML 1.0 Strict//EN",
             sysId: "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
        })
        .up()
    .element({name: "html"})
        .attribute({name: "xmlns"})
            .text({charData: "http://www.w3.org/1999/xhtml"})
                .up()
            .up()
        .attribute({name: "xml:lang"})
            .text({charData: "en"})
                .up()
            .up()
        .element({name: "head"})
            .element({name: "title"})
                .charData({charData: "My page title"})
                    .up()
                .up()
            .up()
        .element({name: "body"})
            .element({name: "h1"})
                .charData({charData: "Welcome!"})
                    .up()
                .up()
            .element({name: "p"})
                .charData({charData: "This is some text on my website."})
                    .up()
                .up()
        .element({name: "div"})
            .element({name: "img"})
                .attribute({name: "src"})
                    .text({charData: "picture.png"})
                        .up()
                    .up()
                .attribute({name: "alt"})
                    .text({charData: "picture"}).up().up().up().up().up();

console.log(tree.toString({doubleQuotes: true}));

This example produces the following XML:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
    <head>
        <title>My page title</title>
    </head>
    <body>
        <h1>Welcome!</h1>
        <p>This is some text on my website.</p>
    </body>
</html>

A JavaScript version of this example can be found in the examples directory.

Tests

xmlcreate includes a set of tests to verify core functionality. You can run the tests using npm:

npm run-script test-prod

The only difference between the test-prod and test-dev scripts is that the development version includes source maps.

License

xmlcreate is licensed under the Apache License 2.0. Please see the LICENSE.md file for more information.

Versions

Version
2.0.1
1.0.2