Aperçu de l’API
classe DisplayNameFuncError
classe OpCallError
classe OpKwargs
TypedDict pour les arguments nommés de op().
classe Sentinel
Sentinel(package: ‘str’, path: ‘str’, name: ‘str’)
méthode __init__
classe WeaveKwargs
fonction as_op
À partir d’une fonction décorée avec @weave.op, renvoie son Op.
Les fonctions décorées avec @weave.op sont déjà des instances d’Op ; cette fonction n’a donc aucun effet à l’exécution. Vous pouvez toutefois l’utiliser pour satisfaire les vérificateurs de types si vous devez accéder aux attributs d’OpDef de façon typée et sûre.
Arguments :
fn : une fonction décorée avec weave.op.
Renvoie :
L’Op de la fonction.
fonction call
Exécute l’op et renvoie à la fois le résultat et un objet Call représentant l’exécution.
Cette fonction ne lève jamais d’exception. Toutes les erreurs sont capturées dans l’objet Call.
Cette méthode est automatiquement liée à toute fonction décorée avec @weave.op, ce qui permet de l’utiliser comme suit :
fonction calls
Obtenir un itérateur sur tous les appels de cet op.
Cette méthode est automatiquement liée à toute fonction décorée avec @weave.op, ce qui permet par exemple d’écrire :
fonction get_captured_code
Obtenir le code capturé de l’op.
Cela ne fonctionne que si l’op a été obtenu à partir d’une réf. Le schéma est le suivant :
ref = weave.publish(func) op = ref.get() captured_code = op.get_captured_code()
fonction is_op
Vérifier si un objet est un op.
fonction is_placeholder_call
fonction is_tracing_setting_disabled
fonction maybe_bind_method
Lie une fonction à n’importe quel objet (même s’il ne s’agit pas d’une classe).
Si self vaut None, renvoie la fonction telle quelle.
fonction maybe_unbind_method
Délie une méthode ou une fonction partielle de type Op pour la convertir en simple fonction Op.
Pour :
- les méthodes, supprime le paramètre
self lié ;
- les fonctions partielles, supprime tous les paramètres prédéfinis.
fonction op
Décorateur permettant de transformer une fonction ou une méthode en op Weave. Fonctionne aussi bien en mode synchrone qu’asynchrone. Détecte automatiquement les fonctions itératrices et applique le comportement approprié.
Arguments :
fonction placeholder_call
fonction setup_dunder_weave_dict
Configure un dictionnaire __weave utilisé pour transmettre les WeaveKwargs aux ops.
-
func : fonction à décorer.
-
name : nom personnalisé de l’op. Par défaut, le nom de la fonction.
-
call_display_name : nom d’affichage des appels, sous forme de string ou de callable.
-
postprocess_inputs : fonction permettant de transformer les entrées avant la journalisation.
-
postprocess_output : fonction permettant de transformer la sortie avant la journalisation.
-
tracing_sample_rate : fraction des appels à tracer (de 0.0 à 1.0).
-
enable_code_capture : indique s’il faut capturer le code source de cet op.
-
accumulator : fonction permettant d’accumuler les résultats des ops en streaming.
-
attributes : attributs par défaut fusionnés dans chaque appel créé par cet op, avec la priorité la plus basse. Un contexte weave.attributes() et des attributs par appel explicites les redéfinissent en cas de conflit de clé. La clé réservée « weave » ne peut pas être définie ici.
-
eager_call_start : si True, les débuts d’appel sont envoyés immédiatement au lieu d’être regroupés par lots. Utile pour les opérations de longue durée, comme les évaluations, qui doivent apparaître immédiatement dans l’interface utilisateur.
Arguments :
-
d : dictionnaire WeaveKwargs existant à mettre à jour (facultatif).
-
op : op dont extraire le type (kind) et la couleur.
Renvoie :
Un dictionnaire WeaveKwargs dans lequel sont définis les attributs, display_name et, le cas échéant, kind/color.
fonction should_skip_tracing_for_op
Dernière modification le 30 septembre 2026
