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
| Clase | Qué 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. |
SerialQueue | Enqueue 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, QueuedHostedService | Cola 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ón | Qué 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 familia | A DateTime, DateOnly o TimeOnly, con variantes _Nullable y de zona horaria. |
ToSQL, ToSQL_Date, ToSQL_Decimal | Literales SQL para concatenar en sentencias, no parámetros. Con valores que llegan del usuario, usa consultas parametrizadas. |
ToSHA1 | Hash hexadecimal de bytes, texto o stream: Dinaup.extensions.ToSHA1(bytes). |
12.5m.STR() // "12.5"
Guid.Empty.STR() // ""
"abc".INT(99) // 99
"si".BOOL() // trueFormateadores
| Módulo | Qué hace |
|---|---|
FormatHelpers.FormatDate(fecha) y FormatRelativeTime(fechaUtc) | Fecha corta y tiempo relativo (hace 3 min). |
FormatHelpers.FormatDurationFromSeconds(segundos), FormatMillisecondsReadable, FormatSeconds, FormatMinutesReadable | Duraciones cortas legibles. Las variantes Html y Html20 devuelven marcado. |
FormatHelpers.FormatHoursReadable, FormatDaysReadable, FormatMonthsReadable, FormatYearsReadable | Duraciones 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
| Familia | Métodos |
|---|---|
| Vacío y nulos | IsEmpty(), 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 texto | IsEmail(), IsGUID(), IsNumeric(), IsInteger(), IsJson(), IsDateOnly(), ContainsWord(), ContainsIgnoreCase(), EqualsIgnoreCase(), StartsWithIgnoreCase(), EndsWithIgnoreCase(), y búsqueda por palabras con MatchAllWords(), MatchPercentage() y ContainsWebSearchMode(). |
LikeM | estado.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. |
| Guardas | ThrowIf_IsNull(), ThrowIf_IsEmpty(), ThrowIf_IsNotGuid(), ThrowIf_IsNotEmail(), ThrowIf_IsNotUrl(), ThrowIf_IsZero(), ThrowIf_HasUpperCase(): lanzan una excepción descriptiva. email.ThrowIf_IsNotEmail(nameof(email)). |
| Colecciones | GetM(clave) y GetM(clave, defecto) leen un diccionario sin lanzar si la clave no está. HasElements(), GetRandom(), MoveItemUp(), MoveItemDown() y AddRange() sobre HashSet. |
| Texto | RemoveAccents(), RemoveSpecialCharacters(), UppercaseFirst(), ParseBetween(inicio, fin), Trim_PN() (Trim que tolera nulos), FormatJson(). |
| Numéricas | Between(min, max), IsMultipleOf(), RoundMoney(decimales), Half(), HasDecimalPlaces(). |
Las extensiones de petición HTTP (GetUserIP, ReadGet) están en ASP.NET Core.