SeaweedFs.Net

C# seaweedfs client. Example usage
Currently- only Filer is implemented

POC

IFilerStore

IFilerStore- root directory. Entry http://localhost:8888/. Basically, it's a IFilerCatalog provider

        /// <summary>
        /// Interface IFilerStore
        /// </summary>
        public interface IFilerStore
        {
            /// <summary>
            /// Gets the catalog.
            /// </summary>
            /// <param name="directory">The directory.</param>
            /// <returns>IFilerCatalog.</returns>
            IFilerCatalog GetCatalog(string directory);
        }

IFilerCatalog

IFilerCatalog- directory entry from root path eg. http://localhost:8888/documents

          var documentsCatalog = _filerStore.GetCatalog("documents");

Subdirectories concept- mean, that we could create catalog entry with subdirectories.

         var documentInvoicesCatalog = _filerStore.GetCatalog("documents/invoices");

It should be really powerfull with dynamic catalog subdirectories

        var userInvoiceAttachmentsCat = _filerStore.GetCatalog($"users/{userId}/documents/invoices/{invoiceId}/attachments");  

Quick Start

Usage:

        //create fakeFileStream
        await using (var outboundFileStream = await GetStream(0xC0FFEE))
        {

            _logger.LogInformation($"File Created: {outboundFileStream.Name}");

            //get catalog
            var catalog = _filerStore.GetCatalog("documents");

            //delete all files
            Parallel.ForEach(await catalog.ListAsync(), (bi) => catalog.DeleteAsync(bi).ConfigureAwait(false));

            //create simple blob
            var blob = new Blob($"{Guid.NewGuid()}.txt", outboundFileStream);

            //add custom header value
            blob.BlobInfo.Headers.Add("Seaweed-OwnerId", new[] { $"{Guid.NewGuid()}" });

            //push blob
            await catalog.PushAsync(blob, new Progress<int>((p) =>
            {
                _logger.LogInformation($"Upload progress: {p} %");
            }));

            using (var uploadedBlob = await catalog.GetAsync(blob.BlobInfo.Name,
                new Progress<int>((p) => { _logger.LogInformation($"Download progress: {p} %"); })))
            {
                //read
                using (var sr = new StreamReader(uploadedBlob.Content))
                {
                    string line;
                    while ((line = await sr.ReadLineAsync()) != null)
                    {

                    }
                }


            }

            System.IO.File.Delete(outboundFileStream.Name);
            _logger.LogInformation($"File Deleted: {outboundFileStream.Name}");
        }

Setup:

         public static IHostBuilder CreateHostBuilder(string[] args) =>
          Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.ConfigureServices(services =>
                    {
                        services.AddSwaggerGen(c =>
                        {
                            c.SwaggerDoc("v1", new OpenApiInfo {Title = "SeaweedFs.Client", Version = "v1"});
                        });

                        services.AddSeaweedFiler("http://localhost:8888");
                        services.AddControllers();
                    })
                    .Configure(app =>
                    {
                        var env = app.ApplicationServices.GetRequiredService<IWebHostEnvironment>();
                        if (env.IsDevelopment())
                        {
                            app.UseDeveloperExceptionPage();
                            app.UseSwagger();
                            app.UseSwaggerUI(c =>
                                c.SwaggerEndpoint("/swagger/v1/swagger.json", "SeaweedFs.Client v1"));
                        }

                        app.UseRouting();
                        app.UseAuthorization();
                        app.UseEndpoints(endpoints =>
                        {
                            endpoints.MapControllers();
                        });
                    })
                    .UseLogging(LoggerOptions.Default);
            });