Skip to content

Latest commit

 

History

History
175 lines (126 loc) · 7.9 KB

CHANGELOG.md

File metadata and controls

175 lines (126 loc) · 7.9 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

Changed

  • Tests load functions_grel.ttl from the grel-functions-java v0.11.1 jar instead of a copy in src/test/resources.
  • Maven Central deployments are named after the artifact and its version, such as function-agent-java 2.0.1.
  • HANDBOOK: the agent request contract follows the software-handbook contract of 2026-11-18.

2.0.0 - 2026-10-08

Changed

  • Breaking: the package be.ugent.idlab.knows.functions.agent.functionIntantiation is renamed to be.ugent.idlab.knows.functions.agent.functionInstantiation; update the imports of Instantiator, ThrowableFunction and its exception classes.
  • Breaking: FileFinder moved from be.ugent.idlab.knows.misc to be.ugent.idlab.knows.functions.agent.util.
  • Breaking: renamed exceptions: functionInstantiation.exception.InstantiationException → FunctionInstantiationException, functionInstantiation.exception.ClassNotFoundException → ImplementationClassNotFoundException, fno.exception.FunctionNotFoundException → FunctionResourceNotFoundException, CompositionEndPointNotFound → CompositionEndPointNotFoundException, CompositionStartingPointNotFound → CompositionStartingPointNotFoundException.
  • Breaking: the enum fno.NAMESPACES is renamed to fno.Namespaces.
  • Release tooling: RELEASE.md documents the steps; bump-version.sh checks the version format and moves to the next patch -SNAPSHOT after a release.
  • commons-collections4 and jena-core are declared dependencies.

Fixed

  • Breaking: Agent.execute with an unknown function id throws functionInstantiation.exception.FunctionNotFoundException; it threw the FnO parsing exception (a FnOException) before.

Removed

  • The jar-with-dependencies artifact; dependencies resolve transitively from the POM.

1.5.1 - 2026-08-26

1.5.0 - 2026-08-25

Fixed

  • When calculating the number of parameters of a function given the arguments, take into account that FnO parameters might be referred to by their resource id.

Added

  • Agent: added getFunctions method to retrieve all loaded functions.
  • Added class FnOParameter, a subclass of Parameter which holds a resource URI and a return type URI. Each parameter of a function provided by the FnOFunctionModelProvider is now an instance of FnOParameter.

1.4.0 - 2026-08-19

Added

  • Regression tests for optional-parameter overload handling and scalar argument validation.

Changed

  • Non-collection parameters now reject multiple supplied values instead of silently taking the first one.

Fixed

  • Omitted trailing optional parameters now resolve to the matching shorter Java overload when available.
  • Updated dependencies to latest stable versions: jena-arq 4.9.0, JUnit 5.10.2, grel-functions-java v0.10.0.

1.3.0 - 2025-12-22

Changed

  • Required Java language is 21

Fixed

  • Removed dependency on Project Lombok; replaced data classes with records where possible.
  • Removed dependency on commons-collections-4; use Java built-in to read a file.
  • Updated jena-arq to 4.9.0
  • Updated JUnit to 5.10.2
  • Updated grel-functions-java to v0.10.0
  • Updated Maven build plugins
  • Publishing: switched to new Maven Central repository

1.2.1 - 2025-02-26

Fixed

  • Added DefaultConverter for parameters of type Object.
  • Made Function Agent compatible with Java 21.

1.2.0 - 2023-11-22

Added

  • Everything required to publish on Maven Central.

Changed

  • Use new idlab-functions-java prefix in tests.

1.1.0 - 2023-01-12

Added

  • Agent is now AutoCloseable. This leads to Instantiator calling the close() method on loaded function library classes.

1.0.0 - 2022-12-08

Changed

  • Updated JUnit from 4.13.2 to 5.9.1 (tests)
  • Updated grel-functions-java from v0.7.3 to v0.9.0 (tests)
  • Updated jena-arq from 3.17.0 to 4.6.1
  • Updated Lombok from 1.18.22 to 1.18.24
  • Updated slf4j from 1.7.36 to 2.0.5
  • Java language version changed to 11; requires JRE >= 11 to run
  • be.ugent.idlab.knows.functions.agent.Agent: deleted methods that were not meant to be in this interface again.

Fixed

  • be.ugent.idlab.knows.functions.agent.AgentTest.testGrelClassesOnClassPathRemoteFnODoc: point remote grel.ttl to specific GitHub commit to keep function definitions and implementations in sync.

0.2.1 - 2022-10-10

Fixed

  • If the DataTypeConverter of the generic type parameter of a Collection is not found, try to find a DataTypeConverter that can process a subtype of the generic type ((see GitLab issue 14)).

0.2.0 - 2022-09-01

Added

  • Support for rdf:seq parameters.
  • FnoFunctionModelProvider: Can now parse Function Composition.
  • FnoFunctionModelProvider: Can now parse Partial Function Application.
  • Agent: Can execute Function Compositions.
  • Agent: Can execute Partial Function Application.
  • Agent: Has a debug mode.
  • Instantiator: In debug mode it will execute all nodes of a composition, otherwise only those necessary for the output (works non-recursive).
  • DescriptionGenerator: Can now output Function triples (both execution and functions/mappings from JAVA methods)

Fixed

  • Instantiator: fixed Windows path resolving issues.
  • Instantiator: fixed URL decoding for special characters in path.

0.1.0 - 2022-05-25

Added

  • FnoFunctionModelProvider: Implementation locations can be changed w.r.t. what's in the function descriptions by providing a map old location -> new location. This feature allows to use the right location at runtime without changing the function descriptions.

0.0.4 - 2022-05-17

Fixed

  • A raw collections used as parameter in an implementation was not recognised as collection (see GitLab issue 6).

0.0.3 - 2022-05-13

Changed

  • Let GitLab CI use JDK 8 instead of JDK 11, because that's the lowest supported Java version.
  • Improved compatibility checks between parameter descriptions and implementations.

Added

  • Converters for all primitive types.

Fixed

  • Compatibility in data types between (FnO) description and implementation. (see GitLab issue 5)

0.0.2 - 2022-03-29

Changed

  • Update dependency grel-functions-java to bugfix release version v0.7.2.

Fixed

  • FnO implementation mappings have class fno:Mapping instead of fnoi:Mapping.

0.0.1 - 2022-03-25