Add database Dial example

README.md

@@ -65,6 +65,56 @@ You are welcome to initiate pull request and suggest a more user-friendly API. W
 
 3) `go test -v ./...`
 
+## Examples
+
+### Dial
+
+```go
+// Dial example
+func main() {
+	defaultDbAddr := "127.0.0.1:2424"
+	testDbName := "test_db_example"
+	testDbUser := "root"
+	testDbPass := "root"
+
+	client, err := orient.Dial(defaultDbAddr)
+	if err != nil {
+		HandleError(err)
+	}
+
+	admin, err := client.Auth(testDbUser, testDbPass)
+	if err != nil {
+		HandleError(err)
+	}
+
+	// There are 2 options
+	// 1. orient.Persistent - represents on-disk database
+	// 2. orient.Volatile - represents in-memory database
+	ok, err := admin.DatabaseExists(testDbName, orient.Persistent)
+	if err != nil {
+		HandleError(err)
+	}
+
+	// If database does not exist let's create it
+	if !ok {
+		// There are 2 options
+		// 1. orient.GraphDB - graph database
+		// 2. orient.DocumentDB - document database
+		err = admin.CreateDatabase(testDbName, orient.GraphDB, orient.Persistent)
+		if err != nil {
+			HandleError(err)
+		}
+	}
+
+	// Open wanted database & operate further
+	database, err := client.Open(testDbName, orient.GraphDB, testDbUser, testDbPass)
+	if err != nil {
+		HandleError(err)
+	}
+	defer database.Close()
+}
+```
+
 ## LICENSE
 
 The MIT License

examples/dial/main.go

@@ -0,0 +1,54 @@
+package main
+
+import (
+	"gopkg.in/istreamdata/orientgo.v2"
+	_ "gopkg.in/istreamdata/orientgo.v2/obinary"
+)
+
+func HandleError(err error) {
+	panic(err)
+}
+
+// Dial example
+func main() {
+	defaultDbAddr := "127.0.0.1:2424"
+	testDbName := "test_db_example"
+	testDbUser := "root"
+	testDbPass := "root"
+
+	client, err := orient.Dial(defaultDbAddr)
+	if err != nil {
+		HandleError(err)
+	}
+
+	admin, err := client.Auth(testDbUser, testDbPass)
+	if err != nil {
+		HandleError(err)
+	}
+
+	// There are 2 options
+	// 1. orient.Persistent - represents on-disk database
+	// 2. orient.Volatile - represents in-memory database
+	ok, err := admin.DatabaseExists(testDbName, orient.Persistent)
+	if err != nil {
+		HandleError(err)
+	}
+
+	// If database does not exist let's create it
+	if !ok {
+		// There are 2 options
+		// 1. orient.GraphDB - graph database
+		// 2. orient.DocumentDB - document database
+		err = admin.CreateDatabase(testDbName, orient.GraphDB, orient.Persistent)
+		if err != nil {
+			HandleError(err)
+		}
+	}
+
+	// Open wanted database & operate further
+	database, err := client.Open(testDbName, orient.GraphDB, testDbUser, testDbPass)
+	if err != nil {
+		HandleError(err)
+	}
+	defer database.Close()
+}