// Copyright (C) 2025, The Duplicati Team // https://duplicati.com, hello@duplicati.com // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. using Duplicati.Library.Interface; namespace Duplicati.Library.SourceProvider; /// /// A source provider that wraps a backend /// /// The backend to wrap /// The path to mount the backend public class BackendSourceProvider(IFolderEnabledBackend backend, string mountedPath) : ISourceProvider, ISourceProviderModule { /// /// The wrapped backend /// public IFolderEnabledBackend WrappedBackend => backend; /// /// The path where the provider is logically mounted /// public string MountedPath => mountedPath; /// public string Key => backend.ProtocolKey; /// public string DisplayName => backend.DisplayName; /// public IList SupportedCommands => backend.SupportedCommands; /// /// The prepared root entry, if any /// private BackendSourceFileEntry? preparedRoot; /// /// Flags if the provider has been initialized /// private int isInitialized = 0; /// /// Creates a root entry /// /// The root entry private BackendSourceFileEntry CreateRoot() => new BackendSourceFileEntry(this, "", true, true, new DateTime(0), new DateTime(0), 0); /// public async Task Initialize(CancellationToken cancellationToken) { // Only allow a single intiiialization call if (Interlocked.Exchange(ref isInitialized, 1) != 0) return; // Prepare the root entry var root = CreateRoot(); await root.PrepareEnumerator(cancellationToken).ConfigureAwait(false); preparedRoot = root; } /// public IAsyncEnumerable Enumerate(CancellationToken cancellationToken) => new[] { Interlocked.Exchange(ref preparedRoot, null) ?? CreateRoot() }.ToAsyncEnumerable(); /// public async Task GetEntry(string path, bool isFolder, CancellationToken cancellationToken) { var entry = await backend.GetEntryAsync(BackendSourceFileEntry.NormalizePathTo(path, '/'), cancellationToken).ConfigureAwait(false); return entry == null ? null : BackendSourceFileEntry.FromFileEntry(this, path, entry); } /// public void Dispose() { WrappedBackend.Dispose(); GC.SuppressFinalize(this); } }