CLI - config & version commands + tests

Signed-off-by: May Rosenbaum <[email protected]>

Makefile

@@ -48,6 +48,7 @@ goimports:
 .PHONY: binary
 binary:
 	$(GO) build -o $(BIN)/bdb github.com/hyperledger-labs/orion-server/cmd/bdb
+	$(GO) build -o $(BIN)/bcdbadmin github.com/hyperledger-labs/orion-sdk-go/cli
 
 .PHONY: test
 test-script:

cli/README.md

@@ -0,0 +1,48 @@
+# Config Orion via CLI
+
+This command-line tool provides a simple way to config an orion database server.
+
+## Building the tool
+1. Run from `orion-sdk` root folder
+2. Run `make binary` to create an executable file named bcdbadmin under `bin` directory.
+
+## Commands
+
+Here we list and describe the available commands.
+We give a short explanation of their usage and describe the flags for each command.
+We provide real-world examples demonstrating how to use the CLI tool for various tasks.
+
+
+### Version Command
+This command prints the version of the CLI tool.
+1. Run from `orion-sdk` root folder.
+2. Run `bin/bcdbadmin version`. This command has no flags.
+
+
+
+### Config Command
+This command enables to config an orion server or ask for the configuration of an orion server. 
+
+#### Get Config Command
+1. Run from 'orion-sdk' root folder.
+2. For Get Config Run `bin/bcdbadmin config get [args]`.
+
+   Replace `[args]` with flags.
+
+###
+##### Flags
+| Flags                       | Description                                                         |
+|-----------------------------|---------------------------------------------------------------------|
+| `-c, --cli-config-path`     | the absolute or relative path of CLI connection configuration file  |
+| `-p, --cluster-config-path` | the absolute path to which the server configuration will be saved   |
+
+Both flags are necessary flags. If any flag is missing, the cli will raise an error.
+
+###
+##### Example:
+
+Running 
+`bin/bcdbadmin config get -c "connection-session-config.yaml" -p "A/B/C"`
+reads the connection and session details needed for connecting to a server from `connection-session-config.yaml` and 
+sends a config TX.
+It creates a directory in `A/B/C` with the respective certificates and a yaml file, named shared_cluster_config.yaml, that includes the cluster configuration.

cli/commands/admin.go

@@ -0,0 +1,43 @@
+package commands
+
+import (
+	"github.com/pkg/errors"
+	"github.com/spf13/cobra"
+)
+
+func adminCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "admin",
+		Short: "manage administrators",
+		Args:  nil,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	}
+
+	cmd.AddCommand(&cobra.Command{
+		Use:   "add",
+		Short: "Add an admin",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	})
+
+	cmd.AddCommand(&cobra.Command{
+		Use:   "remove",
+		Short: "Remove an admin",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	})
+
+	cmd.AddCommand(&cobra.Command{
+		Use:   "update",
+		Short: "Update an admin",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	})
+
+	return cmd
+}

cli/commands/admin_test.go

@@ -0,0 +1,27 @@
+package commands
+
+import (
+	"github.com/hyperledger-labs/orion-sdk-go/examples/util"
+	"github.com/stretchr/testify/require"
+	"io/ioutil"
+	"os"
+	"testing"
+)
+
+func TestAdminCommand(t *testing.T) {
+	// 1. Create crypto material and start server
+	tempDir, err := ioutil.TempDir(os.TempDir(), "ExampleTest")
+	require.NoError(t, err)
+
+	testServer, _, _, err := util.SetupTestEnv(t, tempDir, uint32(6003))
+	require.NoError(t, err)
+	defer testServer.Stop()
+	util.StartTestServer(t, testServer)
+
+	// 2. Check cas command response
+	rootCmd := InitializeOrionCli()
+	rootCmd.SetArgs([]string{"admin"})
+	err = rootCmd.Execute()
+	require.Error(t, err)
+	require.Equal(t, err.Error(), "not implemented yet")
+}

cli/commands/cas.go

@@ -0,0 +1,35 @@
+package commands
+
+import (
+	"github.com/pkg/errors"
+	"github.com/spf13/cobra"
+)
+
+func casCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "CAs",
+		Short: "manage CA's",
+		Args:  nil,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	}
+
+	cmd.AddCommand(&cobra.Command{
+		Use:   "add",
+		Short: "Add CA",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	})
+
+	cmd.AddCommand(&cobra.Command{
+		Use:   "remove",
+		Short: "Remove CA",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return errors.New("not implemented yet")
+		},
+	})
+
+	return cmd
+}

cli/commands/cas_test.go

@@ -0,0 +1,27 @@
+package commands
+
+import (
+	"github.com/hyperledger-labs/orion-sdk-go/examples/util"
+	"github.com/stretchr/testify/require"
+	"io/ioutil"
+	"os"
+	"testing"
+)
+
+func TestCasCommand(t *testing.T) {
+	// 1. Create crypto material and start server
+	tempDir, err := ioutil.TempDir(os.TempDir(), "ExampleTest")
+	require.NoError(t, err)
+
+	testServer, _, _, err := util.SetupTestEnv(t, tempDir, uint32(6003))
+	require.NoError(t, err)
+	defer testServer.Stop()
+	util.StartTestServer(t, testServer)
+
+	// 2. Check cas command response
+	rootCmd := InitializeOrionCli()
+	rootCmd.SetArgs([]string{"CAs"})
+	err = rootCmd.Execute()
+	require.Error(t, err)
+	require.Equal(t, err.Error(), "not implemented yet")
+}