Skip to Content

Utilidades

Debouncer, ExpirableValue, RateLimiter, TokenBucket, SlidingCounter, SerialQueue, colas en segundo plano, conversiones STR, INT y ToSQL, formateadores y extensiones.

El paquete Dinaup trae primitivas de concurrencia y limitación, conversiones, formateadores y cientos de métodos de extensión, todo en el namespace Dinaup. Para tenerlas en todos los ficheros, añade <Using Include="Dinaup.extensions" Static="true" /> al .csproj.

Concurrencia y limitación

ClaseQué hace
Debouncer(accion, ms)Debounce() retrasa la acción y cancela la anterior si llega otra dentro de la ventana. Implementa IDisposable.
ExpirableValue<T>, ExpirableValueAsync<T>Un valor con tiempo de vida (expirationInSeconds): al leerlo caducado, llama a la función de refresco. Se crean con una función o con un valor inicial; SetValue reinicia la caducidad.
RateLimiter(maxAttempts, clearInterval)TryAttempt(key) cuenta intentos por clave y devuelve false al pasar del máximo. Se reinicia al vencer clearInterval; NextClear dice cuándo.
TokenBucket(maxTokens, refillPerSecond)TryConsume(count = 1) devuelve true si quedan tokens.
SlidingCounter(maxEvents, window)TryAdd() devuelve true mientras los eventos de la ventana no pasen del máximo.
SerialQueueEnqueue ejecuta las tareas de una en una, en orden, y devuelve un Task que completa al terminar. Admite Action, Func<T>, Func<Task>, Func<Task<T>> y Action con CancellationToken.
IBackgroundTaskQueue, QueuedHostedServiceCola de trabajo en segundo plano: Enqueue(task, description), DequeueAsync(cancellationToken), Count() y ResumenCola() (pendientes por descripción). QueuedHostedService la consume.
Suscribible<T>Un valor que ejecuta una acción cada vez que cambia: new Suscribible<int>(0, s => Console.WriteLine(s.Value)).
var token = new ExpirableValueAsync<string>(async () => await PedirTokenAsync(), 60);
string actual = await token.GetValueAsync();

var limiter = new RateLimiter(maxAttempts: 5, clearInterval: TimeSpan.FromMinutes(1));
if (limiter.TryAttempt(userEmail) == false)
    throw new Exception("Demasiados intentos, prueba en un minuto.");

builder.Services.AddSingleton<IBackgroundTaskQueue, BackgroundTaskQueue>();
builder.Services.AddHostedService<QueuedHostedService>();
queue.Enqueue(async ct => await ProcesarPedidoAsync(pedidoId, ct), "procesar-pedido");

Conversiones

Las conversiones no leen la cultura del hilo: escriben y leen el decimal con punto, el formato que espera Dinaup.

ExtensiónQué hace
.STR()A texto: decimal con punto y sin ceros sobrantes, Guid.Empty y nulos a "", bool a "1" o "0", DateTime a yyyy-MM-dd HH:mm:ss, DateOnly a yyyy-MM-dd. estado.STR(LenguajeE.Spanish) traduce un enum con MultiLanguageDescriptionAttribute.
.INT(), .INT(defecto), .INT(min, max, siFalla)A int. Sin valor por defecto, lanza si no es un número.
.DEC(), .DEC(defecto)A decimal con punto decimal; quita € y $. Sin valor por defecto, lanza Exception("Invalid cast"). Acepta una CultureInfo.
.BOOL()"1", "si", "sí", "on", "yes" y "true" son true, sin distinguir mayúsculas; el resto, false.
ToDate, ToDateOnly y familiaA DateTime, DateOnly o TimeOnly, con variantes _Nullable y de zona horaria.
ToSQL, ToSQL_Date, ToSQL_DecimalLiterales SQL para concatenar en sentencias, no parámetros. Con valores que llegan del usuario, usa consultas parametrizadas.
ToSHA1Hash hexadecimal de bytes, texto o stream: Dinaup.extensions.ToSHA1(bytes).
12.5m.STR()        // "12.5"
Guid.Empty.STR()   // ""
"abc".INT(99)      // 99
"si".BOOL()        // true

Formateadores

MóduloQué hace
FormatHelpers.FormatDate(fecha) y FormatRelativeTime(fechaUtc)Fecha corta y tiempo relativo (hace 3 min).
FormatHelpers.FormatDurationFromSeconds(segundos), FormatMillisecondsReadable, FormatSeconds, FormatMinutesReadableDuraciones cortas legibles. Las variantes Html y Html20 devuelven marcado.
FormatHelpers.FormatHoursReadable, FormatDaysReadable, FormatMonthsReadable, FormatYearsReadableDuraciones largas legibles.
FormatHelpers.FormatSizeBytes(bytes), FormatSizeMegabytes, FormatSizeGigabytes, FormatGrams(gramos)Tamaños y pesos con su unidad.
FormatHelpers.FormatByRolePn(role, valor)Un valor según el rol del campo Dinaup (RoleFieldE): moneda, porcentaje, peso.
FormatHelpers.TryParseMagicDateTime(texto, ref fecha)Interpreta fechas escritas de varias formas.
TimeZoneHelper.GetTimeZone(zoneId), ToUtcTime(fechaLocal, zoneId), ToLocalTime_PN(fechaUtc, zoneId), GetLocalDateTime(zoneId), GetLocalDateOnly(zoneId)Conversión entre UTC y una zona IANA o Windows.
Utilities.Pricing.CalculatePrice(quantity, unitPrice, fixedDiscount, percentDiscount, hasTaxesIncluded, taxPercent) y ApplyDiscounts(price, fixedDiscount, percentDiscount)Precio de línea con descuentos e impuestos incluidos o no. Devuelve un CalculatedPrice.
Utilities.MentionParser.GetAllMentions(html)Los GUIDs mencionados en un comentario HTML.

Para formatear con la cultura y la zona del usuario en una app web, usa CultureService.

Extensiones

FamiliaMétodos
Vacío y nulosIsEmpty(), IsNotEmpty(), HasContent() sobre string, colecciones, Dictionary, Guid, fechas anulables, DinaupBasicInformation e IDinaupRow (Id vacío). IsNull(), IsNotNull() y NotEmpty() solo miran la referencia. OrEmpty() da una secuencia vacía si el origen es null. IfIsEmpty(valor) pone un valor a números y fechas vacíos. IsEmpty() no existe para int ni decimal: compara con 0.
Predicados de textoIsEmail(), IsGUID(), IsNumeric(), IsInteger(), IsJson(), IsDateOnly(), ContainsWord(), ContainsIgnoreCase(), EqualsIgnoreCase(), StartsWithIgnoreCase(), EndsWithIgnoreCase(), y búsqueda por palabras con MatchAllWords(), MatchPercentage() y ContainsWebSearchMode().
LikeMestado.LikeM(1, 2, 5): si el valor es igual a alguno. Para int, decimal, Guid, char y string (distingue mayúsculas); LikeMIgnoreCase no las distingue.
GuardasThrowIf_IsNull(), ThrowIf_IsEmpty(), ThrowIf_IsNotGuid(), ThrowIf_IsNotEmail(), ThrowIf_IsNotUrl(), ThrowIf_IsZero(), ThrowIf_HasUpperCase(): lanzan una excepción descriptiva. email.ThrowIf_IsNotEmail(nameof(email)).
ColeccionesGetM(clave) y GetM(clave, defecto) leen un diccionario sin lanzar si la clave no está. HasElements(), GetRandom(), MoveItemUp(), MoveItemDown() y AddRange() sobre HashSet.
TextoRemoveAccents(), RemoveSpecialCharacters(), UppercaseFirst(), ParseBetween(inicio, fin), Trim_PN() (Trim que tolera nulos), FormatJson().
NuméricasBetween(min, max), IsMultipleOf(), RoundMoney(decimales), Half(), HasDecimalPlaces().

Las extensiones de petición HTTP (GetUserIP, ReadGet) están en ASP.NET Core.

En esta página