Add cassandra compatibility symlinks

Add symlinks to ease migration from the Apache CPP Driver:
- libcassandra.so -> libscylladb.so
- libcassandra_static.a -> libscylladb_static.a
- cassandra.pc pkg-config file (links against -lscylladb)

These are installed by default (CASS_INSTALL_CASSANDRA_COMPAT=ON)
and can be disabled if not needed.

Author: wprzytula

CMakeLists.txt

@@ -66,6 +66,7 @@ option(CASS_USE_STATIC_LIBS "Link static libraries when building executables" OF
 option(CASS_USE_STD_ATOMIC "Use std::atomic library" ON)
 option(CASS_USE_TIMERFD "Use timerfd (Linux only)" ON)
 option(CASS_USE_LIBUV "Use libuv" OFF)
+option(CASS_INSTALL_CASSANDRA_COMPAT "Install cassandra compatibility symlinks" ON)
 
 set(CASS_CPP_STANDARD "11" CACHE STRING "C++ standard (11, 14, 17, etc.)")
 

scylla-rust-wrapper/CMakeLists.txt

@@ -36,15 +36,21 @@ if(APPLE)
   set(INSTALL_NAME_SHARED_SYMLINK_VERSION "libscylladb.${PROJECT_VERSION_MAJOR}.dylib")
   set(INSTALL_NAME_SHARED_SYMLINK_NO_VERSION "libscylladb.dylib")
   set(CMAKE_Rust_FLAGS_SONAME "-Clink-arg=-Wl,-install_name,@rpath/libscylladb.${PROJECT_VERSION_MAJOR}.dylib -Clink-arg=-Wl,-current_version,${PROJECT_VERSION_STRING} -Clink-arg=-Wl,-compatibility_version,${PROJECT_VERSION_MAJOR}")
+  set(CASSANDRA_COMPAT_SHARED_SYMLINK "libcassandra.dylib")
+  set(CASSANDRA_COMPAT_STATIC_SYMLINK "libcassandra_static.a")
 elseif(WIN32)
   set(INSTALL_NAME_SHARED "scylladb.dll")
   set(INSTALL_NAME_SHARED_IMPLIB "scylladb.lib")
   set(CMAKE_Rust_FLAGS_SONAME "")
+  set(CASSANDRA_COMPAT_SHARED_SYMLINK "cassandra.dll")
+  set(CASSANDRA_COMPAT_STATIC_SYMLINK "cassandra_static.lib")
 else()
   set(INSTALL_NAME_SHARED "libscylladb.so.${PROJECT_VERSION_STRING}")
   set(INSTALL_NAME_SHARED_SYMLINK_VERSION "libscylladb.so.${PROJECT_VERSION_MAJOR}")
   set(INSTALL_NAME_SHARED_SYMLINK_NO_VERSION "libscylladb.so")
   set(CMAKE_Rust_FLAGS_SONAME "-Clink-arg=-Wl,-soname=libscylladb.so.${PROJECT_VERSION_MAJOR}")
+  set(CASSANDRA_COMPAT_SHARED_SYMLINK "libcassandra.so")
+  set(CASSANDRA_COMPAT_STATIC_SYMLINK "libcassandra_static.a")
 endif()
 if(WIN32)
   set(INSTALL_NAME_STATIC "scylladb_static.lib")
@@ -72,6 +78,9 @@ if(CASS_BUILD_SHARED)
   if(NOT WIN32)
     create_symlink(${INSTALL_NAME_SHARED} ${INSTALL_NAME_SHARED_SYMLINK_VERSION})
     create_symlink(${INSTALL_NAME_SHARED} ${INSTALL_NAME_SHARED_SYMLINK_NO_VERSION})
+    if(CASS_INSTALL_CASSANDRA_COMPAT)
+      create_symlink(${INSTALL_NAME_SHARED_SYMLINK_NO_VERSION} ${CASSANDRA_COMPAT_SHARED_SYMLINK})
+    endif()
   endif()
 endif()
 if(CASS_BUILD_STATIC)
@@ -80,6 +89,9 @@ if(CASS_BUILD_STATIC)
   add_library(scylladb_static STATIC IMPORTED GLOBAL)
   add_dependencies(scylladb_static ${INSTALL_NAME_STATIC}_copy)
   set_target_properties(scylladb_static PROPERTIES IMPORTED_LOCATION ${CMAKE_BINARY_DIR}/${INSTALL_NAME_STATIC})
+  if(CASS_INSTALL_CASSANDRA_COMPAT AND NOT WIN32)
+    create_symlink(${INSTALL_NAME_STATIC} ${CASSANDRA_COMPAT_STATIC_SYMLINK})
+  endif()
 endif()
 
 #-------------------------------------
@@ -196,6 +208,26 @@ if(CASS_BUILD_STATIC)
   endif()
 endif()
 
+# Cassandra compatibility symlinks (for migration from Apache CPP Driver)
+if(CASS_INSTALL_CASSANDRA_COMPAT AND NOT WIN32)
+  if(CASS_BUILD_SHARED)
+    install(FILES ${CMAKE_BINARY_DIR}/${CASSANDRA_COMPAT_SHARED_SYMLINK}
+      DESTINATION ${CMAKE_INSTALL_LIBDIR}
+      COMPONENT ${SCYLLA_DRIVER_DEV_COMPONENT_NAME})
+  endif()
+  if(CASS_BUILD_STATIC)
+    install(FILES ${CMAKE_BINARY_DIR}/${CASSANDRA_COMPAT_STATIC_SYMLINK}
+      DESTINATION ${CMAKE_INSTALL_LIBDIR}
+      COMPONENT ${SCYLLA_DRIVER_DEV_COMPONENT_NAME})
+  endif()
+  if(CASS_INSTALL_PKG_CONFIG AND PKG_CONFIG_FOUND)
+    configure_file("${CMAKE_CURRENT_SOURCE_DIR}/cassandra.pc.in" "cassandra.pc" @ONLY)
+    install(FILES "${CMAKE_CURRENT_BINARY_DIR}/cassandra.pc"
+      DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig"
+      COMPONENT ${SCYLLA_DRIVER_DEV_COMPONENT_NAME})
+  endif()
+endif()
+
 #-------------------
 # Uninstall target
 #-------------------

scylla-rust-wrapper/cassandra.pc.in

@@ -0,0 +1,11 @@
+prefix=@prefix@
+exec_prefix=@exec_prefix@
+libdir=@libdir@
+includedir=@includedir@
+
+Name: cassandra
+Description: ScyllaDB CPP RS Driver (cassandra compatibility)
+Version: @version@
+Libs: -L${libdir} -lscylladb
+Cflags: -I${includedir}
+URL: https://github.com/scylladb/cpp-rs-driver/