JSoup Configuration Externalization - JowliML

Simple library that allows you you externalize JSoup configuration in either JSON or JowliML (a very terse grammar)

License

License

MIT
Categories

Categories

jsoup Business Logic Libraries Configuration Application Layer Libs config
GroupId

GroupId

io.shick.jsoup
ArtifactId

ArtifactId

jsoup-configuration-jowli
Last Version

Last Version

1.0.3
Release Date

Release Date

Type

Type

jar
Description

Description

JSoup Configuration Externalization - JowliML
Simple library that allows you you externalize JSoup configuration in either JSON or JowliML (a very terse grammar)

Download jsoup-configuration-jowli

How to add to project

<!-- https://jarcasting.com/artifacts/io.shick.jsoup/jsoup-configuration-jowli/ -->
<dependency>
    <groupId>io.shick.jsoup</groupId>
    <artifactId>jsoup-configuration-jowli</artifactId>
    <version>1.0.3</version>
</dependency>
// https://jarcasting.com/artifacts/io.shick.jsoup/jsoup-configuration-jowli/
implementation 'io.shick.jsoup:jsoup-configuration-jowli:1.0.3'
// https://jarcasting.com/artifacts/io.shick.jsoup/jsoup-configuration-jowli/
implementation ("io.shick.jsoup:jsoup-configuration-jowli:1.0.3")
'io.shick.jsoup:jsoup-configuration-jowli:jar:1.0.3'
<dependency org="io.shick.jsoup" name="jsoup-configuration-jowli" rev="1.0.3">
  <artifact name="jsoup-configuration-jowli" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.shick.jsoup', module='jsoup-configuration-jowli', version='1.0.3')
)
libraryDependencies += "io.shick.jsoup" % "jsoup-configuration-jowli" % "1.0.3"
[io.shick.jsoup/jsoup-configuration-jowli "1.0.3"]

Dependencies

compile (2)

Group / Artifact Type Version
io.shick.jsoup : jsoup-configuration-core jar 1.0.3
org.jparsec : jparsec jar 2.3

test (2)

Group / Artifact Type Version
junit : junit jar 4.12
org.mockito : mockito-core jar 1.10.19

Project Modules

There are no modules declared in this project.

jsoup-configuration

Maven Status Build Status Coverage Status Dependency Status License

This library was born from the need to externalize JSoup's HTML Whitelist. Deploying code for constant tweaks to the Whitelist's configuration was cumbersome. This library allows me to update the configuration outside the code (in JSON or JowliML).

Usage

Pick your flavor, using JSON or JowliML and include the appropriate dependency.

In pom.xml, add the following:

<dependency>
    <groupId>io.shick.jsoup</groupId>
    <artifactId>jsoup-configuration-gson</artifactId>
    <version>1.0.1</version>
</dependency>

Then in your Java code

// you can simply instantiate the parser
final Whitelist whitelist = new GsonParser().parse(json).whitelist();

// or you can get a parser by 'type', (either gson or jowli)
final Whitelist whitelist = WhitelistConfigurationParserFactory.newParser("gson").parse(json).whitelist();

// or you can append to an existing whitelist
final Whitelist whitelist = new GsonParser().parse(json).apply(Whitelist.basic());

// you can construct a new config and serialize it out too!
WhitelistConfiguration wlc = new BasicWhitelistConfiguration().enforceAttribute("a","rel","nofollow");

final String jowli = new JowliMLFormatter().format(wlc).toString();   //jowliml
final String json = new GsonFormatter().format(wlc).toString();       //json

Formats

JSON

{
  "base" : "basic", /* basic, basicwithimages, relaxed, none, or null */
  "tags" : ["a","b"],
  "attributes" : {
    "blockquote": ["cite"]
    },
  "enforcedAttributes": {
    "a" : {
      "rel" : "nofollow"
      }
    },
  "protocols" : {
    "a" : { 
      "href":["ftp", "http", "https", "mailto"]
      }
    }
}

JowliML

The point of JowliML is to provide a very terse representation of the whitelist rules. What you see below is the same as the above JSON but in a much more compact, externalized configuration friendly format.

(all on one line)
b:b;    /* note this can be b=basic, i=basicwithimages, n=none, r=relaxed */
t:a,b;
a:blockquote[cite],a[href,rel];
e:a[rel:nofollow];
p:a[href:[ftp,http,https,mailto]]

All directives are optional and additive. In the case of 'b', the last one wins. What? Basically...

t:a,b

is equivalent to :

t:a;t:b

LICENSE

MIT

Versions

Version
1.0.3
1.0.2
1.0.1