apple/swift-nio

NIOLoopBound should get `unchecked` variants that are truly free in release mode

Open

#2.506 geöffnet am 17. Aug. 2023

Auf GitHub ansehen
 (5 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)Swift (749 Forks)batch import
good first issuekind/enhancement

Repository-Metriken

Stars
 (8.453 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 8T 5h) (18 gemergte PRs in 30 T)

Beschreibung

NIOLoopBound(Box) is super useful when adopting Sendable but the eventLoop.preconditionInEventLoop() checks everywhere are expensive and -- for repeated accesses -- unnecessary.

There should be unchecked variants of init, get and set value that do eventLoop.assertInEventLoop() instead. Together with @inlinable that should become completely free in release mode (and still check in debug).

Docs:

Contributor Guide

Research-Richtung
Die Implementierung sollte neue Initialisierer und Methoden für `NIOLoopBound` und `NIOLoopBoundBox` im NIO Modul hinzufügen. Das Issue schlägt vor, in den ungeprüften Varianten `assertInEventLoop` anstelle von `preconditionInEventLoop` zu verwenden und sie mit `@inlinable` für die Optimierung im Release Modus zu markieren. Mitwirkende sollten die vorhandene Implementierung unter den bereitgestellten Dokumentationslinks überprüfen und mögliche Thread Sicherheitsimplikationen berücksichtigen.
Tech Stack
swift
Domain
backendperformance
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Veraltet
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Swift concurrencyNIOLoopBound APIassert vs precondition
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
60