NAME

Couchbase::README - README for Couchbase::Client

Introduction

Couchbase is a Perl client for Couchbase (http://www.couchbase.org). This replaces the older Couchbase::Client

Installing this module depends on the libcouchbase library (http://couchbase.com/communities/c, http://packages.couchbase.com/clients/c/index.html). You must have at least version 2.4.2 installed. The library should exist in your current compiler's search path (this is usually the case if you've used the default installation methods). Inspect the author_utils/do_make.pl script in the source repository for ways to link against a custom install prefix.

Using this library will mainly deal with the Couchbase::Bucket class, so have a look there!

SUPPORT

Support for this module is provided by the author. You can find him on the #libcouchbase IRC channel on the freenode network under the name mnunberg (number of trailing underscores may vary depending on his network).

You can also try to file a bug in the github repository (https://github.com/mnunberg/perl-Couchbase-Client).

CONTRIBUTING

This module is primarily authored in XS. The xs directory contains the relevant C source code.

To run the tests you will need a copy of CouchbaseMock.jar in the t/tmp directory. You may obtain this by glancing into the source code of libcouchbase itself and downloading from the URL. Here's an example from the 2.4.2 version: https://github.com/couchbase/libcouchbase/blob/2.4.2/Makefile.am#L241