Redland RDF Application Framework Bindings

Redland Bindings 1.0.8.1 Changes

The main change in this release is to synchronise with Redland 1.0.8 (Redland 1.0.8 release Notes) and provide a few other fixes and improvements.

Changed the configuration to prefer using pkg-config details over redland-config. This is the future and also makes linking work better on OSX.

Perl Bindings Changes

The Parser and Serializer class feature methods now cast values to/from Node for set/get when needed.

Python Bindings Changes

Modified linking to use new configure options --with-python-ldflags and --with-python_libext options to help systems such as Cygwin where the shared libraries are not .so

Ruby Bindings Changes

Updates to tests for expected SPARQL XML Results.

Redland Bindings 1.0.7.1 Changes

The main change in this release is to synchronise with Redland 1.0.7 (Redland 1.0.7 release Notes) and provide a few other fixes and improvements.

Removed Tcl, Java and C# APIs from the release as promised in Feb 2007

PHP Bindings Changes

Throws proper PHP5 exceptions when errors happen, passing along location information to the caller.

Null URIs and Redland nodes can be given with a PHP null.

Probably does not work on PHP4 anymore.

Python Bindings Changes

Parser class: Do not set rdfxml as default parser, let Redland figure that out.

Parser class: add method set_uri_filter to set the URI rejection filter function.

GRDDLParser class: added as a convenience class to create a parser of name 'grddl'.

Fixed Issue#0000212 : QueryResults.to_string is not working

Other changes

Updated SPARQL CONSTRUCT in perl example and test code Fixes Issue#0000247: Actuall v is 1.0.6.1 ; example.pl ends with an error

Updated autogen.sh to handle better vesioning, OSX glibtoolize and ltdl.

Some C# build fixes.

Redland Bindings 1.0.6.1 Changes

The main change in this release is to synchronise with Redland 1.0.6 (Redland 1.0.6 release Notes) and provide several other fixes and improvements.

Packaging and Configuration Changes

C# bindings changes

None

Java bindings changes

None

Perl bindings changes

Parser class gains namespaces_seen method to return hash of namespace prefix/uris seen during a parse.

PHP bindings changes

None

Python bindings changes

QueryResults class method __len__: Return 0 when the count is not 0 Fixes Issue #0000166

Model class method add_statement now raises an error if adding statement fails.

Node class constructor: Convert literals from Unicode to UTF-8 for redland n=RDF.Node(literal= u'this is unicode') now works Fixes Issue #0000147

Query class now raises an error if construction fails.

Serializer class constructor now defaults to none name, mime_type and raises an error if construction fails.

Ruby bindings changes

Apply patch from #0000121 again not properly fixed in previous patching owl.rb Fixes Issue #0000121

Uri, NodeIterator and QueryResults classes gain a finalizer to close and free up the redland objects on destruction.

Model, Parser, Query, Serializer and Store classes: Apply patch to comment out log .info calls. Fixes Issue #0000170 and Issue #0000172

Serializer class feature methods: Fix use of Node constructor. Fixes Issue #0000140

Serializer class method model_to_string: Fix null base_uri (Patch from Jeff Dutton)

Strem class fixed incorect call to librdf_free_model(stream) Fixes Issue #0000171

Tcl bindings changes

None

Redland Bindings 1.0.5.1 Changes

The main change in this release is to synchronise with Redland 1.0.5 (Redland 1.0.5 release Notes) and provide several other fixes and improvements.

Packaging and Configuration Changes

Patched configure to remove un-necessary tests for C++ or F77++ compilers that libtool stupidly insists on.

Added --with-python-ldflags for working around installing python in odd places.

Create directories before make install. Fixes Issue #0000126

C# bindings changes

Model class methods getSource, getArc and getTarget now return null rather than try to create a Node with null value.

Parser class constructors now working again, defaulting to RDF/XML parser.

Java bindings changes

Add Java Query and QueryResults classes and example of using them. Added Serializer method setNamespace.

Perl bindings changes

Parser class now allows undef arguments for base URIs.

PHP bindings changes

None.

Python bindings changes

Subclass python class Warning defined in C for making a RedlandWarning. Fixes Issue #0000109

Storage class gained some update docs.

Ruby bindings changes

Model class added method to_string. Removed several puts in methods. Method save now works when using default serializer and not filename.

Node class method from_node now calls Uri constructor properly.

Node class now defines bnode and anon to match docs Fixes Issue #0000122

Parser class now has constructor for a turtle parser.

QueryResults class added method bindings_count.

QueryResults class methods binding_value, binding_value_by_name now handle nil values.

Serializer class modified method set_namespace to use prefix, uri_ordering. Constructor now defaults to rdfxml syntax.

Storage class no longer echos storage options to stdout.

Added OWL_NS to owl.rb. Fixes Issue #0000121

Example gains query and serializer test code.

Removed some recursive includes of Redland.

Tcl bindings changes

None

Redland Bindings 1.0.4.1 Changes

The main change in this release is to synchronise with Redland 1.0.4 (Redland 1.0.4 release Notes) and provide some other minor fixes.

Packaging and Configuration Changes

Now using Subversion for version control and the Redland bindings installation instructions explain how to get Redland from Subversion.

C# bindings changes

Return null in more cases when a redland function returns 0/NULL for a function result..

Java bindings changes

Rename the SWIG accessor java functions for the constants which changed in some previous SWIG verison.

Perl bindings changes

No changes.

PHP bindings changes

No changes.

Python bindings changes

Fix module cleanup to ensure Redland.librdf_free_world lives till the end.

NS Class: Rename method node and local variables to __-prefixed names less likely to be used in a namespace.

Edit to allow omitting a literal language and make the default work with the updated typed literal fix in Redland 1.0.3

Ruby bindings changes

Build fixes for newer SWIG.

Tcl bindings changes

Update build configuration to record redland name/version correctly.

Redland Bindings 1.0.3.1 Changes

The main changes in this release are:

Synchronises with Redland 1.0.3 (Redland 1.0.3 release Notes)

Many fixes across multiple binding languages.

Version Control change: Redland Bindings will be switching to use Subversion for version control after the 1.0.2.1 release. Please check the Redland Subversion site for the latest status or the online Redland Bindings installation notes for the Redland Bindings specific subversion installation information.

Packaging and Configuration Changes

The build now generates a bindings.rdf DOAP file.

The autogen.sh script for building from a soruce code checkout was revamped to be more modular.

RPM spec file was updated. It now defines perl_sitearch, python_libdir, ruby_dir and ruby_libdir at RPM build time. The build requirements were split out and now declare minimum versions. Uses newer %configure and %{__make} macros and License header field.

C# bindings changes

Namespace fixes patch from John Barstow.

Update nunit console to newer.

Update C# syntax for Mono 1.8.x+.

Java bindings changes

No changes.

Perl bindings changes

QueryResults.to_string: return boolean format results.

Storage constructor: Improve storage options handling by allowing a perl hash options in addition to the current form of a string of redland options. Patch from Kjetil Kjernsmo.

PHP bindings changes

Insert phpinfo and module shutdown using SWIG alone which might work better.

Python bindings changes

Ruby bindings changes

Tcl bindings changes

No changes.

Redland Bindings 1.0.2.1 Changes

This release is mainly to synchronise with Redland 1.0.2

Perl bindings changes

Query results are now serialized to the latest SPARQL XML format.

A $VERSION variable is exported by the perl binding so that you can do use RDF::Redland 1.00_02 to ensure you get a certain version or newer.

Node class method new_literal modified to accept several classes of perl URI and fixed to promote them correctly to a redland URI.

Python bindings changes

Query results are now serialized to the latest SPARQL XML format.

Ruby bindings changes

Update the bindings for newer SWIG and re-order requires to make irb -r rdf/redland work (aredridel)

Redland Bindings 1.0.1.1 Changes

General Changes

The query demonstrations written in Perl now use the revised SPARQL syntax.

C# bindings changes

No changes.

Objective-C / Cocoa bindings changes

No changes.

Perl bindings changes

Perl. Added RDF::Redland methods set_log_handler and reset_log_handler to get structured error messages. Prefer this to the older handler.

Perl. Added convienience Node subclasses RDF::Redland::URINode, RDF::Redland::XMLLiteralNode, RDF::Redland::BlankNode and RDF::Redland::LiteralNode

PHP bindings changes

When returning NULL librdf_node* objects, convert them also to a PHP null.

Python bindings changes

Serializer class gains set_namespace method.

Adjust Node, Statement class comparisons to not assume the other parameter is of the right type. Remove 'return' from constructors. (Daniel Larsson).

Ruby bindings changes

Generate html documentation using rdoc (Nikolas Coukouma).

Tcl bindings changes

No changes.

Redland Bindings 1.0.0.2 Changes

General Changes

Removed bogus C include of the ../librdf dir from all bindings build; always just use whatever redland-config --cflags returns.

Perl bindings changes

Added methods for returning query results as RDF graphs, boolean results and as a syntax format such as RDF/XML for graphs, SPARQL Variable Binding Results XML Format for bindings. .

The error handling was altered for parsing methods class RDF::Redland::Model method load, class RDF::Redland::Parser methods parse_into_model and parse_string_into_model which now take an optional handler parameter that is a subroutine handler providing detailed log information. This can be used to capture or store detailed info on possibly multiple problems in parsing.

PHP bindings changes

Fix for swig calling zend_rsrc_list_get_rsrc_type incorrectly. Added PHP_MINFO_FUNCTION to report that Redland was loaded, the version of redland and the PHP bindings.

Python bindings changes

Change the way that redland errors and warnings are reported. There are now two choices. By default warnings are now generated immediately as a Python PyRedland_Warning warning. The first error generated is saved and thrown as an PyRedland_Error exception after the redland function returns. If multiple errors are generated, the remaining ones are left to the default redland error handler, which prints them to stderr.

The alternative is in parsing methods model.load, parser.parse_into_model and parser.parse_string_into_model which now take an optional handler parameter that is a subroutine handler providing detailed log information.

This change has a disadvantage in no longer allowing user-registration of callbacks but it does seem to work better with Python than the former mechanism of python calling C calling Python.

Redland Bindings 1.0.0.1 Changes

The main changes for this release are to provide additional query results formats, in Python only at present and to synchronise with Redland 1.0.0

C# bindings changes

Correct marshalling .NET strings to and from UTF-8 inside Redland correctly. (Edd Dumbill)

Improve and correct the destruction of internal iterator objects (Edd Dumbill)

Use HandleRef to improve the references to redland World to prevent premature destruction of redland objects. (Edd Dumbill)

See the csharp/ChangeLog in the source tree for more details of these changes.

Objective-C / Cocoa bindings changes

This binding is for the Objective-C (Obj-C) language with the Cocoa Framework on the Apple OSX platform. It was created and is developed by René Puls who provides it at the Cocoa Bindings for Redland site

Perl bindings changes

No changes.

PHP bindings changes

No changes.

Python bindings changes

Added convienience classes for making RDQL and SPARQL queries. Added methods for returning query results as RDF graphs and boolean results. Added unittests for those.

Ruby bindings changes

Updated to rdf-redland 0.5.3.1 and made the installation work standalone from ruby gem. Fixed some test cases so the testsuite passes now.

Tcl bindings changes

No changes.

Redland Bindings 0.9.19.1 Changes

Redland binding's License was changed from LGPL 2.1/MPL 1.1 to LGPL 2.1/Apache 2 (except for the C# binding).

Rebuild for Redland 0.9.19

General Changes

Fixes to lose Makefile use of $< syntax for better make(1) portability.

configure was updated to try harder to find Java JNI headers, looking in $JAVA_HOME, or using --with-jdk argument.

C# binding changes

Assign the logging delegate to a private member to stop it being prematurely garbage collected. (Edd Dumbill)

Perl binding changes

Rewrote $uri=$uri->{URI} style code to prevent premature object destruction.

Class Model: Added to_string() method.

Classes Query, QueryResults: Made documentation and examples to match the code.

PHP binding changes

Added a typemap to provide a proper PHP ZVAL_NULL value when returning a NULL librdf_stream* or librdf_iterator* object pointer, rather than a swig-typed NULL pointer.

Python binding changes

Rewrote uri=uri._reduri style code to prevent premature object destruction.

Class Model: Added method to_string.

Class Node: Documented literal language and other literal_language method dictionary keys.

Redland Bindings 0.9.18-1 Changes

Rebuild for Redland 0.9.18 - no API changes

Redland Bindings 0.9.17-1 Changes

This is the first release of Redland Bindings separate from Redland and includes the following changes compared to the language bindings in Redland 0.9.16

General Changes

The main change is to split the API that Redland exports in the redland package from the language specific parts in the redland-bindings package.

For most of the language bindings, the interface between them is using the swig interface generator tool. This is now defined by the Redland.i file provided by the redland package (in binary packages inside redland-devel rpm or librdf-dev debs). This can also be found via redland-config --swig and then used to generate the C wrappers for the bindings. There may be need for language-specific changes which can be used via #included .i files triggered by calling swig and the C compiler with defines like -DREDLAND_PRE_I to #include redland-pre.i from the Redland.i.

The last paragraph does not apply to C# (Redland#) which uses the built in P/Invoke feature of the language and runtime to call the Redland functions directly.

Packaging changes

C# API (Redland#) Changes

This is an entirely new API for 0.9.17 originally created by Cesar Lopez Nataren. It was updated by Dave Beckett to work with the released Mono 1.0 and substantially improved by Edd Dumbill. Changes since Cesar's version are given in detail in the csharp directory ChangeLog but include:

Java API Changes

This API has not been updated for all Redland 0.9.17 changes.

Class Statement. Added equals method.

Perl API changes

This API has been updated for all Redland 0.9.17 changes.

PHP API Changes

No changes needed as this is a bare API directly using Redland functions.

Added some PHP 4.3 compatible defines to the test program.

Python API changes

This API has been updated for all Redland 0.9.17 changes. The main changes are as follows:

Ruby API changes

Replaced with a fuller API rdf-redland written by by Dominic Sisneros. See the rdf-redland project site.

This API has not been updated for all Redland 0.9.17 changes but may have newer version at the URI above.

Class statement. Added == operator.

Tcl API changes

No changes needed as this is a bare API directly using Redland functions.


Copyright (C) 2004-2008 Dave Beckett
Copyright (C) 2004-2005 University of Bristol