Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yegor256/xsline

Declarative and Immutable Java Chain of XSL Transformations
https://github.com/yegor256/xsline

java oop xml xsl xslt

Last synced: 21 days ago
JSON representation

Declarative and Immutable Java Chain of XSL Transformations

Host: GitHub
URL: https://github.com/yegor256/xsline
Owner: yegor256
License: mit
Created: 2022-03-30T14:17:27.000Z (over 2 years ago)
Default Branch: master
Last Pushed: 2024-10-23T16:44:09.000Z (28 days ago)
Last Synced: 2024-10-23T23:27:09.138Z (28 days ago)
Topics: java, oop, xml, xsl, xslt
Language: Java
Homepage:
Size: 313 KB
Stars: 11
Watchers: 4
Forks: 4
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Awesome Lists containing this project

README

        [![EO principles respected here](https://www.elegantobjects.org/badge.svg)](https://www.elegantobjects.org)

[![DevOps By Rultor.com](http://www.rultor.com/b/yegor256/xsline)](http://www.rultor.com/p/yegor256/xsline)

[![We recommend IntelliJ IDEA](https://www.elegantobjects.org/intellij-idea.svg)](https://www.jetbrains.com/idea/)

[![mvn](https://github.com/yegor256/xsline/actions/workflows/mvn.yml/badge.svg)](https://github.com/yegor256/xsline/actions/workflows/mvn.yml)

[![PDD status](http://www.0pdd.com/svg?name=yegor256/xsline)](http://www.0pdd.com/p?name=yegor256/xsline)

[![Maintainability](https://api.codeclimate.com/v1/badges/742bde48ea6fabdba1ce/maintainability)](https://codeclimate.com/github/yegor256/xsline/maintainability)

[![Maven Central](https://img.shields.io/maven-central/v/com.yegor256/xsline.svg)](https://maven-badges.herokuapp.com/maven-central/com.yegor256/xsline)

[![Javadoc](http://www.javadoc.io/badge/com.yegor256/xsline.svg)](http://www.javadoc.io/doc/com.yegor256/xsline)

[![codecov](https://codecov.io/gh/yegor256/xsline/branch/master/graph/badge.svg)](https://codecov.io/gh/yegor256/xsline)

[![Hits-of-Code](https://hitsofcode.com/github/yegor256/xsline)](https://hitsofcode.com/view/github/yegor256/xsline)

![Lines of code](https://img.shields.io/tokei/lines/github/yegor256/xsline)

[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/xsline/blob/master/LICENSE.txt)

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=yegor256_xsline&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=yegor256_xsline)

Read this blog post too: [Declarative and Immutable Pipeline of Transformations](https://www.yegor256.com/2022/08/10/xsline-immutable-pipeline.html)

Also, watch [this video](https://www.youtube.com/watch?v=C6CQWzOKEJs) from Object Thinking Meetup #7.

It's a declarative and immutable chain of XSL transformations in Java, 

which is more convenient than an imperative routine application 

of transformations one by one. [EO compiler](https://github.com/objectionary/eo) 

is an example use case: the source code compiles to XML and then has

to go through a few dozen transformations written in XSL. Each transformation

has to be logged, validated, and in general be flexibly configurable. We started

with a series of consecutive instantiations and executions of 

[`XSLDocument`](https://www.javadoc.io/doc/com.jcabi/jcabi-xml/0.21.5/com/jcabi/xml/XSLDocument.html),

but then realized the necessity to turn this workflow into something more

object-oriented. This is how this library was born.

You add this to your `pom.xml` (find the latest version [here](https://github.com/yegor256/xsline/releases)):

```xml

  com.yegor256

  xsline

  

```

Use it like this:

```java

import com.jcabi.xml.XML;

import com.jcabi.xml.XMLDocument;

import com.jcabi.xml.XSLDocument;

import com.yegor256.xsline.Shift;

import com.yegor256.xsline.StXSL;

import com.yegor256.xsline.TrDefault;

import com.yegor256.xsline.Train;

import com.yegor256.xsline.Xsline;

import java.io.File;

Train train = new TrDefault()

  .with(new StXSL(new XSLDocument(new File("first.xsl"))))

  .with(new StXSL(new XSLDocument(new File("second.xsl"))));

XML input = new XMLDocument("");

XML output = new Xsline(train).pass(input);

```

This will transform your `input` XML document through two XSL stylesheets.

## How to Contribute

Fork repository, make changes, send us a [pull request](https://www.yegor256.com/2014/04/15/github-guidelines.html).

We will review your changes and apply them to the `master` branch shortly,

provided they don't violate our quality standards. To avoid frustration,

before sending us your pull request please run full Maven build:

```bash

$ mvn clean install -Pqulice

```

You will need Maven 3.3+ and Java 8+.