Project icon

com.io7m.blackthorne

Build status Maven Central Codecov

The blackthorne package implements a convenient functional API for extracting values from stream-parsed XML without needing to keep the entire document in memory.

Contents

Features

  • OSGi-ready
  • JPMS-ready
  • High coverage automated test suite
  • ISC license

Releases

The most recently published version of the software is 2.0.2.

Source code and binaries are available from the repository.

Documentation

Documentation for the 2.0.2 release is available for reading online.

Documentation for current and older releases is archived in the repository.

User documentation

No user documentation is currently available.

Maven

The following is a complete list of the project's modules expressed as Maven dependencies:

<dependency>
  <groupId>com.io7m.blackthorne</groupId>
  <artifactId>com.io7m.blackthorne</artifactId>
  <version>2.0.2</version>
</dependency>

<dependency>
  <groupId>com.io7m.blackthorne</groupId>
  <artifactId>com.io7m.blackthorne.core</artifactId>
  <version>2.0.2</version>
</dependency>

<dependency>
  <groupId>com.io7m.blackthorne</groupId>
  <artifactId>com.io7m.blackthorne.tests</artifactId>
  <version>2.0.2</version>
</dependency>

<dependency>
  <groupId>com.io7m.blackthorne</groupId>
  <artifactId>com.io7m.blackthorne.jxe</artifactId>
  <version>2.0.2</version>
</dependency>

Each release of the project is made available on Maven Central within ten minutes of the release announcement.

Changes

Subscribe to the releases atom feed.

2024-08-17 Release: com.io7m.blackthorne 2.0.2
2024-05-13 Change: Update org.mockito:mockito-core:5.11.0 → 5.12.0.
2024-05-23 Change: Update net.bytebuddy:byte-buddy-agent:1.14.15 → 1.14.16.
2024-05-23 Change: Update net.bytebuddy:byte-buddy:1.14.15 → 1.14.16.
2024-05-27 Change: Update jqwik.version:1.8.4 → 1.8.5.
2024-05-30 Change: Update net.byte-buddy.version:1.14.16 → 1.14.17.
2024-06-28 Change: Update org.junit:junit-bom:5.10.2 → 5.10.3.
2024-07-01 Change: Update jqwik.version:1.8.5 → 1.9.0.
2024-07-09 Change: Update net.byte-buddy.version:1.14.17 → 1.14.18.
2024-08-05 Change: Update com.io7m.seltzer:com.io7m.seltzer.api:1.0.1 → 1.1.0.
2024-08-07 Change: Update org.slf4j:slf4j-api:2.0.13 → 2.0.14.
2024-08-09 Change: Update org.slf4j:slf4j-api:2.0.14 → 2.0.15.
2024-08-12 Change: Update org.slf4j:slf4j-api:2.0.15 → 2.0.16.
2024-08-15 Change: Update org.junit:junit-bom:5.10.3 → 5.11.0.
2024-08-16 Change: Update net.byte-buddy.version:1.14.18 → 1.14.19.
2024-08-16 Change: Update ch.qos.logback:logback-classic:1.5.6 → 1.5.7.
2024-08-17 Change: Fix a bug in the scalar element handler that could cause partial strings to be returned. (tickets: 43 )
2024-05-10 Release: com.io7m.blackthorne 2.0.1
2024-04-21 Change: Update jqwik.version:1.8.2 → 1.8.4.
2024-04-21 Change: Update ch.qos.logback:logback-classic:1.4.14 → 1.5.6.
2024-04-21 Change: Update nl.jqno.equalsverifier:equalsverifier:3.15.5 → 3.16.1.
2024-04-21 Change: Update net.bytebuddy:byte-buddy-agent:1.14.11 → 1.14.13.
2024-04-21 Change: Update org.slf4j:slf4j-api:2.0.10 → 2.0.13.
2024-04-22 Change: Update com.io7m.junit.version:5.10.1 → 5.10.2.
2024-04-22 Change: Update net.bytebuddy:byte-buddy:1.14.11 → 1.14.13.
2024-04-22 Change: Update org.mockito:mockito-core:5.8.0 → 5.11.0.
2024-04-28 Change: Update net.bytebuddy:byte-buddy:1.14.13 → 1.14.14.
2024-04-28 Change: Update net.bytebuddy:byte-buddy-agent:1.14.13 → 1.14.14.
2024-05-05 Change: Update com.io7m.jaffirm:com.io7m.jaffirm.core:4.0.0 → 4.0.1.
2024-05-08 Change: Update com.io7m.jxe:com.io7m.jxe.core:1.0.2 → 1.0.3.
2024-05-08 Change: Update com.io7m.jlexing:com.io7m.jlexing.core:3.1.0 → 3.2.0.
2024-05-09 Change: Update com.io7m.seltzer:com.io7m.seltzer.api:1.0.0 → 1.0.1.
2024-05-09 Change: Update net.bytebuddy:byte-buddy-agent:1.14.14 → 1.14.15.
2024-05-09 Change: Update net.bytebuddy:byte-buddy:1.14.14 → 1.14.15.
2024-05-10 Change: Move to new organization.
2023-08-10 Release: com.io7m.blackthorne 2.0.0
2023-08-08 Change: (Backwards incompatible) Make parse errors into Seltzer errors.
2023-08-08 Change: (Backwards incompatible) Remove immutables.org types in favour of plain records.
2023-08-08 Change: Update dependencies.
2023-08-08 Change: (Backwards incompatible) Add the ability to opt-out of receiving lexical information from parsers.
2023-08-08 Change: (Backwards incompatible) Rename com.io7m.blackthorne.api -> com.io7m.blackthorne.core.
2023-08-08 Change: (Backwards incompatible) Upgrade BTException to be a structured (Seltzer) exception.
2022-04-09 Release: com.io7m.blackthorne 1.3.1
2022-04-09 Change: Update junreachable
2022-04-09 Change: Update jaffirm
2022-04-09 Change: Update jlexing
2022-02-11 Release: com.io7m.blackthorne 1.3.0
2022-02-11 Change: Ensure that exceptions are raised for validation errors
2021-02-06 Release: com.io7m.blackthorne 1.2.1
2021-02-06 Change: Ensure that scalar element handlers never return null for empty elements (tickets: 4 )
2021-01-24 Release: com.io7m.blackthorne 1.2.0
2021-01-24 Change: Add logging for content handlers (tickets: 3 )
2021-01-24 Change: Add more convenience methods for scalar elements (tickets: 2 )
2020-10-24 Release: com.io7m.blackthorne 1.1.0
2020-10-24 Change: Allow content handlers to throw raw exceptions (tickets: 2 )
2020-10-15 Release: com.io7m.blackthorne 1.0.0

Sources

This project uses Git to manage source code.

Repository: https://www.github.com/io7m-com/blackthorne

$ git clone https://www.github.com/io7m-com/blackthorne

License

Copyright © 2024 Mark Raynsford <code@io7m.com> https://www.io7m.com

Permission to use, copy, modify, and/or distribute this software for
any purpose with or without fee is hereby granted, provided that the
above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR
BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES
OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
SOFTWARE.

Bug Tracker

The project uses GitHub Issues to track issues.