/asciidoctorj-liquibase-extension

asciidoctorJ extension to generate an entity relationship model based on liquibase changesets

Primary LanguageJavaMIT LicenseMIT

AsciidoctorJ Liquibase Extension

CircleCI MIT License download

This AsciidoctorJ extension provides a macro to generate a entity relationship diagram based on liquibase changeset files. Currently only xml format for liquibase changeset files are supported. This extensions needs asciidoctor-diagram extension to work probably.

Installation

The extension is available in JCenter. To use this extension declare it as a dependency in asciidoctor-maven-plugin configuration.

<plugin>
	<groupId>org.asciidoctor</groupId>
	<artifactId>asciidoctor-maven-plugin</artifactId>
	<version>2.0.0-RC.1</version>
	<executions>
		<execution>
			<id>output-html</id>
			<phase>generate-resources</phase>
			<goals>
				<goal>process-asciidoc</goal>
			</goals>
			<configuration>
				<backend>html</backend>
			</configuration>
		</execution>
	</executions>
	<dependencies>
		<dependency> <!--(1)-->
			<groupId>com.uniqueck</groupId>
			<artifactId>asciidoctorj-liquibase-extension</artifactId>
			<version>1.0-SNAPSHOT</version> <!--(2)-->
		</dependency>
	</dependencies>
</plugin>
  1. asciidoctorj-liquibase-extension is added

  2. check for the latest version at JCenter

How To Use

liquibase macro without attributes
liquibase::src/test/resources/db/db.changelog-master.xml[]
db.changelog master
Figure 1. Generated image for liquibase macro
liquibase macro with attribute tillTag set to 1.X.FINAL
liquibase::src/test/resources/db/db.changelog-master.xml[tillTag=1.X.FINAL]
db.changelog master 1.X.FINAL
Figure 2. Generated image for liquibase macro with attribute tillTag

Attributes

  • tillTag parse liquibase changeset files only until tagDatabase matched definied value

ToDo