diff --git a/README.md b/README.md
index a7d0e0a..9992a3c 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,7 @@ Add dependency
com.ethlo.timeitu
- 1.10.0
+ 1.10.1-SNAPSHOTsmall
@@ -49,11 +49,9 @@ This is a collection of usage examples for parsing.
-#### parseRfc3339
-The simplest and fastest way to parse an RFC-3339 (ISO-8601 profile) timestamp by far!
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L63C5-L69C5)
+#### parseRfc3339 [» source](src/test/java/samples/parsing/ITUParserSamples.java#L63C5-L69C5)
+The simplest and fastest way to parse an RFC-3339 (ISO-8601 profile) timestamp by far!
```java
final String text = "2012-12-27T19:07:22.123456789-03:00";
final OffsetDateTime dateTime = ITU.parseDateTime(text);
@@ -61,11 +59,9 @@ assertThat(dateTime.toString()).isEqualTo(text);
```
-#### parseLenient
-Parses a date-time with flexible granularity. Works for anything from a year to a timestamp with nanoseconds, wih or without timezone offset!
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L74C5-L83C5)
+#### parseLenient [» source](src/test/java/samples/parsing/ITUParserSamples.java#L74C5-L83C5)
+Parses a date-time with flexible granularity. Works for anything from a year to a timestamp with nanoseconds, wih or without timezone offset!
```java
final String text = "2012-12-27T19:07:23.123";
final DateTime dateTime = ITU.parseLenient(text);
@@ -75,12 +71,10 @@ assertThat(formatted).isEqualTo(text);
```
-#### parseLenientWithCustomSeparators
+#### parseLenientWithCustomSeparators [» source](src/test/java/samples/parsing/ITUParserSamples.java#L89C5-L97C5)
+
In case you encounter the need for a somewhat different time-separator or fraction separator
you can use the `ParseConfig` to set up you preferred delimiters.
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L89C5-L97C5)
-
```java
final ParseConfig config = ParseConfig.DEFAULT.withDateTimeSeparators('T', '|').withFractionSeparators('.', ',');
final DateTime result = ITU.parseLenient("1999-11-22|11:22:17,191", config);
@@ -88,11 +82,9 @@ assertThat(result.toString()).isEqualTo("1999-11-22T11:22:17.191");
```
-#### parsePosition
-This allows you to track where to start reading. Note that the check for trailing junk is disabled when using ParsePosition.
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L102C5-L109C5)
+#### parsePosition [» source](src/test/java/samples/parsing/ITUParserSamples.java#L102C5-L109C5)
+This allows you to track where to start reading. Note that the check for trailing junk is disabled when using ParsePosition.
```java
final ParsePosition pos = new ParsePosition(10);
final OffsetDateTime result = ITU.parseDateTime("some-data,1999-11-22T11:22:19+05:30,some-other-data", pos);
@@ -101,11 +93,9 @@ assertThat(pos.getIndex()).isEqualTo(35);
```
-#### explicitGranularity
-This is useful if you need to handle different granularity with different logic or interpolation.
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L114C5-L134C5)
+#### explicitGranularity [» source](src/test/java/samples/parsing/ITUParserSamples.java#L114C5-L134C5)
+This is useful if you need to handle different granularity with different logic or interpolation.
```java
final TemporalHandler handler = new TemporalHandler() {
@@ -124,24 +114,19 @@ assertThat(result.toString()).isEqualTo("2017-12-06T00:00Z");
```
-#### lenientTimestamp
-In some real world scenarios, it is useful to parse a best-effort timestamp. To ease usage, we can easily convert a raw `DateTime` instance into `Instant`.
+#### lenientTimestamp [» source](src/test/java/samples/parsing/ITUParserSamples.java#L140C5-L145C5)
+In some real world scenarios, it is useful to parse a best-effort timestamp. To ease usage, we can easily convert a raw `DateTime` instance into `Instant`.
Note the limitations and the assumption of UTC time-zone, as mentioned in the javadoc.
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L141C5-L146C5)
-
```java
final Instant instant = ITU.parseLenient("2017-12-06").toInstant();
assertThat(instant.toString()).isEqualTo("2017-12-06T00:00:00Z");
```
-#### parseCustomFormat
-In case the format is not supported directly, you can build your own parser.
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L151C5-L170C5)
+#### parseCustomFormat [» source](src/test/java/samples/parsing/ITUParserSamples.java#L150C5-L169C5)
+In case the format is not supported directly, you can build your own parser.
```java
final DateTimeParser parser = DateTimeParsers.of(digits(DAY, 2), separators('-'), digits(MONTH, 2), separators('-'), digits(YEAR, 4), separators(' '), digits(HOUR, 2), digits(MINUTE, 2), digits(SECOND, 2), separators(','), fractions());
final String text = "31-12-2000 235937,123456";
@@ -150,11 +135,9 @@ assertThat(result.toString()).isEqualTo("2000-12-31T23:59:37.123456");
```
-#### parseUsingInterfaceRfc33939
-`DateTimerParser` interface for RFC-3339
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L175C5-L182C5)
+#### parseUsingInterfaceRfc33939 [» source](src/test/java/samples/parsing/ITUParserSamples.java#L174C5-L181C5)
+`DateTimerParser` interface for RFC-3339
```java
final DateTimeParser parser = DateTimeParsers.rfc3339();
final String text = "2000-12-31 23:59:37.123456";
@@ -163,11 +146,9 @@ assertThat(result.toString()).isEqualTo("2000-12-31T23:59:37.123456");
```
-#### parseUsingInterfaceLocalTime
-`DateTimerParser` interface for local time
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L187C5-L194C5)
+#### parseUsingInterfaceLocalTime [» source](src/test/java/samples/parsing/ITUParserSamples.java#L186C5-L193C5)
+`DateTimerParser` interface for local time
```java
final DateTimeParser parser = DateTimeParsers.localTime();
final String text = "23:59:37.123456";
@@ -176,11 +157,9 @@ assertThat(result.toString()).isEqualTo(text);
```
-#### parseUsingInterfaceLocalDate
-`DateTimerParser` interface for local date
-
-[» full source](src/test/java/samples/parsing/ITUParserSamples.java#L199C5-L206C5)
+#### parseUsingInterfaceLocalDate [» source](src/test/java/samples/parsing/ITUParserSamples.java#L198C5-L205C5)
+`DateTimerParser` interface for local date
```java
final DateTimeParser parser = DateTimeParsers.localDate();
final String text = "2013-12-24";
@@ -198,11 +177,9 @@ This is a collection of usage examples for formatting.
-#### formatRfc3339WithUTC
-The simplest and fastest way to format an RFC-3339 (ISO-8601 profile) timestamp by far!
-
-[» full source](src/test/java/samples/formatting/ITUFormattingSamples.java#L44C5-L52C5)
+#### formatRfc3339WithUTC [» source](src/test/java/samples/formatting/ITUFormattingSamples.java#L44C5-L52C5)
+The simplest and fastest way to format an RFC-3339 (ISO-8601 profile) timestamp by far!
```java
final OffsetDateTime input = OffsetDateTime.of(2012, 12, 27, 19, 7, 22, 123456789, ZoneOffset.ofHoursMinutes(-3, 0));
assertThat(ITU.formatUtcNano(input)).isEqualTo("2012-12-27T22:07:22.123456789Z");
@@ -219,11 +196,9 @@ assertThat(ITU.formatUtc(input)).isEqualTo("2012-12-27T22:07:22Z");
-#### parseLeapSecond
-Parse a valid leap-second (i.e. it is on a date that would allow for it, and it is also in the list of known actual leap-seconds).
-
-[» full source](src/test/java/samples/leapsecond/ITULeapSecondSamples.java#L43C5-L57C5)
+#### parseLeapSecond [» source](src/test/java/samples/leapsecond/ITULeapSecondSamples.java#L43C5-L57C5)
+Parse a valid leap-second (i.e. it is on a date that would allow for it, and it is also in the list of known actual leap-seconds).
```java
try {
ITU.parseDateTime("1990-12-31T15:59:60-08:00");
diff --git a/pom.xml b/pom.xml
index ceb7deb..4cc6821 100644
--- a/pom.xml
+++ b/pom.xml
@@ -23,7 +23,7 @@ limitations under the License.
com.ethlo.timebundleitu
- 1.10.0
+ 1.10.1-SNAPSHOTInternet Time UtilityExtremely fast date-time parser and formatter - RFC 3339 (ISO 8601 profile) and W3C format
@@ -171,7 +171,7 @@ limitations under the License.
org.codehaus.mojolicense-maven-plugin
- 2.0.0
+ 2.2.0falsetrue
@@ -186,7 +186,7 @@ limitations under the License.
apache_v22017
- Morten Haraldsen (ethlo)
+ Morten Haraldsen @ethlofalsefalse
@@ -228,6 +228,19 @@ limitations under the License.
3.4.3
+
+
+ src/main/resources
+
+
+ true
+ ${project.basedir}/src/site
+
+ README.md
+
+ ${project.basedir}
+
+
@@ -300,6 +313,27 @@ limitations under the License.
+
+ com.ethlo.maven
+ java-code-extractor-maven-plugin
+ 1.0.0-SNAPSHOT
+
+ src/site/sample-code.template.md
+
+
+
+
+
+
+
+
+ initialize
+
+ extract
+
+
+
+
diff --git a/src/site/sample-code.template.md b/src/site/sample-code.template.md
index a7ee395..7972540 100644
--- a/src/site/sample-code.template.md
+++ b/src/site/sample-code.template.md
@@ -2,13 +2,10 @@
{% for method in methods %}
-#### {{method.name}}
+#### {{method.name}} [» source]({{class.path}}/{{class.name}}.java#L{{method.range.begin.line}}C{{method.range.begin.column}}-L{{method.range.end.line}}C{{method.range.end.column}})
{{method.description | trim | raw }}
-
-[» full source]({{class.path}}/{{class.name}}.java#L{{method.range.begin.line}}C{{method.range.begin.column}}-L{{method.range.end.line}}C{{method.range.end.column}})
-
```java
{{method.body | trim | raw }}
diff --git a/src/test/java/samples/parsing/ITUParserSamples.java b/src/test/java/samples/parsing/ITUParserSamples.java
index 90bf397..ca41879 100644
--- a/src/test/java/samples/parsing/ITUParserSamples.java
+++ b/src/test/java/samples/parsing/ITUParserSamples.java
@@ -135,7 +135,6 @@ public OffsetDateTime handle(final OffsetDateTime offsetDateTime)
/*
In some real world scenarios, it is useful to parse a best-effort timestamp. To ease usage, we can easily convert a raw `DateTime` instance into `Instant`.
-
Note the limitations and the assumption of UTC time-zone, as mentioned in the javadoc.
*/
@Test