wandb 0.22.1__py3-none-musllinux_1_2_x86_64.whl → 0.22.2__py3-none-musllinux_1_2_x86_64.whl

wandb/__init__.py

@@ -10,7 +10,7 @@ For reference documentation, see https://docs.wandb.com/ref/python.
 """
 from __future__ import annotations
 
-__version__ = "0.22.1"
+__version__ = "0.22.2"
 
 
 from wandb.errors import Error

wandb/__init__.pyi

@@ -107,7 +107,7 @@ if TYPE_CHECKING:
     import wandb
     from wandb.plot import CustomChart
 
-__version__: str = "0.22.1"
+__version__: str = "0.22.2"
 
 run: Run | None
 config: wandb_config.Config
@@ -754,6 +754,9 @@ def save(
     When given an absolute path or glob and no `base_path`, one
     directory level is preserved as in the example above.
 
+    Files are automatically deduplicated: calling `save()` multiple times
+    on the same file without modifications will not re-upload it.
+
     Args:
         glob_str: A relative or absolute path or Unix glob.
         base_path: A path to use to infer a directory structure; see examples.
@@ -778,10 +781,10 @@ def save(
     run.save("these/are/myfiles/*", base_path="these")
     # => Saves files in an "are/myfiles/" folder in the run.
 
-    run.save("/User/username/Documents/run123/*.txt")
+    run.save("/Users/username/Documents/run123/*.txt")
     # => Saves files in a "run123/" folder in the run. See note below.
 
-    run.save("/User/username/Documents/run123/*.txt", base_path="/User")
+    run.save("/Users/username/Documents/run123/*.txt", base_path="/Users")
     # => Saves files in a "username/Documents/run123/" folder in the run.
 
     run.save("files/*/saveme.txt")

wandb/cli/beta.py

@@ -15,8 +15,7 @@ from wandb.util import get_core_path
 
 @click.group()
 def beta():
-    """Beta versions of wandb CLI commands. Requires wandb-core."""
-    # this is the future that requires wandb-core!
+    """Beta versions of wandb CLI commands."""
     import wandb.env
 
     wandb._sentry.configure_scope(process_context="wandb_beta")
@@ -32,6 +31,21 @@ def beta():
         )
 
 
+@beta.command()
+@click.argument("path", nargs=1, type=click.Path(exists=True), required=False)
+def leet(path: str | None = None) -> None:
+    """Launch W&B LEET: the Lightweight Experiment Exploration Tool.
+
+    LEET is a terminal UI for viewing a W&B run specified by an optional PATH.
+
+    PATH can include a .wandb file or a run directory containing a .wandb file.
+    If PATH is not provided, the command will look for the latest run.
+    """
+    from . import beta_leet
+
+    beta_leet.launch(path)
+
+
 @beta.command()
 @click.argument("paths", type=click.Path(exists=True), nargs=-1)
 @click.option(

wandb/cli/beta_leet.py

@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+import os
+import pathlib
+import subprocess
+import sys
+
+import click
+from typing_extensions import Never
+
+import wandb
+from wandb.env import error_reporting_enabled, is_debug
+from wandb.sdk import wandb_setup
+from wandb.util import get_core_path
+
+from .beta_sync import _find_wandb_files
+
+
+def _fatal(message: str) -> Never:
+    """Print an error message and exit with code 1."""
+    click.echo(f"Error: {message}", err=True)
+    sys.exit(1)
+
+
+def _wandb_file_path(path: str | None) -> str:
+    """Returns absolute path to the .wandb file to display with LEET.
+
+    If `path` is not provided, looks for the latest W&B run.
+
+    Prints an error and exits if a valid path is not found.
+    """
+    if not path:
+        wandb_dir = wandb_setup.singleton().settings.wandb_dir
+
+        wandb_run_path = (pathlib.Path(wandb_dir) / "latest-run").resolve()
+    else:
+        wandb_run_path = pathlib.Path(path).resolve()
+
+    wandb_files = list(_find_wandb_files(wandb_run_path, skip_synced=False))
+
+    if len(wandb_files) == 0:
+        _fatal(f"Could not find a .wandb file in {wandb_run_path}.")
+    elif len(wandb_files) > 1:
+        _fatal(f"Found multiple .wandb files in {wandb_run_path}.")
+
+    return wandb_files[0]
+
+
+def launch(path: str | None) -> Never:
+    wandb._sentry.configure_scope(process_context="leet")
+
+    wandb_file = _wandb_file_path(path)
+
+    try:
+        core_path = get_core_path()
+
+        args = [core_path, "leet"]
+        args.append(wandb_file)
+
+        if not error_reporting_enabled():
+            args.append("--no-observability")
+
+        if is_debug(default="False"):
+            args.extend(["--log-level", "-4"])
+
+        result = subprocess.run(
+            args,
+            env=os.environ,
+            close_fds=True,
+        )
+        sys.exit(result.returncode)
+
+    except Exception as e:
+        wandb._sentry.reraise(e)

wandb/cli/cli.py

@@ -244,7 +244,7 @@ def projects(entity, display=True):
     return projects
 
 
-@cli.command(context_settings=CONTEXT, help="Login to Weights & Biases")
+@cli.command(context_settings=CONTEXT)
 @click.argument("key", nargs=-1)
 @click.option("--cloud", is_flag=True, help="Login to the cloud instead of local")
 @click.option(
@@ -262,6 +262,16 @@ def projects(entity, display=True):
 )
 @display_error
 def login(key, host, cloud, relogin, anonymously, verify, no_offline=False):
+    """Verify and store your API key for authentication with W&B services.
+
+    By default, only store credentials locally without verifying them with W&B.
+    To verify credentials, set `--verify=True`.
+
+    For server deployments (dedicated cloud or customer-managed instances),
+    specify the host URL using the `--host` flag. You can also set environment
+    variables `WANDB_BASE_URL` and `WANDB_API_KEY` instead of running
+    the `login` command with host parameters.
+    """
     # TODO: handle no_offline
     anon_mode = "must" if anonymously else "never"
 
@@ -422,9 +432,7 @@ def init(ctx, project, entity, reset, mode):
     )
 
 
-@cli.command(
-    context_settings=CONTEXT, help="Upload an offline training directory to W&B"
-)
+@cli.command(context_settings=CONTEXT)
 @click.pass_context
 @click.argument("path", nargs=-1, type=click.Path(exists=True))
 @click.option("--view", is_flag=True, default=False, help="View runs", hidden=True)
@@ -518,9 +526,23 @@ def sync(
     skip_console=None,
     replace_tags=None,
 ):
+    """Synchronize W&B run data to the cloud.
+
+    If PATH is provided, sync runs found at the given path. If a path
+    is not specified, search for `./wandb` first, then search for a
+    `wandb/` subdirectory.
+
+    To sync a specific run:
+
+        wandb sync ./wandb/run-20250813_124246-n67z9ude
+
+    Or equivalently:
+
+        wandb sync ./wandb/run-20250813_124246-n67z9ude/run-n67z9ude.wandb
+    """
     api = _get_cling_api()
     if not api.is_authenticated:
-        wandb.termlog("Login to W&B to sync offline runs")
+        wandb.termlog("Login to W&B to sync runs")
         ctx.invoke(login, no_offline=True)
         api = _get_cling_api(reset=True)
 
@@ -2700,9 +2722,10 @@ Run `git clone {repo}` and restore from there or pass the --no-git flag."""
     return commit, json_config, patch_content, repo, metadata
 
 
-@cli.command("online", help="Enable W&B sync")
+@cli.command("online")
 @display_error
 def online():
+    """Undo `wandb offline`."""
     api = InternalApi()
     try:
         api.clear_setting("mode", persist=True)
@@ -2713,9 +2736,13 @@ def online():
     )
 
 
-@cli.command("offline", help="Disable W&B sync")
+@cli.command("offline")
 @display_error
 def offline():
+    """Save data logged to W&B locally without uploading it to the cloud.
+
+    Use `wandb online` or `wandb sync` to upload offline runs.
+    """
     api = InternalApi()
     try:
         api.set_setting("mode", "offline", persist=True)

wandb/proto/v3/wandb_api_pb2.py

@@ -0,0 +1,86 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: wandb/proto/wandb_api.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from wandb.proto import wandb_base_pb2 as wandb_dot_proto_dot_wandb__base__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bwandb/proto/wandb_api.proto\x12\x0ewandb_internal\x1a\x1cwandb/proto/wandb_base.proto\"]\n\nApiRequest\x12\x44\n\x10read_run_history\x18\x01 \x01(\x0b\x32(.wandb_internal.ReadRunHistoryApiRequestH\x00\x42\t\n\x07request\"`\n\x0b\x41piResponse\x12\x45\n\x10read_run_history\x18\x01 \x01(\x0b\x32).wandb_internal.ReadRunHistoryApiResponseH\x00\x42\n\n\x08response\"\xaa\x01\n\x18ReadRunHistoryApiRequest\x12\x0e\n\x06\x65ntity\x18\x01 \x01(\t\x12\x0f\n\x07project\x18\x02 \x01(\t\x12\x0e\n\x06run_id\x18\x03 \x01(\t\x12\x0c\n\x04keys\x18\x04 \x03(\t\x12\x10\n\x08min_step\x18\x05 \x01(\x03\x12\x10\n\x08max_step\x18\x06 \x01(\x03\x12+\n\x05_info\x18\xc8\x01 \x01(\x0b\x32\x1b.wandb_internal._RecordInfo\"d\n\x19ReadRunHistoryApiResponse\x12\x30\n\x0chistory_rows\x18\x01 \x03(\x0b\x32\x1a.wandb_internal.HistoryRow\x12\x15\n\rerror_message\x18\x02 \x01(\t\"G\n\nHistoryRow\x12\x39\n\rhistory_items\x18\x01 \x03(\x0b\x32\".wandb_internal.ParquetHistoryItem\"5\n\x12ParquetHistoryItem\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x12\n\nvalue_json\x18\x10 \x01(\tB\x1bZ\x19\x63ore/pkg/service_go_protob\x06proto3')
+
+
+
+_APIREQUEST = DESCRIPTOR.message_types_by_name['ApiRequest']
+_APIRESPONSE = DESCRIPTOR.message_types_by_name['ApiResponse']
+_READRUNHISTORYAPIREQUEST = DESCRIPTOR.message_types_by_name['ReadRunHistoryApiRequest']
+_READRUNHISTORYAPIRESPONSE = DESCRIPTOR.message_types_by_name['ReadRunHistoryApiResponse']
+_HISTORYROW = DESCRIPTOR.message_types_by_name['HistoryRow']
+_PARQUETHISTORYITEM = DESCRIPTOR.message_types_by_name['ParquetHistoryItem']
+ApiRequest = _reflection.GeneratedProtocolMessageType('ApiRequest', (_message.Message,), {
+  'DESCRIPTOR' : _APIREQUEST,
+  '__module__' : 'wandb.proto.wandb_api_pb2'
+  # @@protoc_insertion_point(class_scope:wandb_internal.ApiRequest)
+  })
+_sym_db.RegisterMessage(ApiRequest)
+
+ApiResponse = _reflection.GeneratedProtocolMessageType('ApiResponse', (_message.Message,), {
+  'DESCRIPTOR' : _APIRESPONSE,
+  '__module__' : 'wandb.proto.wandb_api_pb2'
+  # @@protoc_insertion_point(class_scope:wandb_internal.ApiResponse)
+  })
+_sym_db.RegisterMessage(ApiResponse)
+
+ReadRunHistoryApiRequest = _reflection.GeneratedProtocolMessageType('ReadRunHistoryApiRequest', (_message.Message,), {
+  'DESCRIPTOR' : _READRUNHISTORYAPIREQUEST,
+  '__module__' : 'wandb.proto.wandb_api_pb2'
+  # @@protoc_insertion_point(class_scope:wandb_internal.ReadRunHistoryApiRequest)
+  })
+_sym_db.RegisterMessage(ReadRunHistoryApiRequest)
+
+ReadRunHistoryApiResponse = _reflection.GeneratedProtocolMessageType('ReadRunHistoryApiResponse', (_message.Message,), {
+  'DESCRIPTOR' : _READRUNHISTORYAPIRESPONSE,
+  '__module__' : 'wandb.proto.wandb_api_pb2'
+  # @@protoc_insertion_point(class_scope:wandb_internal.ReadRunHistoryApiResponse)
+  })
+_sym_db.RegisterMessage(ReadRunHistoryApiResponse)
+
+HistoryRow = _reflection.GeneratedProtocolMessageType('HistoryRow', (_message.Message,), {
+  'DESCRIPTOR' : _HISTORYROW,
+  '__module__' : 'wandb.proto.wandb_api_pb2'
+  # @@protoc_insertion_point(class_scope:wandb_internal.HistoryRow)
+  })
+_sym_db.RegisterMessage(HistoryRow)
+
+ParquetHistoryItem = _reflection.GeneratedProtocolMessageType('ParquetHistoryItem', (_message.Message,), {
+  'DESCRIPTOR' : _PARQUETHISTORYITEM,
+  '__module__' : 'wandb.proto.wandb_api_pb2'
+  # @@protoc_insertion_point(class_scope:wandb_internal.ParquetHistoryItem)
+  })
+_sym_db.RegisterMessage(ParquetHistoryItem)
+
+if _descriptor._USE_C_DESCRIPTORS == False:
+
+  DESCRIPTOR._options = None
+  DESCRIPTOR._serialized_options = b'Z\031core/pkg/service_go_proto'
+  _APIREQUEST._serialized_start=77
+  _APIREQUEST._serialized_end=170
+  _APIRESPONSE._serialized_start=172
+  _APIRESPONSE._serialized_end=268
+  _READRUNHISTORYAPIREQUEST._serialized_start=271
+  _READRUNHISTORYAPIREQUEST._serialized_end=441
+  _READRUNHISTORYAPIRESPONSE._serialized_start=443
+  _READRUNHISTORYAPIRESPONSE._serialized_end=543
+  _HISTORYROW._serialized_start=545
+  _HISTORYROW._serialized_end=616
+  _PARQUETHISTORYITEM._serialized_start=618
+  _PARQUETHISTORYITEM._serialized_end=671
+# @@protoc_insertion_point(module_scope)