Merge "RIC:1060: Change in PTL"

CI: Migrate Sonar Scan job to GHA

Change-Id: I1cc8ba71aa07abca719d7cfce3e3d90d2ea8a6f3
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>

RIC:1060: Change in PTL

Change-Id: I89d25a83240d8856e3b7b5949c147d6603582b66
Signed-off-by: Abdulwahid W <abdulwahid.w@nokia.com>

CI: Add silent prescan SonarCloud job

Change-Id: Ie2852b72c7029fd8705bf59523786c1f26d2c308
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>

releasing 0.10.4

Change-Id: I16ab85db67080a90006f2c52c6684df0ecef1ceb
Signed-off-by: czichy <thoralf.czichy@nokia.com>

Go version changed

Change-Id: I03dc4083edd0f01ec6a0f1f49b9f786f8fe5d29f
Signed-off-by: Rimjhim Verma <rimjhim.verma@nokia.com>

Update version 0.10.2 and 0.10.3 release notes

Change-Id: Icd790224ad4e71dac4535e5a221f14bde9cdc292
Signed-off-by: czichy <thoralf.czichy@nokia.com>

go version update

Signed-off-by: anbalan <abdulwahid.w@nokia.com>
Change-Id: Idc55b7f7733c6e68788482c08938ff097fab49c8

Replacing committers with new ones

Signed-off-by: czichy <thoralf.czichy@nokia.com>
Change-Id: I9dc740187776bf7ef710089676bf1859f4ef2515

Update version 0.10.1 and 0.10.2 release notes

Issue-Id: RIC-942

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Icbff7ad092eef961f6498d97f8652ba69dca050e

Handle net.SplitHostPort() error

Add handling of net.SplitHostPort() function error return value.

Issue-Id: RIC-942

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Ief30f269fe67451144652ba740bb72f3e962799f

Handle CloseDB() error in statistics query

Add handling of Redis connection close function CloseDB() return value
after sentinel statistics were queried.

Issue-Id: RIC-942

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I632b112a085c95bf0dbe80035308ffcc799bfa10

Missing log Output() error handling

Replace log package Output() function usage with Printf() function,
which do not return error status and hence suites better for SDL logger
module use case.

Issue-Id: RIC-942

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I0f0e0e654d87f8da3f074e52a0ae25fef8d76159

Handle Subscribe() and Unsubscribe() error

Add handling of Redis channel Subscribe() and Unsubscribe() function
calls error status. Error status is returned back to the caller of SDL
APIs SubscribeChannel() and UnsubscribeChannel().

Issue-Id: RIC-942

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I2442e3ef78cdddabc2b983f59b0b05f5932c45c0

Upgrade Golang version to fix CVE-2022-32189 vulnerability

A too-short encoded message can cause a panic in Float.GobDecode and Rat
GobDecode in math/big in Go before 1.17.13 and 1.18.5, potentially
allowing a denial of service. Upgrade Golang to the latest 1.18 version,
that is for the time being 1.18.5.
Issue-Id: RIC-934

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I9498217634fc9b78a5d1ef814e1a3c8dd251d758

Revert previous sdlgo example change

Revert example.go change done by the commit 6ffe956f91, because that
change was a mishap.

Issue-Id: RIC-893

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I0566eba4ca70f735a2bf5da755c44752618e98d3

Read list type of environment variables

DBAAS Helm Charts appconfig has been changed to have individual ports
and master names for each SDL cluster due to problems seen with DBAAS
upgrade and rollback caused by re-allocation of the same address/port
of Redis to some other SDL cluster. Implement support for new list type
environment variables reading in SDL:
 * DBAAS_SERVICE_PORT
 * DBAAS_SERVICE_SENTINEL_PORT
 * DBAAS_MASTER_NAME

Issue-Id: RIC-698

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I9a9d94e536e0e4e2a174ef0b6fb2beb4c73ef4f5

Fix multi-namespace SDL event subscribe

SDL event channel internal format was wrongly showed to application
when the same application instance was subscribing to receive SDL
events from multiple namespaces. In that case subscribes were all
registered to the first namespace in SDL and hence when an event in a
channel belonging to another namespace was triggered, namespace internal
format '{other-namespace},' was showed in front of channel name. With
this commit change namespace lookup from channel name to search from
left to right the first comma ',' character. String after comma is
a channel name what should be showed to an application and all before
the comma ',' character can be silently parsed away in SDL.

Issue-Id: RIC-885

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I90b94862670e1e529381112e385b65250e7cb275

Bump Redis client version to v8.11.4

Bump Redis client version to the latest v8.11.4 version. Fix calling of Redis
client APIs, because Redis client APIs have been changed in version 8 to have
Golang Context type of argument.
SDLGO version: 0.9.5

Issue-Id: RIC-698

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: If551864081c3fddb0ecba95eb46600984d4f5a66

Merge "SDL CLI command to generate sdlcli shell completion file for bash"

Move SDL usage code example

Move SDL usage code example from sdlgo repo's root to example
sub-directory and change it to be a runnable application. Earlier
example was belonging to the Golang test package what caused it to be
ran when 'go test ./...' -command was executed and execution of the
example was failing if DBAAS connection was missing. Execution failure
is also visible in the sdlgo coverage test of the sonarcloud.io.

Issue-Id: RIC-875

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I6d980e0730d4a6f768448134bc7efece050a6d89

SDL CLI command to generate sdlcli shell completion file for bash

Output shell completion code for the bash shell.

 Usage:
   sdlcli completion bash

Added a new SDL CLI 'completion' command to generate auto-complete
file for the bash shells.

Version: 0.9.4

Issue-Id: RIC-874
Change-Id: Id5a5d14cfe3c5eb2a7815439c5b2a9b94271a2bd
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>

Fix sdlcli get -command result stdout write

Sdlcli get -command writes wrongly results to stderr stream. Fix sdlcli
get -command to write results to stdout stream when command execution
has succeeded. In addition add similar stdout redirect also to sdlcli
statistics -command just to keep the code look the same, even thought
there wasn't any real issue with sdlcli statistics -command's results
visibility.

Version: 0.9.3

Issue-Id: RIC-873

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Icc7d42d9200bdcc74bf1da6ceab341dd6b69c16e

Fix SDLCLI healthcheck to ignore ghost Sentinels

Fix SDLCLI 'healthcheck' command to ignore Redis Sentinel entries what
have a zero port numbers, because these extra entries are not valid
entries but instead are caused by a bug (#9240) in Redis server. Until
there is a fix for the Redis server issue available, we ignore these
ghost Redis Sentinel entries from SDLCLI 'healthcheck' command's
validation.

Version: 0.9.2

Issue-Id: RIC-869

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I4ba075cf66af98a59da8c558e9602ba1427fb8d9

Refactor long readRedisInfoReplyFields() function

Split very long readRedisInfoReplyFields() function to multiple
functions to reduce complexity.

Version: 0.9.1

Issue-Id: RIC-113
Change-Id: I63858c9c5d8bd99db464209043f5d23ca0109e38
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>

Do not allow '*' character in namespace argument

Validate namespace argument in 'sdlcli get keys' -command.
The command gets an unexpected error when namespace argument
contains '*' asterisk character:

  sdlcli get keys '*' ...
  panic: runtime error: index out of range [1] with length 1

Issue-Id: RIC-113
Change-Id: Ie8b292c4c40801bf9fbfe65274f86485c7085865
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>

New 'statistics' SDL CLI command

Display SDL resource usage statistics.

 Usage:
  sdlcli statistics [flags]

Update also the release-notes.
Version: 0.9.0

Issue-Id: RIC-113
Change-Id: I653d5325a8ff4a989f3cb7d9ab35c0fe9987392e
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>

Fix sdlcli healthcheck DBAAS status in SEP install

Implement reading of the new environment variable 'DBAAS_NODE_COUNT'
what defines how many DBAAS nodes there has been configured to be in
one SDL cluster group. For the time being in HA deployment value is 3
and in standalone deployment 1. With help of this variable sdlcli
'healthcheck' -command is able to show NOK status in case any configured
DBAAS pod is not present.
Refactor also output writing of the sdlcli 'healthcheck' -command to
show health status in a table layout.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I1d677c6a78eda67e3bcfdf814654710b00dac270

Rename Master and Slave to Primary and Replica

Refactor SDL code not to use 'Master' and 'Slave' words in function
nor variable names due to their negative connotations.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I3ecdcab4d8d36a6b8311fa34316d8ddbf71ae5a4

SDL CLI 'remove' -command key search pattern

Implement a key search pattern support for the sdlcli 'remove' -command.
With this command keys can be removed from SDL DB, removed keys can be
defined for the command either as key name or key search pattern
arguments. Command removes all the SDL DB keys by default, if key or key
search pattern argument is not given for the command.
Command syntax is:
  sdlcli remove <namespace> [<key|pattern>... <keyN|patternN>] [flags]

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I2cbe20a45aa21a15ee8a8b79abb7667b0307a93f

SDL CLI 'get namespaces' -command key count

Change existing -g,--group flag to -w,--wide flag. When the flag has
been set, command shows DB namespaces per SDL cluster group address
and how many DB keys there are per namespace.
New command syntax is:
    sdlcli get namespaces [flags]
Where supported flags are: -w, --wide, -h and --help.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Iae0b044257a5e26e6cfaa48e2a5dca8441c23d5c

Show help when no sdlcli arguments

Implement showing of the help text also when sdlcli tool is called
without any arguments.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I6ebd9844fe09debeeb24946ba55ebfb2d7b807c3

Implement SDL CLI 'get namespaces' -command

Implement a new 'get namespaces' -command for 'sdlcli' -tool. With this
command user can list all the namespaces found in database. Command
syntax is:
  sdlcli get namespaces [flags]
Supported flags are -g, --group, -h and --help flags. With -g,--group
flag user can get a list of namespace per SDL cluster group address and
-h, --help flags shows the command help.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: If4d66497eeec94d479748c81cf0898c2fbc78364

SDL CLI 'get' reads keys data in the given namespace

Implement SDL CLI 'get' command that reads keys data in the given
namespace. The 'get' reads one or multiple keys data:

 sdlcli get <namespace> <key> [<key2> <key3>... <keyN>]

Issue-Id: RIC-113
Change-Id: Ibe2cad1a986fa48bee4dba20eb4e886f62b09bf0
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>

Implement SDL CLI 'remove' -command

Implement a new 'remove' -command for 'sdlcli' -tool. With this
command single or many keys under given namespace can be removed
from SDL DB. Command syntax is:
  sdlcli remove <namespace> <key> [<key2>... <keyN>] [flags]
For the time being only -h and --help flags are supported with the
'remove' -command.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I4b68689ae9ec388372298f0445f714a5bdb23f3b

Implement SDL CLI 'set' -command

Implement a new set -command to 'sdlcli' -tool. With this command one
string key-value pair can be set to SDL DB under given namespace.
Command syntax is:
  sdlcli set <namespace> <key> <value> [flags]
For the time being only -h and --help flags are supported with the
set -command.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Ie124b93ded03600ed8eb3b7a31b407af0f60a18e

Harmonize SDL CLI 'healthcheck' -command

Harmonize 'healthcheck' -command help and error log not to have
'SDL CLI error' prefix as there is no such a prefix in 'set' and 'get'
-commands either.
Add 'healthcheck' -command line arguments count check.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I5e039edd9cdd3d70a9a13a1f116d7f0309618ef5

Implement 'get' and 'get keys' -SDL CLI commands

sdlcli get -command is used to display one or many resources.

 Usage:
   sdlcli get [command]

sdlcli get keys -subcommand is used to list keys in the given
namespace matching key search pattern.

 Usage:
   sdlcli get keys <namespace> [pattern|default '*'] [flags]

Issue-Id: RIC-113
Change-Id: I86b81ff8d8d2cdc0e959e285b19f93696ebe377e
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>

Sentinel check to SDL CLI 'healthcheck' -command

In addition to the existing Redis master and slave healthiness
validation, add Redis sentinel healthiness validation to be done when
SDL CLI 'healthcheck' -command is ran. Validation is done by calling
Redis client's 'Sentinels' API call and parsing 'flags' field from its
output. In SDL CLI sentinel healthiness status is shown only if status
is not ok. This is done not to show too much information in CLI
interface for users.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I8960ec9813e06aa88217c29bac56707b38052ae7

Implement SDL CLI 'healthcheck' -command

Implement a new 'healthcheck' -command for SDL CLI to validate
healthiness of the SDL database. Under the hood 'healthcheck' -command
calls Redis client's 'Master' and 'Slaves' APIs and parses from the
responses master and slave Redis servers related fields to show the
overall healthiness of the SDL database backend.

Redis client's version was upgraded from v6.15.9 to v7 v7.4.1,
because old client didn't support 'Master' and 'Slaves' Redis
sentinel APIs. Also implement usage of Redis client's
'NewSentinelClient' client connection to read state information via
'Master' and 'Slaves' APIs. In case of standalone Redis server
deployment state information is read via Redis client's 'Info' API.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I7d964ac5c3d10cc90075977e2b11da7a9c11949d

Draft version of SDLCLI command line tool

Add SDLCLI source codes to build command line tool, which can be used
for troubleshooting SDL/DB. With this commit draft version of the tool
has been implemented, shows only help.

Issue-Id: RIC-113

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Ied47ce68bcbc065c21c53fd2a326b91c32506204

Merge "New ListKeys API in syncstorage"

New ListKeys API in syncstorage

The ListKeys API returns all keys in the given namespace matching
key search pattern.

Also update sdltester -tool to test ListKeys api:
  listkeys
    - List keys in the given namespace matching key search pattern.

Upgraded ci/Dockerfile golang image version tag to 1.16. This is
due to expired Root CA certificates in golang:1.12 image which
result an error when building docker image:
  fatal: unable to access 'https://gopkg.in/tomb.v1/': server
  certificate verification failed. CAfile: none CRLfile: none

Version: 0.8.0

Issue-Id: RIC-110
Signed-off-by: Petri Ovaska <petri.ovaska@nokia.com>
Change-Id: Ic02a3f127934a1e02e01a36c573d035db34dbd6f

Add Ovaska and Maki-aijala, remove Badorek and Tallskog

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Id416062bc78873f738b1b1bbf3c1e8e657610bb1

Add deprecation warnings for SdlInstance APIs

Add 'Deprecated:' warning texts to SdlInstance struct type and all
of its receiver API functions. SDL repository contains SyncStorage
struct type with its receiver API functions and it should be used
instead of SdlInstance. With this commit there is added deprecation
warnings and these warnings should be a heads up for SDL API users not
to use anymore  SdlInstance API. After some reasonable time has passed
SdlInstance will be removed completely from the SDL repository.

Issue-Id: RIC-805

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I69d2e9fcfc42111c2e660cc451026c6d713cff70

Implement sentinel based DB capacity scaling

For time being SDL has supported standalone DBAAS DB and DBAAS HA DB deployment
with Redis sentinel. With this commit extent SDL functionality to support Redis
sentinel based DB cluster where we have multiple DBAAS Redis sentinel groups
and these groups can be used to spread out SDL DB write and read operations to
different DB instances.
Implement cluster DBAAS DB service addresses reading from environment variable
'DBAAS_CLUSTER_ADDR_LIST'.
Implement crc32 hash value calculation from namespace string and selection of
a DB instance from DB cluster based on calculated hash.

Issue-ID: RIC-699

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I8999c3c03d2d80d32a57d8ec051632b975bf9dc2

Implement SDL multi-namespace API

Add 'SyncStorage' with its write and read APIs to support multi-namespace API
what has been implemented already in Python and C++ SDL APIs. In Multi-
namespace API, at SyncStorage' creation time, connection to database backend is
created but namespace is not defined. Namespace is given later as a parameter
to every SDL read and write API calls what makes it easy to write and read from
different namespaces in single SDL instance of type 'SyncStorage'.

This multi-namespace implementation is a prerequisite to have before sentinel
based DB capacity scaling feature RIC-699 can be implemented properly.

Issue-ID: RIC-699

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I018dde1f016630d6b6e44e66a2f276a04e38505a

Take DBAAS multi-channel publishing Redis modules into use

Following SDL APIs are defined so that multiple channel-event pairs can be
given as function argument but actual SDL implementation utilized such a DBAAS
(Redis) module what expect to get only one channel-event pair. Fix the
implementation of these SDL APIs to use the correct DBAAS module what support
multiple channel-event pairs:
* SetIfAndPublish()
* SetIfNotExistsAndPublish()
* RemoveIfAndPublish()

Please note that in runtime environment DBAAS service needs to run on DBAAS
image version 0.4.0 or newer. Older images do not have multiple channel-event
pairs support as a Redis module.

Fixed also potential type conversion issue in SDL APIs RemoveIf() and
RemoveIfAndPublish() what can lead to SDL application crash.

Issue-ID: RIC-759

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I74f483bb31e0c6aed10983a83d70a45272d71fa4

Fix Go routine race condition in DB notification map

Map cbMap was accessible by the main Go routine and also by a Go routine, which
handled incoming notifications from database (Redis). Problem was visible, when
unit tests were run with '-race' flag. Fix the issue by adding a mutex lock to
guard cbMap accesses. Go routine what handles incoming notification has a local
lockless copy of the cbMap to make sure that notification handling speed won't
be suffering from mutex locks. Local copy of cbMap is updated whenever the
cbMap has been updated.

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I066ff1d71340db2240a7ea6aeeb575f098488608

Take Redis client version 6.15.9 into use

Take newer Redis client version 6.15.9 into use from:
https://github.com/go-redis/redis

Reasoning was to get bug fixes, especially fix for this one:
https://github.com/go-redis/redis/issues/1149

Updated also go.sum file after running 'go mod tidy' command.

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: I694282e669a9ae70040e9d95ea0c19d8c94bceea

Rephrase release notes introduction

Remove release name from introduction section to make it
unaltered for release changes.

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: If5dcb2c18b8568b670bd1198c72e1753b350bb70

Add extra line about src files are part of RIC platform project

Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>
Change-Id: Id38667ce1a1f109db284802d50baf28f1780bc58

Merge "Add documentation files"

Add documentation files

Added mandatory documentation files for the RIC Amber release.

Change-Id: Ib61949c1dc6b7302de7adb907158caf1ca905dea
Signed-off-by: Timo Tietavainen <timo.tietavainen@nokia.com>

Automation adds INFO.yaml

Change-Id: I9134d022dce524eac8b49afb5bc740fd7957cdae
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>

Add support for CI jobs

Ad ci directory containing a Dockerfile where unit tests shall be
executed.

Change-Id: Ica50888d24b7cdd4326a632a408619ed17be08c0
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Make DB instance visible

Make underlying DB instance visible to clients. This change makes it
easier for the clients to e.g. share the same DB instance between
multiple SDL instances (multiple namespaces is used). The DB instance
can be created once and reuse it every time a new SDL instance is
created. The DB instance is created with Newdatabase() method.

Update the documentation so that it is mentioned that subscribing the
channels is not safe for concurrent usage.

Change-Id: I1b09500eda44b6b095a3bf564c38e794d02f9d95
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Support redis sentinel configuration

Based on environment variables set, sdl will select either to connect to
standalone redis or sentinel redis. The underlying redis-go
implementation takes care of how connection to master is handled and
what happens if there is a switcover in redis.

Change-Id: Ib413b61e6a7e26e8ad2bd7f83331554271a93c69
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Set MaxRetries count

When redis client is created, set the MaxRetries count to 2. This
defines the number of times the command is tried to execute. In cases
where redis server is dead but the client hasn't noticed that yet, an
EOF error is returned from the first try. With the second attempt, a
proper error is returned indicating that the connection was refused.

Change-Id: I28ffcf83666edda9b715dafe6055cef4c633f757
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Add resource locking

Implement methods that enable applications to create locks for
a resources. Resource locks are plain keys with a random value
with an expiration time. Only the holder of a lock can release it either
by removing the lock or by letting it expire (after it will be
automatically removed). By using a random value (that only lock holder
knows), it can be ensured that others can't remove it. Resource locks
are per namespace.

Implemented methods are:
LockResource: this method will check if the lock already exists and if
not, it will create it with an expiration time. It is possible for the
client to define with options how many times the lock will be tried and
the interval how often it is tried. If retry is used, this method will
block.
ReleaseResource: remove the lock. If removing is tried after the
expiration, an error will be returned.
RefreshResource: with this method, it is possible to set a new
expiration time for the lock. If the lock has already expired, an error
will be returned.
CheckResource: application can query the remaining expiration time with
this method, regardless it is the owner of the lock or not.

Change-Id: Ic6f5274c1740c7e36ddaba564024cffcc4c5de3d
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Support multiple event publishing

Support for publishing multiple events at once.
Originally it was possible to give multiple channels and
events as parameter to SetAndPublish() and RemoveAndPublish() API
functions. However, only the first event was published as
used Redis didn't support multiple event publishing. This
commit takes new Redis commands into use enabling the
support for multiple event publishing.

Add unit tests for internal sdlgoredis package. To be able
to stub external redisgo module, the Create() function is
splitted so that in unit tests it is possible to provide
a stub interface instead of the real one when building
the redisgo instance. Also Subscribe() function is wrapped,
and wrapper function is provided during setup as calling
the Subscribe() for the first time in code execution,
a new interface is provided that needs to be able to mock
in unit tests.

Improve documentation. Add doc.go which provides a better
documentation how to use SDL.

Change-Id: Id072d9397fa92ea37bcc78df7db54edadf4d9e7c
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Add support for SDL groups

SDL group is an unordered collection of members where each member is
unique.

Add the following methods to do operations with groups:
-AddMember: adds number of members into a given group. It is possible to
give already existing members to be added but that doesn't have an
effect to group.
-RemoveMember: Remove number of members from a group. It is possible to
try to remove non-existing members from a group without an error.
-RemoveGroup: Remove the whole group along with its members.
-GetMembers: Get all members from a group.
-IsMember: Check if a specific member is part of the group.
-GroupSize: Return the number of members in group.

Change-Id: I9005ffe584aa0872c5a3fab170d0ac37d9b9f30a
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Allow byte array/slice be given as value

An error was given if byte slice or array was given as a value, now they
are allowed. However, other types or slices are not allowed as value.

Change-Id: Ia0c4515498a1b0e03a002a7d4357adb6d262213a
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Add support for notifications

Add new API function to subscribe/unsubscribe  notifications
from a channel. With SubscribeChannel function it is possible to
subscribe one or many channels and attach a callback function taht will
be called when the notification (event) is received from a channel. It
is possible to have separate callback functions to different channels
but then subscription must be done separately. With UnsubscribeChannel
one can unsubscribe one or many subsribed channels.

Each function, that modifies database (sets or removes) will have
another API function that will cause an event to be sent to given
channel. E.g. the following two functions:

Set(pairs ...interface{})
SetAndPublish(channelsAndEvents []string, pairs ...interface{})

The first function just sets a value to key, whereas the second function
does the same thing and also sends an event to channel. The channels and
events are given as pairs in channelsAndEvents slice e.g.
[]string{"channel", "event"}
Although it is possible to give several channel event pairs, only
sending an event to one channel is supported at the moment due to
missing support in Redis DB.

Change-Id: I4fc96cd4c8a59410700f670ad5588fe71509fd03
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Fix Close API call

Calling Close function from API caused a recursive call to itself as the
underlying module was using a function with same name. Rename the
internal close function to avoid this.

Change-Id: I05c3ca8e79fb5f30cae81917f56efacbd1797768
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Initial commit

Change-Id: Iaf5456d3f1b8b59a727d7df46fe556fe00ac4c0e
Signed-off-by: Marco Tallskog <marco.tallskog@nokia.com>

Initial empty repository