Bump version to 0.17.0, write CHANGELOG.md

CHANGELOG.md

@@ -1,3 +1,45 @@
-## Changelog for v0.16.0
+## Changelog for v0.17.0
 
-- Added HMS job count to debug info
+- Added support for `token` authentication
+- Completely refactored the way login and connection works
+- Now compatible with Smarthome user authentication tokens and server version `0.0.54`
+
+### Example Code
+This code demonstrates the use and difference of the new authentication methods
+```go
+package main
+
+import "github.com/smarthome-go/sdk"
+
+const URL = "http://localhost:8082"
+
+func main() {
+	// === Example 1: Using token authentication === //
+	c1, err := sdk.NewConnection(URL, sdk.AuthMethodQueryToken /* sdk.AuthMethodCookieToken */)
+	if err != nil {
+		panic(err.Error())
+	}
+	// Login with your user authentication token, to obtain one, visit `http://your-smarthome.box/profile`
+	if err := c1.TokenLogin("650feaafc1487d18bd8c5a805363be96"); err != nil {
+		panic(err.Error())
+	}
+
+	// === Example 2: Using username & password authentication === //
+	c2, err := sdk.NewConnection(URL, sdk.AuthMethodQueryPassword /* sdk.AuthMethodCookiePassword */)
+	if err != nil {
+		panic(err.Error())
+	}
+	// Login with the usual username-password combination
+	if err := c1.UserLogin("admin", "admin"); err != nil {
+		panic(err.Error())
+	}
+
+	// => After login, each connection behaves idenically
+	if err := c1.SetPower("s2", true); err != nil {
+		panic(err.Error())
+	}
+	if err := c2.SetPower("s2", true); err != nil {
+		panic(err.Error())
+	}
+}
+```

Makefile

@@ -1,4 +1,4 @@
-version := 0.16.0
+version := 0.17.0
 
 test:
 	go test -v -race .

main.go

@@ -1,7 +1,7 @@
 package sdk
 
 // Specifies the SDK version
-const Version = "0.16.0"
+const Version = "0.17.0"
 
 // Specifies the oldest Smarthome version this SDK can connect to
-const MinSmarthomeVersion = "0.0.50"
+const MinSmarthomeVersion = "0.0.54"