NetcoreFSL 1.0.3

NetcoreFSL

Versión: 1.0.3 · Estado: estable (Fases 0–6)
aka: NetCore FastSearchLibrary

Biblioteca multiplataforma y multi-hilo para .NET 8, escrita en C#, que permite buscar archivos y directorios en el sistema de archivos mediante patrones, con API basada en eventos.

Características

• Búsqueda recursiva de archivos y carpetas por patrón
• API basada en eventos (FilesFound, FoldersFound, ciclo de vida)
• Ejecución síncrona o en segundo plano (ExecuteHandlers)
• Cancelación, pausa y reanudación
• Paralelismo acotado y seguro entre hilos
• 21 tests automatizados (xUnit), verificados en .NET 8 y en CI (GitHub Actions)

Requisitos

• .NET 8 SDK o superior (ver global.json para versión mínima)

Instalación

Referencia al proyecto (desarrollo)

git clone https://github.com/alanjmrt94/netcore-fsl.git
cd netcore-fsl
dotnet build netcore-fsl.sln

En su .csproj:

<ItemGroup>
  <ProjectReference Include="ruta/a/netcore-fsl/NetcoreFSL/NetcoreFSL.csproj" />
</ItemGroup>

Paquete NuGet

Tras publicar un release (tag v*.*.* + secret NUGET_API_KEY en GitHub), instale con:

dotnet add package NetcoreFSL

Instrucciones para mantenedores: docs/CI.md. Script todo-en-uno: ./scripts/release.sh.

Inicio rápido

using NetcoreFSL;
using NetcoreFSL.Searcher.Enums;

var fsl = new FSL(ExecuteHandlers.InCurrentTask, "/etc", ".conf");

fsl.FilesFound += (_, e) =>
{
  foreach (var file in e.Files)
    Console.WriteLine(file.FullName);
};

fsl.SearchCompleted += (_, e) =>
  Console.WriteLine($"Completado: {e.IsCompleted}");

fsl.FileSearch();

API pública

Clase FSL

Eventos

ExecuteHandlers

Patrones

Comportamiento entre búsquedas

• Los eventos persisten en la instancia FSL.
• Una nueva FileSearch() / FolderSearch() cancela la búsqueda anterior.
• Use instancias separadas para búsquedas concurrentes independientes.

Ejemplos

Búsqueda de carpetas

var fsl = new FSL(ExecuteHandlers.InCurrentTask, "/etc", "systemd");
fsl.FoldersFound += (_, e) =>
{
  foreach (var dir in e.Folders)
    Console.WriteLine(dir.FullName);
};
fsl.FolderSearch();

Cancelación y segundo plano

using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(30));
var fsl = new FSL(ExecuteHandlers.InNewTask, "/var/log", ".log", cts.Token);
fsl.SearchCompleted += (_, e) => Console.WriteLine(e.IsCompleted);
fsl.FileSearch(); // retorna de inmediato

Verificación y pruebas

Tests automatizados (.NET 8)

dotnet test netcore-fsl.sln -c Release

Resultado verificado: 21/21 pruebas OK, 0 errores, 0 warnings (Release).

CI en cada push/PR: ver badge arriba y docs/CI.md.

Detalle en docs/VERIFICATION.md.

Proyecto de prueba manual

dotnet run --project NetcoreTEST -- /etc .conf file sync
dotnet run --project NetcoreTEST -- /etc systemd folder async

Argumentos: <carpeta> <patron> [file|folder] [sync|async]

Variables de entorno: FSL_FOLDER, FSL_PATTERN, FSL_MODE, FSL_HANDLER, FSL_TIMEOUT_MS

Limitaciones conocidas

Estructura del repositorio

netcore-fsl/
├── NetcoreFSL/          # Biblioteca principal
├── NetcoreFSL.Tests/    # Tests xUnit (21 pruebas)
├── NetcoreTEST/         # Consola de prueba manual
├── docs/
│   ├── VERIFICATION.md  # Verificación .NET 8
│   └── CI.md            # GitHub Actions y publicación NuGet
├── scripts/
│   └── release.sh       # Build, test, pack, NuGet y GitHub Release
└── CHANGELOG.md

Versión en tiempo de ejecución

Console.WriteLine(FSL.Version);        // "1.0.3"
Console.WriteLine(FSLVersion.Current); // "1.0.3"

Fuente de verdad: NetcoreFSL/NetcoreFSL.csproj → <Version>.

Versionado

Semantic Versioning. Historial en CHANGELOG.md.

Licencia

MIT — Copyright (c) 2021-2026 Alan Javier Martinez