prepare 1.0.0-beta.3 release

.circleci/config.yml

@@ -4,17 +4,94 @@ workflows:
   version: 2
   all:
     jobs:
-      - build-doc-linux
+      - build-test-linux-luajit
+      - build-test-linux-lua53
+      - build-test-linux-lua52
 
 jobs:
-  build-doc-linux:
+  build-test-linux-luajit:
     docker:
       - image: ubuntu:18.04
+      - image: redis
     steps:
       - checkout
       - run:
           name: Prepare
-          command: ./.ldrelease/linux-prepare.sh
+          command: |
+            apt-get update -y
+            apt-get install -y luajit libluajit-5.1-dev lua-ldoc zip \
+              ca-certificates curl zip lua-cjson libpcre3 libcurl4-openssl-dev \
+              cmake libhiredis-dev git build-essential libpcre3-dev luarocks
+
+      - run:
+          name: Build c-server-sdk
+          command: ./.ldrelease/build-c-server.sh
+
+      - run:
+          name: Build lua-server-sdk
+          command: |
+            luarocks make launchdarkly-server-sdk-1.0-0.rockspec
+            luarocks make launchdarkly-server-sdk-redis-1.0-0.rockspec
+
+      - run:
+          name: Run tests
+          command: |
+            luajit test.lua
+
+  build-test-linux-lua53:
+    docker:
+      - image: ubuntu:18.04
+      - image: redis
+    steps:
+      - checkout
+      - run:
+          name: Prepare
+          command: |
+            apt-get update -y
+            apt-get install -y lua5.3 liblua5.3-dev lua-ldoc zip \
+              ca-certificates curl zip lua-cjson libpcre3 libcurl4-openssl-dev \
+              cmake libhiredis-dev git build-essential libpcre3-dev luarocks
+
+      - run:
+          name: Build c-server-sdk
+          command: ./.ldrelease/build-c-server.sh
+
+      - run:
+          name: Build lua-server-sdk
+          command: |
+            luarocks make launchdarkly-server-sdk-1.0-0.rockspec
+            luarocks make launchdarkly-server-sdk-redis-1.0-0.rockspec
+
+      - run:
+          name: Run tests
+          command: |
+            lua5.3 test.lua
+
+  build-test-linux-lua52:
+    docker:
+      - image: ubuntu:18.04
+      - image: redis
+    steps:
+      - checkout
+      - run:
+          name: Prepare
+          command: |
+            apt-get update -y
+            apt-get install -y lua5.2 liblua5.2-dev lua-ldoc zip \
+              ca-certificates curl zip lua-cjson libpcre3 libcurl4-openssl-dev \
+              cmake libhiredis-dev git build-essential libpcre3-dev luarocks
+
+      - run:
+          name: Build c-server-sdk
+          command: ./.ldrelease/build-c-server.sh
+
+      - run:
+          name: Build lua-server-sdk
+          command: |
+            luarocks make launchdarkly-server-sdk-1.0-0.rockspec
+            luarocks make launchdarkly-server-sdk-redis-1.0-0.rockspec
+
       - run:
-          name: Build Doc
-          command: ./.ldrelease/linux-build-docs.sh
+          name: Run tests
+          command: |
+            lua5.2 test.lua

.ldrelease/build-c-server.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+set -e
+
+git clone https://github.com/launchdarkly/c-server-sdk.git
+cd c-server-sdk
+mkdir build
+cd build
+cmake -D BUILD_SHARED_LIBS=ON -D BUILD_TESTING=OFF -D REDIS_STORE=ON ..
+make
+make install

.ldrelease/linux-build-docs.sh

@@ -6,7 +6,11 @@ set -e
 
 PROJECT_DIR=$(pwd)
 
-ldoc launchdarkly-server-sdk.lua
+mkdir tmp
+cp launchdarkly-server-sdk.c tmp/
+cp launchdarkly-server-sdk-redis.c tmp/
+
+ldoc tmp
 
 mkdir -p $PROJECT_DIR/artifacts
 cd $PROJECT_DIR/doc

.ldrelease/linux-prepare.sh

@@ -2,4 +2,6 @@
 
 set -e
 
-apt-get update -y && apt-get install -y lua-ldoc zip ca-certificates
+apt-get update -y && apt-get install -y luajit lua-ldoc zip ca-certificates \
+    curl zip lua-cjson libpcre3 libcurl4-openssl-dev cmake libhiredis-dev git \
+    build-essential libpcre3-dev

.ldrelease/update-version.sh

@@ -2,4 +2,4 @@
 
 set -e
 
-sed -i "s/local SDKVersion =.*/local SDKVersion = \"${LD_RELEASE_VERSION}\"/" 'launchdarkly-server-sdk.lua'
+sed -i "s/#define SDKVersion .*/#define SDKVersion \"${LD_RELEASE_VERSION}\"/" 'launchdarkly-server-sdk.c'

README.md

@@ -13,7 +13,12 @@ LaunchDarkly overview
 Supported Lua versions
 -----------
 
-This version of the LaunchDarkly SDK is compatible with the Lua 5.1 interpreter, and LuaJIT. Lua 5.3 is not supported due to FFI constraints.
+This version of the LaunchDarkly SDK is compatible with the Lua 5.1-5.3 interpreter, and LuaJIT.
+
+Supported C server-side SDK versions
+-----------
+
+This version of the Lua server-side SDK depends on the C server-side SDK. The minimum required version is `2.1.0`, and under `3.0.0`.
 
 Getting started
 -----------

attribution/luaunit.txt

@@ -0,0 +1,12 @@
+This software is distributed under the BSD License.
+
+Copyright (c) 2005-2018, Philippe Fremy <phil at freehackers dot org>
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

launchdarkly-server-sdk-1.0-0.rockspec

@@ -0,0 +1,29 @@
+package = "launchdarkly-server-sdk"
+
+version = "1.0-0"
+
+source = {
+   url = "." -- not online yet!
+}
+
+dependencies = {
+   "lua >= 5.1, <= 5.4",
+}
+
+external_dependencies = {
+    LD = {
+        header = "launchdarkly/api.h"
+    }
+}
+
+build = {
+   type = "builtin",
+   modules = {
+      ["launchdarkly_server_sdk"] = {
+          sources = { "launchdarkly-server-sdk.c" },
+          incdirs = {"$(LD_INCDIR)"},
+          libdirs = {"$(LD_LIBDIR)"},
+          libraries = {"ldserverapi"}
+      }
+   }
+}

launchdarkly-server-sdk-redis-1.0-0.rockspec

@@ -0,0 +1,29 @@
+package = "launchdarkly-server-sdk-redis"
+
+version = "1.0-0"
+
+source = {
+   url = "." -- not online yet!
+}
+
+dependencies = {
+   "lua >= 5.1, <= 5.4",
+}
+
+external_dependencies = {
+    LDREDIS = {
+        header = "launchdarkly/store/redis.h"
+    }
+}
+
+build = {
+   type = "builtin",
+   modules = {
+      ["launchdarkly_server_sdk_redis"] = {
+          sources = { "launchdarkly-server-sdk-redis.c" },
+          incdirs = {"$(LDREDIS_INCDIR)"},
+          libdirs = {"$(LDREDIS_LIBDIR)"},
+          libraries = {"ldserverapi-redis"}
+      }
+   }
+}

launchdarkly-server-sdk-redis.c

@@ -0,0 +1,110 @@
+/***
+Server-side SDK for LaunchDarkly Redis store.
+@module launchdarkly-server-sdk-redis
+*/
+
+#include <lua.h>
+#include <lauxlib.h>
+#include <stdlib.h>
+#include <stdbool.h>
+#include <string.h>
+
+#include <launchdarkly/api.h>
+#include <launchdarkly/store/redis.h>
+
+/***
+Initialize a store backend
+@function makeStore
+@tparam table fields list of configuration options
+@tparam[opt] string fields.host Hostname for Redis.
+@tparam[opt] int fields.port Port for Redis.
+@tparam[opt] string fields.prefix Redis key prefix for SDK values.
+@tparam[opt] int fields.poolSize Number of Redis connections to maintain.
+@return A fresh Redis store backend.
+*/
+static int
+LuaLDRedisMakeStore(lua_State *const l)
+{
+    struct LDRedisConfig *config;
+    struct LDStoreInterface *storeInterface;
+
+    if (lua_gettop(l) != 1) {
+        return luaL_error(l, "expecting exactly 1 argument");
+    }
+
+    luaL_checktype(l, 1, LUA_TTABLE);
+
+    config = LDRedisConfigNew();
+
+    lua_getfield(l, 1, "host");
+
+    if (lua_isstring(l, -1)) {
+        LDRedisConfigSetHost(config, luaL_checkstring(l, -1));
+    }
+
+    lua_getfield(l, 1, "prefix");
+
+    if (lua_isstring(l, -1)) {
+        LDRedisConfigSetPrefix(config, luaL_checkstring(l, -1));
+    }
+
+    lua_getfield(l, 1, "port");
+
+    if (lua_isnumber(l, -1)) {
+        LDRedisConfigSetPort(config, luaL_checkinteger(l, -1));
+    }
+
+    lua_getfield(l, 1, "poolSize");
+
+    if (lua_isnumber(l, -1)) {
+        LDRedisConfigSetPoolSize(config, luaL_checkinteger(l, -1));
+    }
+
+    storeInterface = LDStoreInterfaceRedisNew(config);
+
+    struct LDStoreInterface **i =
+        (struct LDStoreInterface **)lua_newuserdata(l, sizeof(storeInterface));
+
+    *i = storeInterface;
+
+    luaL_getmetatable(l, "LaunchDarklyStoreInterface");
+    lua_setmetatable(l, -2);
+
+    return 1;
+}
+
+static const struct luaL_Reg launchdarkly_functions[] = {
+    { "makeStore", LuaLDRedisMakeStore },
+    { NULL,        NULL                }
+};
+
+#if !defined LUA_VERSION_NUM || LUA_VERSION_NUM==501
+/*
+** Adapted from Lua 5.2.0
+*/
+static void luaL_setfuncs (lua_State *L, const luaL_Reg *l, int nup) {
+  luaL_checkstack(L, nup+1, "too many upvalues");
+  for (; l->name != NULL; l++) {  /* fill the table with given functions */
+    int i;
+    lua_pushstring(L, l->name);
+    for (i = 0; i < nup; i++)  /* copy upvalues to the top */
+      lua_pushvalue(L, -(nup+1));
+    lua_pushcclosure(L, l->func, nup);  /* closure with those upvalues */
+    lua_settable(L, -(nup + 3));
+  }
+  lua_pop(L, nup);  /* remove upvalues */
+}
+#endif
+
+int
+luaopen_launchdarkly_server_sdk_redis(lua_State *const l)
+{
+    #if LUA_VERSION_NUM == 503 || LUA_VERSION_NUM == 502
+        luaL_newlib(l, launchdarkly_functions);
+    #else
+        luaL_register(l, "launchdarkly-server-sdk-redis",
+            launchdarkly_functions);
+    #endif
+
+    return 1;
+}