Skip to content

The next generation of Libdrizzle with a simplified API and support for more features of the protocol

License

Notifications You must be signed in to change notification settings

sociomantic-tsunami/libdrizzle-redux

Repository files navigation

Description BuildStatus

Drizzle Redux is a project which aims to breathe new life into the libdrizzle C connector. It is designed to allow you to connect to and query a MySQL database server using a simple API.

Libdrizzle-redux in the sociomantic tsunami repository is a fork of the official v5.1.4 Felmingham at https://launchpad.net/libdrizzle.

The primary reason for the fork is that development of the upstream stopped in 2013 which meant that crucial fixes and enhancements were not included in the latest stable release v5.1.4 Felmingham.

We hope that continuing the development of libdrizzle-redux can benefit current and future users of the library.

For more details on new features please refer to the release notes

Support Guarantees

  • Major branch development period: 6 months
  • Maintained minor versions: 2 most recent

Maintained Major Branches

Major Initial release date Supported until
v5.x.x v5.2.0: 2016-03-31 TBA - 6 months after next major release

Releases

Latest stable release notes | All

The release process libdrizzle-redux is based on SemVer versioning as described here. This means that the major version is increased for breaking changes, the minor version is increased for feature releases, and the patch version is increased for bug fixes that don't cause breaking changes.

Releases are handled using GitHub releases. The notes associated with a major or minor GitHub release are designed to help developers to migrate from one version to another. The changes listed are the steps you need to take to move from the previous version to the one listed.

Building libdrizzle-redux

Attention!

Building the library using MinGW is unfortunately broken at the moment. We apologize for any inconveniences and promise to look into the issue as soon as possible.

Supported compilers

Compiler Version
gcc >=4.8.x
llvm clang >=3.3
apple clang >=5.0 (clang-500.2.75)

Other Dependencies

Dependency Version
autoconf >=2.61
zlib1g-dev >=0.13.x
libtool >=2.x
libssl-dev [1] >=v1.x
[1]openssl is needed if libdrizzle-redux is compiled with support for SSL connections.

To build libdrizzle-redux you can invoke bootstrap script:

bootstrap.sh

Alternatively you can build and customize:

autoreconf -fi
./configure
make
make install

For more information about compiling libdrizzle-redux please refer to compiling.rst or build the documentation, cf. below.

Linking libdrizzle-redux:

g++ app.c -oapp -ldrizzle-redux -lssl -lcrypto -pthread

If libdrizzle-redux is installed alongside other versions of libdrizzle, the linking should be done with the full name of the dynamic library, e.g.:

g++ app.c -oapp -l:libdrizzle-redux.so.9 -lssl -lcrypto -pthread

Building documentation

Documentation can be generated in several formats:

pdf  : make latexpdf
epub : make epub
html : make html