Merge branch 'ver.1.2'

Author: strongtigerman

README.md

@@ -1,14 +1,15 @@
-### Introduction
+## Introduction
 
 EasyMorph Server Command Line Client (in further text – **ems-cmd**) allows you to run server commands via REST API.
 
 
-### Requirements
-1. OS Windows with .Net 4.5 or later
-2. Morph.Server.Sdk.dll (deployed together with ems-cmd).  
+#### Requirements
+1. OS Windows x86/x64  with .Net 4.5 or later
+2. Morph.Server.Sdk.dll (deployed together with ems-cmd). Also [hosted on github](https://github.com/easymorph/server-sdk)  
+3. [EasyMorph Server 1.2](http://easymorph.com/server.html) or higher (installed on a separate PC)
 
 
-General command format:
+#### General command format:
 
 ```
 ems-cmd <commad> <host> -param1 value1 -param2 "value two"
@@ -21,6 +22,12 @@ where
 +  **```<host>```** - Server host like `http://192.168.100.200:6330`.
 
 
+#### exit codes
+ems-cmd  may return one of the following exit codes:
+* `0` ems-cmd was successfully run to completion.
+* `1` A fatal error occurred during command parsing or execution.
+
+
 
 ### Commands
 
@@ -114,20 +121,27 @@ Listing done
 ```
 
 
-#### Download the file
+#### Download file
 This command will download one single file from server
 
 If local file already exists, you will be prompted to overwrite it. 
 Notice, that when you are using a redirected output (e.g. to the file) and local file already exists, download will fail. 
 In any case, you may use parameter `/y` to overwrite existing file without any prompts.
 
+
+Be careful with folders that contain spaces in their names. You should add quotation marks around such parameter values. 
+Keep in mind, that sequence  `\"` will escape double quotes. So `"D:\"`, `"D:\another folder\"` are incorrect, use `D:\` and `"D:\another folder"` instead.
+
 ```
-ems-cmd download http://192.168.100.200:6330 -space Default -to "D:\your\local\folder" -from "server\folder\file.xml" 
+ems-cmd download http://192.168.100.200:6330 -space Default -target D:\your\local\folder -source file.xml 
+ems-cmd download http://192.168.100.200:6330 -space Default -target D:\your\local\folder -source \file.xml
+ems-cmd download http://192.168.100.200:6330 -space Default -target D:\your\local\folder -source \server\folder\file.xml
+ems-cmd download http://192.168.100.200:6330 -space Default -target "D:\local\folder with spaces" -source "server\folder with spaces\file3.xml" 
 ```
 ###### Parameters
 * `-space` - space name, e.g. `Default`
-* `-to` - destination folder (you local folder).
-* `-from` - relative path to file in the space `-space`
+* `-target` - destination folder (you local folder).
+* `-source` - relative path to file in the space `-space`
 * `/y` - overwrite existing file (silent agree)
 
 ###### Output
@@ -137,20 +151,28 @@ Operation completed
 ```
 
 
-#### Upload the file
+#### Upload file
 This command will upload one single to server
 
 If remote file already exists, you will be prompted to overwrite it. 
 Notice, that when you are using a redirected output (e.g. to the file) and remote file already exists, upload will fail. 
 In any case, you may use parameter `/y` to overwrite existing file without any prompts.
 
+
+Be careful with folders that contain spaces in their names. You should add quotation marks around such parameter values. 
+Keep in mind, that sequence  `\"` will escape double quotes. So `"D:\"`, `"D:\another folder\"` are incorrect, use `D:\` and `"D:\another folder"` instead.
+
+
 ```
-ems-cmd upload http://192.168.100.200:6330 -space Default -from "D:\your\local\folder\file.xml" -to "\" 
+ems-cmd upload http://192.168.100.200:6330 -space Default -source D:\your\local\folder\file.xml -target \
+ems-cmd upload http://192.168.100.200:6330 -space Default -source D:\your\local\folder\file2.xml -target "folder 2"
+ems-cmd upload http://192.168.100.200:6330 -space Default -source D:\your\local\folder\file2.xml -target "folder 2\sub folder"
+ems-cmd upload http://192.168.100.200:6330 -space Default -source "D:\local\folder with spaces" -target "folder 2\sub folder"
 ```
 ###### Parameters
 * `-space` - space name, e.g. `Default`
-* `-to` - destination folder (remote folder, relative path in the space `-space`).
-* `-from` - path to your local file
+* `-target` - destination folder (remote folder, relative path in the space `-space`).
+* `-source` - path to your local file
 * `/y` - overwrite existing file (silent agree)
 
 ###### Output
@@ -164,13 +186,15 @@ Operation completed
 This command will delete remote file
 
 ```
-ems-cmd del http://192.168.100.200:6330 -space Default -file "folder 2\file.xml" 
+ems-cmd del http://192.168.100.200:6330 -space Default -target "folder 2\file.xml" 
 ```
 ###### Parameters
 * `-space` - space name, e.g. `Default`
-* `-file` - relative path in the space `-space` to the file
+* `-target` - relative path in the space `-space` to file 
 
+## License 
 
+**ems-cmd** is licensed under the [MIT license](https://github.com/easymorph/server-cmd/blob/master/LICENSE).
 
 
 

src/BusinessLogic/Commands/BaseCommand.cs

@@ -0,0 +1,35 @@
+using Morph.Server.Sdk.Client;
+using MorphCmd.Interfaces;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace MorphCmd.BusinessLogic.Commands
+{
+    internal abstract class BaseCommand
+    {
+
+
+        protected readonly IOutputEndpoint _output;
+        protected readonly IInputEndpoint _input;
+        protected readonly IMorphServerApiClient _apiClient;
+        protected readonly CancellationTokenSource _cancellationTokenSource;
+
+        public BaseCommand(IOutputEndpoint output, IInputEndpoint input, IMorphServerApiClient apiClient)
+        {
+            _output = output;
+            _input = input;
+            _apiClient = apiClient;
+            _cancellationTokenSource = new CancellationTokenSource();
+        }
+
+        protected void RequireParam(Guid? value)
+        {
+
+        }
+
+    }
+}

src/BusinessLogic/Commands/BrowseCommand.cs

@@ -0,0 +1,47 @@
+using Morph.Server.Sdk.Client;
+using MorphCmd.Interfaces;
+using MorphCmd.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace MorphCmd.BusinessLogic.Commands
+{
+
+    internal class BrowseCommand : BaseCommand, ICommand
+    {
+        public BrowseCommand(IOutputEndpoint output, IInputEndpoint input, IMorphServerApiClient apiClient) : base(output, input, apiClient)
+        {
+
+        }
+
+        public async Task Execute(Parameters parameters)
+        {
+            if (string.IsNullOrWhiteSpace(parameters.Location))
+            {
+                _output.WriteInfo("Browsing the root folder of the space " + parameters.Space);
+            }
+            else
+            {
+                _output.WriteInfo("Browsing the folder '" + parameters.Location + "' of the space " + parameters.Space);
+            }
+            var data = await _apiClient.BrowseSpaceAsync(parameters.Space, parameters.Location, _cancellationTokenSource.Token);
+            _output.WriteInfo("Space: " + data.SpaceName);
+            _output.WriteInfo("Free space: " + data.FreeSpaceBytes + " bytes");
+            foreach (var folder in data.Folders)
+            {
+                _output.WriteInfo(string.Format("{0}{1} {2}", folder.LastModified.ToLocalTime().ToString("MM/dd/yyyy hh:mm:ss tt").PadRight(30), "<DIR>".PadRight(16), folder.Name));
+            }
+            foreach (var file in data.Files)
+            {
+                _output.WriteInfo(string.Format("{0}{1} {2}", file.LastModified.ToLocalTime().ToString("MM/dd/yyyy hh:mm:ss tt").PadRight(30), file.FileSizeBytes.ToString("n0").PadLeft(16), file.Name));
+            }
+
+
+            _output.WriteInfo("Listing done");
+
+        }
+    }
+}

src/BusinessLogic/Commands/CommandsFactory.cs

@@ -0,0 +1,39 @@
+using Morph.Server.Sdk.Client;
+using MorphCmd.Interfaces;
+using MorphCmd.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace MorphCmd.BusinessLogic.Commands
+{
+    internal static class CommandsFactory
+    {
+        public static ICommand Construct(Command command, IOutputEndpoint output, IInputEndpoint input, IMorphServerApiClient apiClient)
+        {
+            switch (command)
+            {
+                case Command.Run:
+                    return new RunTaskAndWaitCommand(output, input, apiClient);
+                case Command.RunAsync:
+                    return new RunTaskAndForgetCommand(output, input, apiClient);
+                case Command.Status:
+                    return new ServerStatusCommand(output, input, apiClient);
+                case Command.Upload:
+                    return new UploadFileCommand(output, input, apiClient);
+                case Command.Browse:
+                    return new BrowseCommand(output, input, apiClient);
+                case Command.Del:
+                    return new DeleteFileCommand(output, input, apiClient);
+                case Command.Download:
+                    return new DownloadFileCommand(output, input, apiClient);
+                case Command.ValidateTasks:
+                    return new ValidateTasksCommand(output, input, apiClient);
+                default:
+                    throw new Exception("Command not supported");
+            }
+        }
+    }
+}

src/BusinessLogic/Commands/DeleteFileCommand.cs

@@ -0,0 +1,33 @@
+using Morph.Server.Sdk.Client;
+using MorphCmd.Exceptions;
+using MorphCmd.Interfaces;
+using MorphCmd.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace MorphCmd.BusinessLogic.Commands
+{
+    internal class DeleteFileCommand : BaseCommand, ICommand
+    {
+        public DeleteFileCommand(IOutputEndpoint output, IInputEndpoint input, IMorphServerApiClient apiClient) : base(output, input, apiClient)
+        {
+
+        }
+
+        public async Task Execute(Parameters parameters)
+        {
+            if (string.IsNullOrWhiteSpace(parameters.Target))
+            {
+                throw new WrongCommandFormatException("Target is required");
+            }
+
+            _output.WriteInfo(string.Format("Deleting file {0} in space {1}...", parameters.Target, parameters.Space ?? "Default"));
+            await _apiClient.DeleteFileAsync(parameters.Space, parameters.Target, null, _cancellationTokenSource.Token);
+            _output.WriteInfo("Operation completed");
+
+        }
+    }
+}