implement Value type for arbitrary JSON values

.circleci/config.yml

@@ -0,0 +1,95 @@
+version: 2.1
+
+orbs:
+  win: circleci/windows@1.0.0
+
+workflows:
+  workflow:
+    jobs:
+      - go-test:
+          name: Go 1.13
+          docker-image: circleci/golang:1.13
+      - go-test:
+          name: Go 1.12
+          docker-image: circleci/golang:1.12
+      - go-test:
+          name: Go 1.11
+          docker-image: circleci/golang:1.11
+      - go-test:
+          name: Go 1.10
+          docker-image: circleci/golang:1.10
+      - go-test:
+          name: Go 1.9
+          docker-image: circleci/golang:1.9
+      - go-test:
+          name: Go 1.8
+          docker-image: circleci/golang:1.8
+      - go-test-windows:
+          name: Windows
+
+jobs:
+  go-test:
+    parameters:
+      run-lint:
+        type: boolean
+        default: true
+      docker-image:
+        type: string
+
+    docker:
+      - image: <<parameters.docker-image>>
+        environment:
+          CIRCLE_TEST_REPORTS: /tmp/circle-reports
+          CIRCLE_ARTIFACTS: /tmp/circle-artifacts
+          COMMON_GO_PACKAGES: >
+            github.com/golang/dep/cmd/dep
+            github.com/jstemmer/go-junit-report
+
+    working_directory: /go/src/gopkg.in/launchdarkly/go-server-sdk-core.v1
+
+    steps:
+      - checkout
+      - run: go get -u $COMMON_GO_PACKAGES
+      - when:
+          condition: <<parameters.run-lint>>
+          steps:
+            - run: make lint
+      - run: go build ./...
+
+      - run:
+          name: Run tests
+          command: |
+            mkdir -p $CIRCLE_TEST_REPORTS
+            mkdir -p $CIRCLE_ARTIFACTS
+            trap "go-junit-report < $CIRCLE_ARTIFACTS/report.txt > $CIRCLE_TEST_REPORTS/junit.xml" EXIT
+            make test | tee $CIRCLE_ARTIFACTS/report.txt
+
+      - store_test_results:
+          path: /tmp/circle-reports
+
+      - store_artifacts:
+          path: /tmp/circle-artifacts
+
+  go-test-windows:
+    executor:
+      name: win/vs2019
+      shell: powershell.exe
+
+    environment:
+      GOPATH: C:\Users\VssAdministrator\go
+      PACKAGE_PATH: gopkg.in\launchdarkly\go-server-sdk-core.v1
+
+    steps:
+      - checkout
+      - run: go version
+      - run:
+          name: move source
+          command: |
+            go env GOPATH
+            mkdir ${env:GOPATH}\src\${env:PACKAGE_PATH}
+            mv * ${env:GOPATH}\src\${env:PACKAGE_PATH}\
+      - run:
+          name: build and test
+          command: |
+            cd ${env:GOPATH}\src\${env:PACKAGE_PATH}
+            go test -race ./...

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is this a support request?**
+This issue tracker is maintained by LaunchDarkly SDK developers and is intended for feedback on the SDK code. If you're not sure whether the problem you are having is specifically related to the SDK, or to the LaunchDarkly service overall, it may be more appropriate to contact the LaunchDarkly support team; they can help to investigate the problem and will consult the SDK team if necessary. You can submit a support request by going [here](https://support.launchdarkly.com/) and clicking "submit a request", or by emailing support@launchdarkly.com.
+
+Note that issues filed on this issue tracker are publicly accessible. Do not provide any private account information on your issues. If your problem is specific to your account, you should submit a support request as described above.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To reproduce**
+Steps to reproduce the behavior.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Logs**
+If applicable, add any log output related to your problem.
+
+**SDK version**
+The version of this SDK that you are using.
+
+**Language version, developer tools**
+For instance, Go 1.11 or Ruby 2.5.3. If you are using a language that requires a separate compiler, such as C, please include the name and version of the compiler too.
+
+**OS/platform**
+For instance, Ubuntu 16.04, Windows 10, or Android 4.0.3. If your code is running in a browser, please also include the browser type and version.
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I would love to see the SDK [...does something new...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context about the feature request here.

.github/pull_request_template.md

@@ -0,0 +1,21 @@
+**Requirements**
+
+- [ ] I have added test coverage for new or changed functionality
+- [ ] I have followed the repository's [pull request submission guidelines](../blob/master/CONTRIBUTING.md#submitting-pull-requests)
+- [ ] I have validated my changes against all supported platform versions
+
+**Related issues**
+
+Provide links to any issues in this repository or elsewhere relating to this pull request.
+
+**Describe the solution you've provided**
+
+Provide a clear and concise description of what you expect to happen.
+
+**Describe alternatives you've considered**
+
+Provide a clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+
+Add any other context about the pull request here.

.golangci.yml

@@ -0,0 +1,18 @@
+run:
+  deadline: 120s
+  tests: false
+
+linters:
+  enable-all: true
+  disable:
+    - goconst
+  fast: false
+
+linter-settings:
+  gofmt:
+    simplify: false
+
+issues:
+  exclude-use-default: false
+  max-same-issues: 1000
+  max-per-linter: 1000

.ldrelease/config.yml

@@ -0,0 +1,10 @@
+repo:
+  public: go-server-sdk-core
+  private: go-server-sdk-core-private
+
+releasableBranches:
+  - name: v1
+
+publications:
+  - url: https://godoc.org/github.com/launchdarkly/go-server-sdk-core
+    description: documentation

CHANGELOG.md

@@ -0,0 +1,3 @@
+# Change log
+
+All notable changes to the project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org).

CONTRIBUTING.md

@@ -0,0 +1,43 @@
+# Contributing to this project
+
+LaunchDarkly has published an [SDK contributor's guide](https://docs.launchdarkly.com/docs/sdk-contributors-guide) that provides a detailed explanation of how our SDKs work. See below for additional information on how to contribute to this project.
+
+## Submitting bug reports and feature requests
+
+The LaunchDarkly SDK team monitors the [issue tracker](https://github.com/launchdarkly/go-server-sdk-core/issues) in tis repository. Bug reports and feature requests specific to this project should be filed in this issue tracker. The SDK team will respond to all newly filed issues within two business days. For issues or requests that are more generally related to the LaunchDarkly Go SDK, rather than specifically for the code in this repository, please use the [`go-server-sdk`](https://github.com/launchdarkly/go-server-sdk) repository.
+
+## Submitting pull requests
+
+We encourage pull requests and other contributions from the community. Before submitting pull requests, ensure that all temporary or unintended code is removed. Don't worry about adding reviewers to the pull request; the LaunchDarkly SDK team will add themselves. The SDK team will acknowledge all pull requests within two business days.
+
+## Build instructions
+
+### Prerequisites
+
+This project should be built against Go 1.8 or newer.
+
+Note that the public import path is `gopkg.in/launchdarkly/go-server-sdk-core.v1` (using the [`gopkg.in`](https://labix.org/gopkg.in) service as a simple way to pin to a major version). Since it does not use Go modules, and it references its own import path in imports between packages, this means that in order to build it you must check it out at `$GOPATH/src/gopkg.in/launchdarkly/go-server-sdk-core.v1`-- not `$GOPATH/src/github.com/launchdarkly/go-server-sdk-core`.
+
+### Building
+
+To build the project without running any tests:
+```
+make
+```
+
+If you wish to clean your working directory between builds, you can clean it by running:
+```
+make clean
+```
+
+To run the linter:
+```
+make lint
+```
+
+### Testing
+
+To build and run all unit tests:
+```
+make test
+```

Makefile

@@ -0,0 +1,22 @@
+
+GOLANGCI_LINT_VERSION=v1.10.2
+
+LINTER=./bin/golangci-lint
+
+.PHONY: build clean test lint
+
+build:
+	go build ./...
+
+clean:
+	go clean
+
+test:
+	@# Note, we need to specify all these packages individually for go test in order to remain 1.8-compatible
+	go test -race -v ./ldvalue
+
+$(LINTER):
+	curl -sfL https://install.goreleaser.com/github.com/golangci/golangci-lint.sh | bash -s $(GOLANGCI_LINT_VERSION)
+
+lint: $(LINTER)
+	$(LINTER) run ./...

README.md

@@ -0,0 +1,39 @@
+# LaunchDarkly Go SDK Core Packages
+===================================
+
+[![Circle CI](https://circleci.com/gh/launchdarkly/go-server-sdk-core.svg?style=svg)](https://circleci.com/gh/launchdarkly/go-server-sdk-core)
+
+## Overview
+
+This repository contains packages that are shared between the [LaunchDarkly Go SDK](https://github.com/launchdarkly/go-server-sdk) and other LaunchDarkly Go components.
+
+Applications using the LaunchDarkly Go SDK will usually not need to reference these packages directly. If you do (for instance, if you are using the SDK's JSONVariation method, which returns the type `Value` from the `ldvalue` package), you should import the same major version of the package that is imported by the SDK. See the SDK documentation for more details.
+
+Note that the base import path is `gopkg.in/launchdarkly/go-server-sdk-core.v1` (to ensure that you receive the latest release of major version 1.x), not `github.com/launchdarkly/go-server-sdk`.
+
+## Supported Go versions
+
+This version of the project has been tested with Go 1.8 through 1.13.
+
+## Learn more
+
+Check out our [documentation](http://docs.launchdarkly.com) for in-depth instructions on configuring and using LaunchDarkly. You can also head straight to the [complete reference guide for the Go SDK](http://docs.launchdarkly.com/docs/go-sdk-reference), or the [generated API documentation](https://godoc.org/gopkg.in/launchdarkly/go-server-sdk-core.v1) for this project.
+
+## Contributing
+
+We encourage pull requests and other contributions from the community. Check out our [contributing guidelines](CONTRIBUTING.md) for instructions on how to contribute to this SDK.
+
+## About LaunchDarkly
+
+* LaunchDarkly is a continuous delivery platform that provides feature flags as a service and allows developers to iterate quickly and safely. We allow you to easily flag your features and manage them from the LaunchDarkly dashboard.  With LaunchDarkly, you can:
+    * Roll out a new feature to a subset of your users (like a group of users who opt-in to a beta tester group), gathering feedback and bug reports from real-world use cases.
+    * Gradually roll out a feature to an increasing percentage of users, and track the effect that the feature has on key metrics (for instance, how likely is a user to complete a purchase if they have feature A versus feature B?).
+    * Turn off a feature that you realize is causing performance problems in production, without needing to re-deploy, or even restart the application with a changed configuration file.
+    * Grant access to certain features based on user attributes, like payment plan (eg: users on the ‘gold’ plan get access to more features than users in the ‘silver’ plan). Disable parts of your application to facilitate maintenance, without taking everything offline.
+* LaunchDarkly provides feature flag SDKs for a wide variety of languages and technologies. Check out [our documentation](https://docs.launchdarkly.com/docs) for a complete list.
+* Explore LaunchDarkly
+    * [launchdarkly.com](https://www.launchdarkly.com/ "LaunchDarkly Main Website") for more information
+    * [docs.launchdarkly.com](https://docs.launchdarkly.com/  "LaunchDarkly Documentation") for our documentation and SDK reference guides
+    * [apidocs.launchdarkly.com](https://apidocs.launchdarkly.com/  "LaunchDarkly API Documentation") for our API documentation
+    * [blog.launchdarkly.com](https://blog.launchdarkly.com/  "LaunchDarkly Blog Documentation") for the latest product updates
+    * [Feature Flagging Guide](https://github.com/launchdarkly/featureflags/  "Feature Flagging Guide") for best practices and strategies