> ## Documentation Index > Fetch the complete documentation index at: https://wb-21fd5541-serverless-sft-revamp.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # util > weave.trace.util の Python SDK リファレンス export const SourceLink = ({url}) => Source ; # API 概要 *** ## class `ContextAwareThread` 呼び出し元のコンテキストで関数を実行するスレッドです。これは `threading.Thread` のドロップインリプレイスメントであり、スレッド内での呼び出しが期待通りに動作することを保証します。 Weave は特定の `contextvars` が設定されている必要があります（`call_context.py` を参照）が、新しいスレッドは親からコンテキストを自動的にコピーしないため、コールコンテキストが失われる可能性があります。これは好ましくありません。このクラスは `contextvar` のコピーを自動化し、このスレッドを使用することでユーザーが期待する通りに「ただ動作する」ようにします。このクラスを使わずに、代わりに以下のように記述することでも同様の効果を得ることができます。 ```python theme={null} def run_with_context(func, *args, **kwargs): context = copy_context() def wrapper(): context.run(func, *args, **kwargs) return wrapper thread = threading.Thread(target=run_with_context(your_func, *args, **kwargs)) thread.start() ``` ### method `__init__` ```python theme={null} __init__(*args: 'Any', **kwargs: 'Any') → None ``` *** #### property daemon このスレッドがデーモンスレッドであるかどうかを示すブール値です。これは `start()` が呼び出される前に設定する必要があり、そうでない場合は `RuntimeError` が発生します。初期値は作成元のスレッドから継承されます。メインスレッドはデーモンスレッドではないため、メインスレッドで作成されたすべてのスレッドのデフォルトは `daemon = False` になります。デーモンスレッドのみが残った時点で、Python プログラム全体が終了します。 *** #### property ident このスレッドのスレッド識別子、または開始されていない場合は `None` です。これは 0 以外の整数です。 `get_ident()` 関数を参照してください。スレッド識別子は、スレッドが終了して別のスレッドが作成されたときに再利用されることがあります。識別子はスレッドが終了した後でも利用可能です。 *** #### property name 識別目的のみに使用される文字列です。セマンティクスはありません。複数のスレッドに同じ名前を付けることができます。初期名はコンストラクタによって設定されます。 *** #### property native\_id このスレッドのネイティブな整数スレッド ID、または開始されていない場合は `None` です。これは非負の整数です。 `get_native_id()` 関数を参照してください。これはカーネルによって報告されるスレッド ID を表します。 *** ### method `run` ```python theme={null} run() → None ``` *** ## class `ContextAwareThreadPoolExecutor` 呼び出し元のコンテキストで関数を実行する `ThreadPoolExecutor` です。これは `concurrent.futures.ThreadPoolExecutor` のドロップインリプレイスメントであり、エグゼキューター内での Weave の呼び出しが期待通りに動作することを保証します。 Weave は特定の `contextvars` が設定されている必要があります（`call_context.py` を参照）が、新しいスレッドは親からコンテキストを自動的にコピーしないため、コールコンテキストが失われる可能性があります。このクラスは `contextvar` のコピーを自動化し、このエグゼキューターを使用することでユーザーが期待する通りに「ただ動作する」ようにします。このクラスを使わずに、代わりに以下のように記述することでも同様の効果を得ることができます。 ```python theme={null} with concurrent.futures.ThreadPoolExecutor() as executor: contexts = [copy_context() for _ in range(len(vals))] def _wrapped_fn(*args): return contexts.pop().run(fn, *args) executor.map(_wrapped_fn, vals) ``` ### method `__init__` ```python theme={null} __init__(*args: 'Any', **kwargs: 'Any') → None ``` *** ### method `map` ```python theme={null} map( fn: 'Callable', *iterables: 'Iterable[Any]', timeout: 'float | None' = None, chunksize: 'int' = 1 ) → Iterator ``` *** ### method `submit` ```python theme={null} submit(fn: 'Callable', *args: 'Any', **kwargs: 'Any') → Any ``` *** ## class `ContextAwareThread` 呼び出し元のコンテキストで関数を実行するスレッドです。これは `threading.Thread` のドロップインリプレイスメントであり、スレッド内での呼び出しが期待通りに動作することを保証します。 Weave は特定の `contextvars` が設定されている必要があります（`call_context.py` を参照）が、新しいスレッドは親からコンテキストを自動的にコピーしないため、コールコンテキストが失われる可能性があります。このクラスは `contextvar` のコピーを自動化し、このスレッドを使用することでユーザーが期待する通りに「ただ動作する」ようにします。このクラスを使わずに、代わりに以下のように記述することでも同様の効果を得ることができます。 ```python theme={null} def run_with_context(func, *args, **kwargs): context = copy_context() def wrapper(): context.run(func, *args, **kwargs) return wrapper thread = threading.Thread(target=run_with_context(your_func, *args, **kwargs)) thread.start() ``` ### method `__init__` ```python theme={null} __init__(*args: 'Any', **kwargs: 'Any') → None ``` *** #### property daemon このスレッドがデーモンスレッドであるかどうかを示すブール値です。これは `start()` が呼び出される前に設定する必要があり、そうでない場合は `RuntimeError` が発生します。初期値は作成元のスレッドから継承されます。メインスレッドはデーモンスレッドではないため、メインスレッドで作成されたすべてのスレッドのデフォルトは `daemon = False` になります。デーモンスレッドのみが残った時点で、Python プログラム全体が終了します。 *** #### property ident このスレッドのスレッド識別子、または開始されていない場合は `None` です。これは 0 以外の整数です。 `get_ident()` 関数を参照してください。スレッド識別子は、スレッドが終了して別のスレッドが作成されたときに再利用されることがあります。識別子はスレッドが終了した後でも利用可能です。 *** #### property name 識別目的のみに使用される文字列です。セマンティクスはありません。複数のスレッドに同じ名前を付けることができます。初期名はコンストラクタによって設定されます。 *** #### property native\_id このスレッドのネイティブな整数スレッド ID、または開始されていない場合は `None` です。これは非負の整数です。 `get_native_id()` 関数を参照してください。これはカーネルによって報告されるスレッド ID を表します。 *** ### method `run` ```python theme={null} run() → None ``` *** ## class `ContextAwareThreadPoolExecutor` 呼び出し元のコンテキストで関数を実行する `ThreadPoolExecutor` です。これは `concurrent.futures.ThreadPoolExecutor` のドロップインリプレイスメントであり、エグゼキューター内での Weave の呼び出しが期待通りに動作することを保証します。 Weave は特定の `contextvars` が設定されている必要があります（`call_context.py` を参照）が、新しいスレッドは親からコンテキストを自動的にコピーしないため、コールコンテキストが失われる可能性があります。このクラスは `contextvar` のコピーを自動化し、このエグゼキューターを使用することでユーザーが期待する通りに「ただ動作する」ようにします。このクラスを使わずに、代わりに以下のように記述することでも同様の効果を得ることができます。 ```python theme={null} with concurrent.futures.ThreadPoolExecutor() as executor: contexts = [copy_context() for _ in range(len(vals))] def _wrapped_fn(*args): return contexts.pop().run(fn, *args) executor.map(_wrapped_fn, vals) ``` ### method `__init__` ```python theme={null} __init__(*args: 'Any', **kwargs: 'Any') → None ``` *** ### method `map` ```python theme={null} map( fn: 'Callable', *iterables: 'Iterable[Any]', timeout: 'float | None' = None, chunksize: 'int' = 1 ) → Iterator ``` *** ### method `submit` ```python theme={null} submit(fn: 'Callable', *args: 'Any', **kwargs: 'Any') → Any ``` *** ### function `deprecated` ```python theme={null} deprecated(new_name: 'str') → Callable[[Callable[, Any]], Callable[, Any]] ``` 関数を非推奨としてマークし、ユーザーを `new_name` にリダイレクトするためのデコレータです。 *** ### function `is_colab` ```python theme={null} is_colab() ``` *** ### function `is_notebook` ```python theme={null} is_notebook() → bool ``` *** ### function `log_once` ```python theme={null} log_once(log_method: 'Callable[[str], None]', message: 'str') → None ``` メッセージを一度だけログに記録し、同じタイプの後続のメッセージを抑制します。これは、ログを大量に発生させることなく、エラーについてユーザーに通知するのに便利です。これは主に、同じエラーメッセージが何度も発生する可能性がある場合に役立ちます。例えば、op の保存に失敗した場合、その op が呼び出されるたびに発生する可能性が高いです。また、パッチを適用したイテレータにエラーがある場合、結果を反復処理するたびに発生する可能性があります。これにより、ログを詰まらせることなく、エラーについてユーザーに情報を提供できます。 **引数:** * `log_method`: メッセージのログ記録に使用するメソッド。これは文字列の引数を受け取る必要があります。 * `message`: ログ記録するメッセージ。 **例:** ```python theme={null} log_once(logger.error, "Failed to save op") ```