FileFlower.Core 0.0.1-alpha.1

.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
This is a prerelease version of FileFlower.Core.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package FileFlower.Core --version 0.0.1-alpha.1
                    


                    

                
NuGet\Install-Package FileFlower.Core -Version 0.0.1-alpha.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FileFlower.Core" Version="0.0.1-alpha.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FileFlower.Core" Version="0.0.1-alpha.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FileFlower.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FileFlower.Core --version 0.0.1-alpha.1
                    


                    

                
#r "nuget: FileFlower.Core, 0.0.1-alpha.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package FileFlower.Core@0.0.1-alpha.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=FileFlower.Core&version=0.0.1-alpha.1&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FileFlower.Core&version=0.0.1-alpha.1&prerelease
                    


                            Install as a Cake Tool

FileFlower

Overview

FileFlower is a lightweight, flexible .NET library that enables event-driven, pipeline-based processing of file system changes. Designed for building modular workflows around directory watching, FileFlower lets you:

  • React to file creation, modification, deletion events
  • Filter and route files by patterns and extensions
  • Define processing pipelines with pre- and post-steps
  • Easily chain multiple processors in a clean, reusable way

FileFlower is ideal for building file ingestion services, automated workflows, and data pipelines that work with file systems in a reactive and maintainable manner.

Features

  • Monitor directories and subdirectories for file changes
  • Filter files by pattern, extension, or custom rules
  • Define composable pipeline steps for processing files
  • Support for error handling, retries, and archiving
  • Minimal dependencies, cross-platform (.NET 8+)

Getting Started

var watcher = new FileWatcherBuilder("~/files");

watcher.WhenResourceCreated(rule => rule.Filter("*.txt").Filter("*.csv").WithOrLogic())
       .AddStep(file =>
       {
           Console.WriteLine($"CLIENT | Processed txt or csv: {file.FullName}");
           return Task.CompletedTask;
       });

watcher.WhenResourceCreated(rule => rule.Filter("*test*").Filter("*.bat"))
       .AddStep(file =>
       {
           Console.WriteLine($"CLIENT | Processed bat which contains word 'test': {file.FullName}");
           return Task.CompletedTask;
       });

watcher.WhenResourceCreated(rule => rule.Filter("*.log"))
       .AddStep(file =>
       {
           Console.WriteLine($"CLIENT | Processed log: {file.FullName}");
           return Task.CompletedTask;
       });
Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on FileFlower.Core:

Package Downloads
FileFlower.DependencyInjection

A flexible event-driven pipeline for file system changes

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.1 139 6/25/2025
1.0.0 137 6/25/2025
0.0.1-rc.1 114 6/24/2025
0.0.1-alpha.6 68 6/20/2025
0.0.1-alpha.5 62 6/20/2025
0.0.1-alpha.4 67 6/20/2025
0.0.1-alpha.3 62 6/20/2025
0.0.1-alpha.2 69 6/20/2025
0.0.1-alpha.1 67 6/20/2025