Libartefact is a client library that can be used to connect to the Artefact data server, for data retrieval and insertion.
The library takes care of http communication, encryption/decryption (optionally), XML translations and error handling. It is intended as a complete interface to the communication possibilities with the Artefact server.

To use libartefact, simply include libartefact.h in your c file. The project supplies a pkg-config file called libartefact.pc, that should be located in the ${prefix}/lib/pkg-config/, where ${prefix} is the base directory in which the library is installed. This will be /usr on most systems. In order to use it simply add

PKG_CHECK_MODULES(ATF, libartefact >= 0.0.1)

to configure.in, and supply ATF_CFLAGS to the cflags and ATF_LIBS to the libs of your project Makefile.am. Alternatively use the pkg-config –libs libartefact and pkg-config –cflags libartefact commands directly in your Makefile (if not using autotools).

atf_handle_t *handle = atf_init();
void atf_close(handle);

// ... here should be some code that allocates handle and does something useful ...
 
atf_error_t err = atf_get_last_error(handle);
 
if(err != ATF_NO_ERROR) {
  char buf[512];
  printf("Error: %s\n", atf_get_error_string(err, buf, sizeof(buf));
}