Lbe.Documents 0.1.0

Lbe.Documents

Biblioteca pequeña de .NET 10 para generar el mismo reporte tabular en DOCX, XLSX y PDF, y extraer la capa de texto de un PDF. Usa Open XML SDK, ClosedXML, PDFsharp y PdfPig.

Cuando la primera versión esté publicada en NuGet.org, instálala con:

dotnet add package Lbe.Documents --version 0.1.0

Mientras tanto, clona el repositorio y añade una referencia al proyecto de la biblioteca desde tu aplicación:

dotnet add <ruta-a-tu-aplicacion.csproj> reference src/Lbe.Documents/Lbe.Documents.csproj

La versión 0.1.0 también se puede empaquetar localmente. Consulta cómo se publica para configurar NuGet.org y lanzar un release.

Inicio rápido

using Lbe.Documents;

var report = new TabularReport(
    "Pedidos",
    ["Id", "Cliente", "Importe"],
    [["A-001", "Ana", "125.00"]]);

using var word = File.Create("pedidos.docx");
DocumentExporter.WriteDocx(report, word);

using var excel = File.Create("pedidos.xlsx");
DocumentExporter.WriteXlsx(report, excel);

El ejemplo completo también crea un PDF y vuelve a leer su texto. Para el PDF debes suministrar una fuente TTF y configurar el IFontResolver de PDFsharp antes de crear XFont; así funciona también en Linux sin depender de fuentes instaladas en el servidor. No se incluye un archivo de fuente en el repositorio.

dotnet run --project examples/Lbe.Documents.Example -- ./salida C:/Windows/Fonts/arial.ttf

Alcance y límites

• Los valores de XLSX se escriben como texto para conservar IDs y ceros iniciales. Si necesitas fórmulas o tipos numéricos, trabaja directamente con ClosedXML.
• El PDF usa una tabla simple; el texto demasiado ancho se acorta visualmente con puntos suspensivos. DOCX y XLSX conservan el valor completo.
• ExtractPdfText lee PDFs con capa de texto. Para escaneos hace falta OCR, que aquí no está incluido.
• Open XML SDK no convierte DOCX a PDF ni ofrece un motor de maquetación de Word.
• La biblioteca no automatiza Microsoft Office y no requiere instalarlo en el servidor.

Desarrollo

dotnet test tests/Lbe.Documents.Tests/Lbe.Documents.Tests.csproj
dotnet pack src/Lbe.Documents/Lbe.Documents.csproj -c Release

El código es MIT. Revisa también las licencias de las dependencias y de la fuente TTF que uses en tu aplicación.