Skip to content

Cyc Core API Suite 1.0.0-rc3

Pre-release
Pre-release
Compare
Choose a tag to compare
@nwinant nwinant released this 09 Dec 22:45
· 25 commits to master since this release

The third release candidate of Cycorp's new Java API suite for interacting with the Cyc inference engine and knowledge base.

For more information, view the README.md bundled with this release or visit the Cyc Developer Center.

Note that 1.0.0-rc3 is not backwards-compatible with earlier releases. It is expected that more release candidates will follow. Until the final 1.0.0 release, it is expected that future release candidates will break backwards compatibility.

Changes

New: Support for upcoming OpenCyc release

Adds support for the planned upcoming release of OpenCyc 5.0-preview. Note that the OpenCyc server will not have support for advanced features such as QuerySearch or ProofViewJustification. Classes and methods which are not supported by OpenCyc will reflect this in their javadoc description and in their signature by declaring that they throw a com.cyc.session.exception.OpenCycUnsupportedServerException.

There are no plans to support previous versions of OpenCyc.

Improved: Core API Specification

  • Query API interfaces moved into CoreAPISpec Maven module.
  • Adds the QueryFactory (com.cyc.query.QueryFactory) to facilitate query construction.
  • Compatibility with different Cyc server editions and versions is now better-documented via the UnsupportedCycOperationException and OpenCycUnsupportedFeatureException exceptions.

Other changes

  • Speeds up KB API conversion of terms to KBObjects, which in turn speeds up Query#getResultSet()#getKBObject(). This resolves issue 2.
  • Core API Suite can detect and apply missing SubL code patches to a Cyc server. This behavior is disabled by default, but is easily enabled via System properties. See server-patching.md for details.
  • Links to Cyc Dev Center have been modified to reflect improved URL scheme.
  • Assorted bug fixes.

Example code

Example code designed to work with this release may be found in Cyc Core API Use Cases 1.0.0-rc3.

Standalone Bundle

If you're not using Apache Maven, or can't allow Maven to retrieve dependencies from the Internet, you may download this release in a standalone bundle containing:

  • A compiled cyc-core-suite-1.0.0-rc3-jar-with-dependencies.jar
  • A CoreAPITests project containing the source code for all of the unit tests from the Core API Suite, and the dependencies necessary to run them. This project may be run in Maven or as a native Eclipse project.
  • The CycCoreAPI source code (requires Maven to compile)
  • The CoreAPIUseCases source code (requires Maven to compile)

The bundle is available from the releases page as a tar or zip file:

  • cyc-core-suite-standalone-1.0.0-rc3.tar.gz
  • cyc-core-suite-standalone-1.0.0-rc3.zip