FluentReport 1.0.0

FluentReport

Librería .NET 10 para generar PDFs y Excel usando una API fluent en C#. Usa SkiaSharp como motor de renderizado PDF y ClosedXML para Excel. Funciona en Linux sin dependencias nativas adicionales.

Características

• API fluent para construir documentos PDF y Excel (.xlsx)
• Motor de layout con cálculo de tamaños (measure/arrange)
• Elementos: texto, columnas, filas, tablas, imágenes, espaciadores, líneas, bordes, padding, salto de página
• Soporte de cabecera y pie de página
• Numeración de páginas dinámica
• Salto de página automático cuando el contenido supera la página
• Renderer Excel (FluentReport.Excel): genera .xlsx directamente desde el mismo fluent API
• Compatible con Linux (SkiaSharp.NativeAssets.Linux.NoDependencies)

Instalación

Agrega la referencia al proyecto principal:

<ProjectReference Include="src/FluentReport/FluentReport.csproj" />

Para generar Excel, agrega además el renderer de Excel:

<ProjectReference Include="src/FluentReport.Excel/FluentReport.Excel.csproj" />

Uso rápido

using FluentReport;
using FluentReport.Core;

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.MarginAll(40);

        page.Header()
            .Text("Mi Reporte")
            .FontSize(20)
            .Bold()
            .AlignCenter();

        page.Content().Column(col =>
        {
            col.Spacing(8);

            col.Item().Text("Introducción").FontSize(14).Bold();
            col.Item().Text("Este es el contenido del reporte.");
            col.Item().Line(1);

            col.Item().Table(table =>
            {
                table.ColumnsDefinition(cols =>
                {
                    cols.RelativeColumn(1);
                    cols.RelativeColumn(2);
                    cols.ConstantColumn(80);
                });

                table.Header(h =>
                {
                    h.Cell().Background("#CCCCCC").Padding(5).Text("Nombre").Bold();
                    h.Cell().Background("#CCCCCC").Padding(5).Text("Descripción").Bold();
                    h.Cell().Background("#CCCCCC").Padding(5).Text("Valor").Bold();
                });

                table.Cell().Padding(5).Text("Producto A");
                table.Cell().Padding(5).Text("Descripción del producto A");
                table.Cell().Padding(5).Text("$100");

                table.Cell().Padding(5).Text("Producto B");
                table.Cell().Padding(5).Text("Descripción del producto B");
                table.Cell().Padding(5).Text("$200");
            });
        });

        page.Footer().AlignCenter().Text(x =>
        {
            x.Span("Página ");
            x.CurrentPageNumber();
            x.Span(" de ");
            x.TotalPages();
        });
    });
})
.GeneratePdf("reporte.pdf");

Excel – Uso rápido

Agrega using FluentReport.Excel; y usa el mismo fluent API con GenerateExcel:

using FluentReport;
using FluentReport.Core;
using FluentReport.Excel;

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.MarginAll(40);

        page.Header()
            .Text("Mi Reporte Excel")
            .FontSize(20)
            .Bold()
            .AlignCenter();

        page.Content().Column(col =>
        {
            col.Spacing(8);

            col.Item().Text("Resumen de Ventas").FontSize(14).Bold();

            col.Item().Table(table =>
            {
                table.ColumnsDefinition(cols =>
                {
                    cols.RelativeColumn(2);
                    cols.RelativeColumn(1);
                    cols.RelativeColumn(1);
                });

                table.Header(h =>
                {
                    h.Cell().Background("#4472C4").Padding(4).Text("Región").Bold().Color("#FFFFFF");
                    h.Cell().Background("#4472C4").Padding(4).Text("Unidades").Bold().Color("#FFFFFF");
                    h.Cell().Background("#4472C4").Padding(4).Text("Ingresos").Bold().Color("#FFFFFF");
                });
                table.BorderEachCell(1);

                table.Cell().Padding(4).Text("Norte");
                table.Cell().Padding(4).Text("1 200");
                table.Cell().Padding(4).Text("$48 000");
            });
        });
    });
})
.GenerateExcel("reporte.xlsx");

Comportamiento del renderer Excel

API Reference

Document

PageBuilder

ContainerBuilder

TextBuilder

ColumnBuilder

RowBuilder

TableBuilder

TableColumnDefinitionBuilder

DynamicTextBuilder (para pie de página)

Tamaños de página predefinidos

Estructura del proyecto

src/
├── FluentReport/               # Librería principal (PDF)
│   ├── Document.cs             # Punto de entrada
│   ├── Core/                   # Tipos base (Size, Position, Rect, PageSize...)
│   ├── Styling/                # Estilos (TextStyle, BorderStyle, Color)
│   ├── Elements/               # Elementos renderizables
│   ├── Builders/               # Fluent API builders
│   └── Rendering/              # Motor de renderizado con SkiaSharp
└── FluentReport.Excel/         # Renderer Excel (opcional)
    ├── ExcelDocumentRenderer.cs # Motor de renderizado Excel con ClosedXML
    └── DocumentExcelExtensions.cs # Métodos de extensión GenerateExcel
tests/
├── FluentReport.Tests/         # Tests PDF con xUnit (19 tests)
└── FluentReport.Excel.Tests/   # Tests Excel con xUnit (12 tests)
samples/
└── FluentReport.Samples/       # Samples PDF (01-06) y Excel (07-09)

Dependencias

• SkiaSharp 3.116.1 — renderizado PDF
• SkiaSharp.NativeAssets.Linux.NoDependencies — soporte Linux sin libfontconfig
• ClosedXML 0.102.2 — renderizado Excel (solo FluentReport.Excel)