Initial code import (#1)

* initial code import

* Remove note-go dependency

* Update README.md

Co-authored-by: Stefan VanBuren <[email protected]>

* add missing link to code of conduct

* update contributing info to readme

* Fix staticcheck errors

Co-authored-by: Stefan VanBuren <[email protected]>

Author: wtfleming

CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of conduct
+
+By participating in this project, you agree to abide by the
+[Blues Inc code of conduct][1].
+
+[1]: https://blues.github.io/opensource/code-of-conduct
+

CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing to blues/jsonata-go
+
+We love pull requests from everyone. By participating in this project, you
+agree to abide by the Blues Inc [code of conduct].
+
+[code of conduct]: https://blues.github.io/opensource/code-of-conduct
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code ( **no patch is too small** : fix typos, add comments,
+clean up inconsistent whitespace )
+* by refactoring code
+* by closing [issues][]
+* by reviewing patches
+
+[issues]: https://github.com/blues/jsonata-go/issues
+
+## Submitting an Issue
+
+* We use the [GitHub issue tracker][issues] to track bugs and features.
+* Before submitting a bug report or feature request, check to make sure it
+  hasn't
+  already been submitted.
+* When submitting a bug report, please include a [Gist][] that includes a stack
+  trace and any details that may be necessary to reproduce the bug, including
+  your release version, stack, and operating system. Ideally, a bug report
+  should include a pull request with failing specs.
+
+[gist]: https://gist.github.com/
+
+## Cleaning up issues
+
+* Issues that have no response from the submitter will be closed after 30 days.
+* Issues will be closed once they're assumed to be fixed or answered. If the
+  maintainer is wrong, it can be opened again.
+* If your issue is closed by mistake, please understand and explain the issue.
+  We will happily reopen the issue.
+
+## Submitting a Pull Request
+
+1. [Fork][fork] the [official repository][repo].
+2. [Create a topic branch.][branch]
+3. Implement your feature or bug fix.
+4. Add, commit, and push your changes.
+5. [Submit a pull request.][pr]
+
+## Notes
+
+* Please add tests if you changed code. Contributions without tests won't be accepted. 
+* If you don't know how to add tests, please put in a PR and leave a comment asking for help. 
+We love helping!
+
+[repo]: https://github.com/blues/jsonata-go/tree/master
+[fork]: https://help.github.com/articles/fork-a-repo/
+[branch]:
+https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/
+[pr]: https://help.github.com/articles/creating-a-pull-request-from-a-fork/
+
+Inspired by
+https://github.com/thoughtbot/factory_bot/blob/master/CONTRIBUTING.md
+

README.md

@@ -1,2 +1,79 @@
-# jsonata-go
-Open Source Go version of JSONata
+# JSONata in Go
+
+Package jsonata is a query and transformation language for JSON.
+It's a Go port of the JavaScript library [JSONata](http://jsonata.org/).
+
+It currently has feature parity with jsonata-js 1.5.4. As well as a most of the functions added in newer versions. You can see potentially missing functions by looking at the [jsonata-js changelog](https://github.com/jsonata-js/jsonata/blob/master/CHANGELOG.md).
+
+## Install
+
+    go get github.com/blues/jsonata-go
+
+## Usage
+
+```Go
+import (
+	"encoding/json"
+	"fmt"
+	"log"
+
+	jsonata "github.com/blues/jsonata-go"
+)
+
+const jsonString = `
+    {
+        "orders": [
+            {"price": 10, "quantity": 3},
+            {"price": 0.5, "quantity": 10},
+            {"price": 100, "quantity": 1}
+        ]
+    }
+`
+
+func main() {
+
+	var data interface{}
+
+	// Decode JSON.
+	err := json.Unmarshal([]byte(jsonString), &data)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// Create expression.
+	e := jsonata.MustCompile("$sum(orders.(price*quantity))")
+
+	// Evaluate.
+	res, err := e.Eval(data)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	fmt.Println(res)
+	// Output: 135
+}
+```
+
+## JSONata Server
+A locally hosted version of [JSONata Exerciser](http://try.jsonata.org/)
+for testing is [available here](https://github.com/blues/jsonata-go/jsonata-server).
+
+## JSONata tests
+A CLI tool for running jsonata-go against the [JSONata test suite](https://github.com/jsonata-js/jsonata/tree/master/test/test-suite) is [available here](https://github.com/blues/jsonata-go/jsonata-test).
+
+
+
+## Contributing
+
+We love issues, fixes, and pull requests from everyone. Please run the
+unit-tests, staticcheck, and goimports prior to submitting your PR. By participating in this project, you agree to abide by
+the Blues Inc [code of conduct](https://blues.github.io/opensource/code-of-conduct).
+
+For details on contributions we accept and the process for contributing, see our
+[contribution guide](CONTRIBUTING.md).
+
+In addition to the Go unit tests there is also a test runner that will run against the jsonata-js test
+suite in the [jsonata-test](https://github.com/blues/jsonata-go/jsonata-test) directory. A number of these tests currently fail, but we're working towards feature parity with the jsonata-js reference implementation. Pull requests welcome!
+
+If you would like to contribute to this library a good first issue would be to run the jsonata-test suite,
+and fix any of the tests not passing.