Files
duplicati/proprietary/DiskImage/Filesystem/Interfaces.cs
T

75 lines
2.8 KiB
C#

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using System.Threading.Tasks;
using Duplicati.Proprietary.DiskImage.Partition;
namespace Duplicati.Proprietary.DiskImage.Filesystem;
public interface IFilesystem : IDisposable
{
/// <summary>
/// Gets the parent partition.
/// </summary>
IPartition Partition { get; }
/// <summary>
/// Gets the filesystem type.
/// </summary>
FileSystemType Type { get; }
/// <summary>
/// Gets filesystem-specific metadata. E.g. for journal filesystems, this could be the journal file.
/// </summary>
/// <param name="cancellationToken">Cancellation token.</param>
/// <returns>A task that resolves to filesystem-specific metadata.</returns>
Task<object?> GetFilesystemMetadataAsync(CancellationToken cancellationToken);
/// <summary>
/// Lists top-level files in the filesystem.
/// </summary>
/// <param name="cancellationToken">Cancellation token.</param>
/// <returns>A task that resolves to a collection of top-level files.</returns>
IAsyncEnumerable<IFile> ListFilesAsync(CancellationToken cancellationToken);
/// <summary>
/// Lists files in a directory.
/// </summary>
/// <param name="directory">The directory to list files from.</param>
/// <param name="cancellationToken">Cancellation token.</param>
/// <returns>A task that resolves to a collection of files in the specified directory.</returns>
/// <throws cref="ArgumentNullException">Thrown if <paramref name="directory"/> is null.</throws>
/// <throws cref="ArgumentException">Thrown if <paramref name="directory"/> is not a directory.</throws>
IAsyncEnumerable<IFile> ListFilesAsync(IFile directory, CancellationToken cancellationToken);
Task<Stream> OpenReadStreamAsync(IFile file, CancellationToken cancellationToken);
Task<Stream> OpenWriteStreamAsync(IFile file, CancellationToken cancellationToken);
Task<Stream> OpenReadWriteStreamAsync(IFile file, CancellationToken cancellationToken);
Task<long> GetFileLengthAsync(IFile file, CancellationToken cancellationToken);
Task<Stream> OpenReadStreamAsync(string path, CancellationToken cancellationToken);
Task<Stream> OpenWriteStreamAsync(string path, CancellationToken cancellationToken);
Task<Stream> OpenReadWriteStreamAsync(string path, CancellationToken cancellationToken);
Task<long> GetFileLengthAsync(string path, CancellationToken cancellationToken);
}
public interface IFile
{
string? Path { get; }
long? Address { get; }
long Size { get; }
bool IsDirectory { get; }
}
public interface IFileMetadata
{
byte[]? RawMetadata { get; }
DateTimeOffset? Created { get; }
DateTimeOffset? Modified { get; }
DateTimeOffset? Accessed { get; }
}