=for HTML <a href="https://travis-ci.org/mnunberg/perl-Couchbase-Client"><img src="https://travis-ci.org/mnunberg/perl-Couchbase-Client.svg?branch=sdk20"></a> =head1 NAME Couchbase::README - README for Couchbase::Client =head1 Introduction Couchbase is a Perl client for Couchbase (http://www.couchbase.org). This I<replaces> the older L<Couchbase::Client> Installing this module depends on the C<libcouchbase> library (L<http://couchbase.com/communities/c>, L<http://packages.couchbase.com/clients/c/index.html>). You must have at least version I<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 C<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 L<Couchbase::Bucket> class, so have a look there! =head2 SUPPORT Support for this module is provided by the author. You can find him on the C<#libcouchbase> IRC channel on the freenode network under the name C<mnunberg> (number of trailing underscores may vary depending on his network). You can also try to file a bug in the github repository (L<https://github.com/mnunberg/perl-Couchbase-Client>). =head2 CONTRIBUTING This module is primarily authored in XS. The C<xs> directory contains the relevant C source code. To run the tests you will need a copy of C<CouchbaseMock.jar> in the C<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: L<https://github.com/couchbase/libcouchbase/blob/2.4.2/Makefile.am#L241>