using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Tango.FileSystem;
using Tango.FSE.Common.FileSystem;

namespace Tango.FSE.Common.Firmware
{
    public interface IFirmwareStorageProvider
    {
        /// <summary>
        /// Gets a folder by the specified path.
        /// </summary>
        /// <param name="path">The path.</param>
        /// <returns></returns>
        Task<IFileSystemContainer> GetFolder(String path);

        /// <summary>
        /// Gets the ThisPC (the root path of the storage device).
        /// </summary>
        /// <returns></returns>
        Task<IFileSystemContainer> GetRoot();

        /// <summary>
        /// Downloads the specified file item.
        /// </summary>
        /// <param name="item">The file item.</param>
        /// <param name="localTargetPath">The local target path.</param>
        /// <returns></returns>
        Task<FileSystemHandler> Download(FileItem item, String localTargetPath);

        /// <summary>
        /// Uploads the specified local file or folder.
        /// </summary>
        /// <param name="localSourcePath">The local source path.</param>
        /// <param name="remoteTargetPath">The remote destination path.</param>
        /// <returns></returns>
        /// <exception cref="System.IO.FileNotFoundException">Could not locate the local file or directory to upload.</exception>
        Task<FileSystemHandler> Upload(String localSourcePath, String remoteTargetPath);

        /// <summary>
        /// Deletes the specified file or folder.
        /// </summary>
        /// <param name="item">The remote file or folder.</param>
        /// <returns></returns>
        Task Delete(FileSystemItem item);

        /// <summary>
        /// Creates a new folder at the specified remote parent.
        /// </summary>
        /// <param name="parent">The remote parent path.</param>
        /// <param name="folderName">Name of the new folder.</param>
        /// <returns></returns>
        Task<FolderItem> CreateFolder(FileSystemItem parent, String folderName);
    }
}