README.md

JRut

A reasonable Rut implementation... in Java

What's a Rut anyway?

It's Chile's SSN.

What's reasonable?

• Comparable instances of JRut have a "natural order" and implement .equals as expected
• Serializable instances of JRut can be serialized out of the box
• Immutable instances of JRut can be used in multi-threaded code without problems =]
• Validated Chile's SSN integrates a validation that's also taken care of

Why make a library out of this?

• An open source library, should, in time, provide a reasonable set of tests.
• Low compatibility (Java 5).
• No dependencies.

How to use it?

The usual:

<dependency>
   <groupId>cl.daplay</groupId>
   <artifactId>jrut</artifactId>
   <version>1.0.1</version>
</dependency>

or

compile "cl.daplay:jrut:1.0.1"

and then...

import cl.daplay.jrut.JRut;

// Handles multiple formats
final JRut a = new JRut("5252856-9");
final JRut b = new JRut("1.0.1-9");
final JRut c = new JRut("52528569");

// Throws IllegalArgumentException on invalid arguments
try {
    final JRut c = new JRut("5252856K");
} catch (IllegalArgumentException ex) {
    // ...
}

// Pretty print
final JRut a = new JRut("52528569");
// prints "5.252.856-9"
System.out.println(a);

Building

Just run

./gradlew build