wandb 0.17.0rc1__py3-none-macosx_10_9_x86_64.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (842) hide show
  1. package_readme.md +95 -0
  2. wandb/__init__.py +253 -0
  3. wandb/__main__.py +3 -0
  4. wandb/_globals.py +19 -0
  5. wandb/agents/__init__.py +0 -0
  6. wandb/agents/pyagent.py +364 -0
  7. wandb/analytics/__init__.py +3 -0
  8. wandb/analytics/sentry.py +266 -0
  9. wandb/apis/__init__.py +48 -0
  10. wandb/apis/attrs.py +40 -0
  11. wandb/apis/importers/__init__.py +1 -0
  12. wandb/apis/importers/internals/internal.py +386 -0
  13. wandb/apis/importers/internals/protocols.py +99 -0
  14. wandb/apis/importers/internals/util.py +78 -0
  15. wandb/apis/importers/mlflow.py +254 -0
  16. wandb/apis/importers/validation.py +108 -0
  17. wandb/apis/importers/wandb.py +1598 -0
  18. wandb/apis/internal.py +228 -0
  19. wandb/apis/normalize.py +89 -0
  20. wandb/apis/paginator.py +81 -0
  21. wandb/apis/public/__init__.py +34 -0
  22. wandb/apis/public/api.py +1045 -0
  23. wandb/apis/public/artifacts.py +851 -0
  24. wandb/apis/public/const.py +4 -0
  25. wandb/apis/public/files.py +195 -0
  26. wandb/apis/public/history.py +149 -0
  27. wandb/apis/public/jobs.py +634 -0
  28. wandb/apis/public/projects.py +162 -0
  29. wandb/apis/public/query_generator.py +166 -0
  30. wandb/apis/public/reports.py +469 -0
  31. wandb/apis/public/runs.py +803 -0
  32. wandb/apis/public/sweeps.py +240 -0
  33. wandb/apis/public/teams.py +198 -0
  34. wandb/apis/public/users.py +136 -0
  35. wandb/apis/reports/__init__.py +7 -0
  36. wandb/apis/reports/v1/__init__.py +30 -0
  37. wandb/apis/reports/v1/_blocks.py +1406 -0
  38. wandb/apis/reports/v1/_helpers.py +70 -0
  39. wandb/apis/reports/v1/_panels.py +1282 -0
  40. wandb/apis/reports/v1/_templates.py +478 -0
  41. wandb/apis/reports/v1/blocks.py +27 -0
  42. wandb/apis/reports/v1/helpers.py +2 -0
  43. wandb/apis/reports/v1/mutations.py +66 -0
  44. wandb/apis/reports/v1/panels.py +17 -0
  45. wandb/apis/reports/v1/report.py +268 -0
  46. wandb/apis/reports/v1/runset.py +144 -0
  47. wandb/apis/reports/v1/templates.py +7 -0
  48. wandb/apis/reports/v1/util.py +406 -0
  49. wandb/apis/reports/v1/validators.py +131 -0
  50. wandb/apis/reports/v2/__init__.py +20 -0
  51. wandb/apis/reports/v2/blocks.py +25 -0
  52. wandb/apis/reports/v2/expr_parsing.py +257 -0
  53. wandb/apis/reports/v2/gql.py +68 -0
  54. wandb/apis/reports/v2/interface.py +1911 -0
  55. wandb/apis/reports/v2/internal.py +867 -0
  56. wandb/apis/reports/v2/metrics.py +6 -0
  57. wandb/apis/reports/v2/panels.py +15 -0
  58. wandb/beta/workflows.py +283 -0
  59. wandb/bin/apple_gpu_stats +0 -0
  60. wandb/bin/wandb-core +0 -0
  61. wandb/catboost/__init__.py +9 -0
  62. wandb/cli/__init__.py +0 -0
  63. wandb/cli/cli.py +2890 -0
  64. wandb/data_types.py +2068 -0
  65. wandb/docker/__init__.py +342 -0
  66. wandb/docker/auth.py +436 -0
  67. wandb/docker/wandb-entrypoint.sh +33 -0
  68. wandb/docker/www_authenticate.py +94 -0
  69. wandb/env.py +496 -0
  70. wandb/errors/__init__.py +46 -0
  71. wandb/errors/term.py +95 -0
  72. wandb/errors/util.py +57 -0
  73. wandb/fastai/__init__.py +9 -0
  74. wandb/filesync/__init__.py +0 -0
  75. wandb/filesync/dir_watcher.py +403 -0
  76. wandb/filesync/stats.py +100 -0
  77. wandb/filesync/step_checksum.py +145 -0
  78. wandb/filesync/step_prepare.py +199 -0
  79. wandb/filesync/step_upload.py +392 -0
  80. wandb/filesync/upload_job.py +218 -0
  81. wandb/integration/__init__.py +0 -0
  82. wandb/integration/catboost/__init__.py +5 -0
  83. wandb/integration/catboost/catboost.py +178 -0
  84. wandb/integration/cohere/__init__.py +3 -0
  85. wandb/integration/cohere/cohere.py +21 -0
  86. wandb/integration/cohere/resolver.py +347 -0
  87. wandb/integration/diffusers/__init__.py +3 -0
  88. wandb/integration/diffusers/autologger.py +76 -0
  89. wandb/integration/diffusers/pipeline_resolver.py +50 -0
  90. wandb/integration/diffusers/resolvers/__init__.py +9 -0
  91. wandb/integration/diffusers/resolvers/multimodal.py +882 -0
  92. wandb/integration/diffusers/resolvers/utils.py +102 -0
  93. wandb/integration/fastai/__init__.py +249 -0
  94. wandb/integration/gym/__init__.py +85 -0
  95. wandb/integration/huggingface/__init__.py +3 -0
  96. wandb/integration/huggingface/huggingface.py +18 -0
  97. wandb/integration/huggingface/resolver.py +213 -0
  98. wandb/integration/keras/__init__.py +14 -0
  99. wandb/integration/keras/callbacks/__init__.py +5 -0
  100. wandb/integration/keras/callbacks/metrics_logger.py +130 -0
  101. wandb/integration/keras/callbacks/model_checkpoint.py +200 -0
  102. wandb/integration/keras/callbacks/tables_builder.py +226 -0
  103. wandb/integration/keras/keras.py +1080 -0
  104. wandb/integration/kfp/__init__.py +6 -0
  105. wandb/integration/kfp/helpers.py +28 -0
  106. wandb/integration/kfp/kfp_patch.py +324 -0
  107. wandb/integration/kfp/wandb_logging.py +182 -0
  108. wandb/integration/langchain/__init__.py +3 -0
  109. wandb/integration/langchain/wandb_tracer.py +48 -0
  110. wandb/integration/lightgbm/__init__.py +239 -0
  111. wandb/integration/lightning/__init__.py +0 -0
  112. wandb/integration/lightning/fabric/__init__.py +3 -0
  113. wandb/integration/lightning/fabric/logger.py +762 -0
  114. wandb/integration/magic.py +556 -0
  115. wandb/integration/metaflow/__init__.py +3 -0
  116. wandb/integration/metaflow/metaflow.py +383 -0
  117. wandb/integration/openai/__init__.py +3 -0
  118. wandb/integration/openai/fine_tuning.py +454 -0
  119. wandb/integration/openai/openai.py +22 -0
  120. wandb/integration/openai/resolver.py +240 -0
  121. wandb/integration/prodigy/__init__.py +3 -0
  122. wandb/integration/prodigy/prodigy.py +299 -0
  123. wandb/integration/sacred/__init__.py +117 -0
  124. wandb/integration/sagemaker/__init__.py +12 -0
  125. wandb/integration/sagemaker/auth.py +28 -0
  126. wandb/integration/sagemaker/config.py +49 -0
  127. wandb/integration/sagemaker/files.py +3 -0
  128. wandb/integration/sagemaker/resources.py +34 -0
  129. wandb/integration/sb3/__init__.py +3 -0
  130. wandb/integration/sb3/sb3.py +153 -0
  131. wandb/integration/tensorboard/__init__.py +10 -0
  132. wandb/integration/tensorboard/log.py +358 -0
  133. wandb/integration/tensorboard/monkeypatch.py +185 -0
  134. wandb/integration/tensorflow/__init__.py +5 -0
  135. wandb/integration/tensorflow/estimator_hook.py +54 -0
  136. wandb/integration/torch/__init__.py +0 -0
  137. wandb/integration/ultralytics/__init__.py +11 -0
  138. wandb/integration/ultralytics/bbox_utils.py +208 -0
  139. wandb/integration/ultralytics/callback.py +524 -0
  140. wandb/integration/ultralytics/classification_utils.py +83 -0
  141. wandb/integration/ultralytics/mask_utils.py +202 -0
  142. wandb/integration/ultralytics/pose_utils.py +104 -0
  143. wandb/integration/xgboost/__init__.py +11 -0
  144. wandb/integration/xgboost/xgboost.py +189 -0
  145. wandb/integration/yolov8/__init__.py +0 -0
  146. wandb/integration/yolov8/yolov8.py +284 -0
  147. wandb/jupyter.py +501 -0
  148. wandb/keras/__init__.py +19 -0
  149. wandb/lightgbm/__init__.py +9 -0
  150. wandb/magic.py +3 -0
  151. wandb/mpmain/__init__.py +0 -0
  152. wandb/mpmain/__main__.py +1 -0
  153. wandb/old/__init__.py +0 -0
  154. wandb/old/core.py +131 -0
  155. wandb/old/settings.py +173 -0
  156. wandb/old/summary.py +435 -0
  157. wandb/plot/__init__.py +19 -0
  158. wandb/plot/bar.py +42 -0
  159. wandb/plot/confusion_matrix.py +99 -0
  160. wandb/plot/histogram.py +36 -0
  161. wandb/plot/line.py +40 -0
  162. wandb/plot/line_series.py +88 -0
  163. wandb/plot/pr_curve.py +135 -0
  164. wandb/plot/roc_curve.py +117 -0
  165. wandb/plot/scatter.py +32 -0
  166. wandb/plots/__init__.py +6 -0
  167. wandb/plots/explain_text.py +36 -0
  168. wandb/plots/heatmap.py +81 -0
  169. wandb/plots/named_entity.py +43 -0
  170. wandb/plots/part_of_speech.py +50 -0
  171. wandb/plots/plot_definitions.py +768 -0
  172. wandb/plots/precision_recall.py +121 -0
  173. wandb/plots/roc.py +103 -0
  174. wandb/plots/utils.py +195 -0
  175. wandb/proto/__init__.py +0 -0
  176. wandb/proto/v3/__init__.py +0 -0
  177. wandb/proto/v3/wandb_base_pb2.py +54 -0
  178. wandb/proto/v3/wandb_internal_pb2.py +1586 -0
  179. wandb/proto/v3/wandb_server_pb2.py +207 -0
  180. wandb/proto/v3/wandb_settings_pb2.py +111 -0
  181. wandb/proto/v3/wandb_telemetry_pb2.py +105 -0
  182. wandb/proto/v4/__init__.py +0 -0
  183. wandb/proto/v4/wandb_base_pb2.py +29 -0
  184. wandb/proto/v4/wandb_internal_pb2.py +354 -0
  185. wandb/proto/v4/wandb_server_pb2.py +62 -0
  186. wandb/proto/v4/wandb_settings_pb2.py +44 -0
  187. wandb/proto/v4/wandb_telemetry_pb2.py +40 -0
  188. wandb/proto/wandb_base_pb2.py +8 -0
  189. wandb/proto/wandb_deprecated.py +37 -0
  190. wandb/proto/wandb_internal_codegen.py +83 -0
  191. wandb/proto/wandb_internal_pb2.py +8 -0
  192. wandb/proto/wandb_server_pb2.py +8 -0
  193. wandb/proto/wandb_settings_pb2.py +8 -0
  194. wandb/proto/wandb_telemetry_pb2.py +8 -0
  195. wandb/py.typed +0 -0
  196. wandb/sacred/__init__.py +3 -0
  197. wandb/sdk/__init__.py +37 -0
  198. wandb/sdk/artifacts/__init__.py +0 -0
  199. wandb/sdk/artifacts/artifact.py +2317 -0
  200. wandb/sdk/artifacts/artifact_download_logger.py +43 -0
  201. wandb/sdk/artifacts/artifact_file_cache.py +229 -0
  202. wandb/sdk/artifacts/artifact_instance_cache.py +15 -0
  203. wandb/sdk/artifacts/artifact_manifest.py +72 -0
  204. wandb/sdk/artifacts/artifact_manifest_entry.py +205 -0
  205. wandb/sdk/artifacts/artifact_manifests/__init__.py +0 -0
  206. wandb/sdk/artifacts/artifact_manifests/artifact_manifest_v1.py +90 -0
  207. wandb/sdk/artifacts/artifact_saver.py +270 -0
  208. wandb/sdk/artifacts/artifact_state.py +11 -0
  209. wandb/sdk/artifacts/artifact_ttl.py +7 -0
  210. wandb/sdk/artifacts/exceptions.py +56 -0
  211. wandb/sdk/artifacts/staging.py +25 -0
  212. wandb/sdk/artifacts/storage_handler.py +60 -0
  213. wandb/sdk/artifacts/storage_handlers/__init__.py +0 -0
  214. wandb/sdk/artifacts/storage_handlers/azure_handler.py +194 -0
  215. wandb/sdk/artifacts/storage_handlers/gcs_handler.py +195 -0
  216. wandb/sdk/artifacts/storage_handlers/http_handler.py +113 -0
  217. wandb/sdk/artifacts/storage_handlers/local_file_handler.py +135 -0
  218. wandb/sdk/artifacts/storage_handlers/multi_handler.py +54 -0
  219. wandb/sdk/artifacts/storage_handlers/s3_handler.py +300 -0
  220. wandb/sdk/artifacts/storage_handlers/tracking_handler.py +68 -0
  221. wandb/sdk/artifacts/storage_handlers/wb_artifact_handler.py +133 -0
  222. wandb/sdk/artifacts/storage_handlers/wb_local_artifact_handler.py +72 -0
  223. wandb/sdk/artifacts/storage_layout.py +6 -0
  224. wandb/sdk/artifacts/storage_policies/__init__.py +4 -0
  225. wandb/sdk/artifacts/storage_policies/register.py +1 -0
  226. wandb/sdk/artifacts/storage_policies/wandb_storage_policy.py +411 -0
  227. wandb/sdk/artifacts/storage_policy.py +83 -0
  228. wandb/sdk/backend/__init__.py +0 -0
  229. wandb/sdk/backend/backend.py +240 -0
  230. wandb/sdk/data_types/__init__.py +0 -0
  231. wandb/sdk/data_types/_dtypes.py +911 -0
  232. wandb/sdk/data_types/_private.py +10 -0
  233. wandb/sdk/data_types/base_types/__init__.py +0 -0
  234. wandb/sdk/data_types/base_types/json_metadata.py +55 -0
  235. wandb/sdk/data_types/base_types/media.py +313 -0
  236. wandb/sdk/data_types/base_types/wb_value.py +274 -0
  237. wandb/sdk/data_types/helper_types/__init__.py +0 -0
  238. wandb/sdk/data_types/helper_types/bounding_boxes_2d.py +293 -0
  239. wandb/sdk/data_types/helper_types/classes.py +159 -0
  240. wandb/sdk/data_types/helper_types/image_mask.py +233 -0
  241. wandb/sdk/data_types/histogram.py +96 -0
  242. wandb/sdk/data_types/html.py +115 -0
  243. wandb/sdk/data_types/image.py +687 -0
  244. wandb/sdk/data_types/molecule.py +241 -0
  245. wandb/sdk/data_types/object_3d.py +363 -0
  246. wandb/sdk/data_types/plotly.py +82 -0
  247. wandb/sdk/data_types/saved_model.py +444 -0
  248. wandb/sdk/data_types/trace_tree.py +438 -0
  249. wandb/sdk/data_types/utils.py +180 -0
  250. wandb/sdk/data_types/video.py +245 -0
  251. wandb/sdk/integration_utils/__init__.py +0 -0
  252. wandb/sdk/integration_utils/auto_logging.py +239 -0
  253. wandb/sdk/integration_utils/data_logging.py +475 -0
  254. wandb/sdk/interface/__init__.py +0 -0
  255. wandb/sdk/interface/constants.py +4 -0
  256. wandb/sdk/interface/interface.py +949 -0
  257. wandb/sdk/interface/interface_queue.py +59 -0
  258. wandb/sdk/interface/interface_relay.py +53 -0
  259. wandb/sdk/interface/interface_shared.py +550 -0
  260. wandb/sdk/interface/interface_sock.py +61 -0
  261. wandb/sdk/interface/message_future.py +27 -0
  262. wandb/sdk/interface/message_future_poll.py +50 -0
  263. wandb/sdk/interface/router.py +118 -0
  264. wandb/sdk/interface/router_queue.py +44 -0
  265. wandb/sdk/interface/router_relay.py +39 -0
  266. wandb/sdk/interface/router_sock.py +36 -0
  267. wandb/sdk/interface/summary_record.py +67 -0
  268. wandb/sdk/internal/__init__.py +0 -0
  269. wandb/sdk/internal/context.py +89 -0
  270. wandb/sdk/internal/datastore.py +297 -0
  271. wandb/sdk/internal/file_pusher.py +184 -0
  272. wandb/sdk/internal/file_stream.py +708 -0
  273. wandb/sdk/internal/flow_control.py +263 -0
  274. wandb/sdk/internal/handler.py +909 -0
  275. wandb/sdk/internal/internal.py +417 -0
  276. wandb/sdk/internal/internal_api.py +4202 -0
  277. wandb/sdk/internal/internal_util.py +100 -0
  278. wandb/sdk/internal/job_builder.py +554 -0
  279. wandb/sdk/internal/profiler.py +78 -0
  280. wandb/sdk/internal/progress.py +111 -0
  281. wandb/sdk/internal/run.py +25 -0
  282. wandb/sdk/internal/sample.py +70 -0
  283. wandb/sdk/internal/sender.py +1642 -0
  284. wandb/sdk/internal/sender_config.py +197 -0
  285. wandb/sdk/internal/settings_static.py +83 -0
  286. wandb/sdk/internal/system/__init__.py +0 -0
  287. wandb/sdk/internal/system/assets/__init__.py +27 -0
  288. wandb/sdk/internal/system/assets/aggregators.py +37 -0
  289. wandb/sdk/internal/system/assets/asset_registry.py +20 -0
  290. wandb/sdk/internal/system/assets/cpu.py +163 -0
  291. wandb/sdk/internal/system/assets/disk.py +210 -0
  292. wandb/sdk/internal/system/assets/gpu.py +414 -0
  293. wandb/sdk/internal/system/assets/gpu_amd.py +230 -0
  294. wandb/sdk/internal/system/assets/gpu_apple.py +177 -0
  295. wandb/sdk/internal/system/assets/interfaces.py +207 -0
  296. wandb/sdk/internal/system/assets/ipu.py +177 -0
  297. wandb/sdk/internal/system/assets/memory.py +166 -0
  298. wandb/sdk/internal/system/assets/network.py +125 -0
  299. wandb/sdk/internal/system/assets/open_metrics.py +299 -0
  300. wandb/sdk/internal/system/assets/tpu.py +154 -0
  301. wandb/sdk/internal/system/assets/trainium.py +398 -0
  302. wandb/sdk/internal/system/env_probe_helpers.py +13 -0
  303. wandb/sdk/internal/system/system_info.py +247 -0
  304. wandb/sdk/internal/system/system_monitor.py +229 -0
  305. wandb/sdk/internal/tb_watcher.py +518 -0
  306. wandb/sdk/internal/thread_local_settings.py +18 -0
  307. wandb/sdk/internal/update.py +113 -0
  308. wandb/sdk/internal/writer.py +206 -0
  309. wandb/sdk/launch/__init__.py +6 -0
  310. wandb/sdk/launch/_launch.py +348 -0
  311. wandb/sdk/launch/_launch_add.py +257 -0
  312. wandb/sdk/launch/_project_spec.py +578 -0
  313. wandb/sdk/launch/agent/__init__.py +5 -0
  314. wandb/sdk/launch/agent/agent.py +878 -0
  315. wandb/sdk/launch/agent/config.py +299 -0
  316. wandb/sdk/launch/agent/job_status_tracker.py +53 -0
  317. wandb/sdk/launch/agent/run_queue_item_file_saver.py +47 -0
  318. wandb/sdk/launch/builder/__init__.py +0 -0
  319. wandb/sdk/launch/builder/abstract.py +89 -0
  320. wandb/sdk/launch/builder/build.py +706 -0
  321. wandb/sdk/launch/builder/docker_builder.py +193 -0
  322. wandb/sdk/launch/builder/kaniko_builder.py +579 -0
  323. wandb/sdk/launch/builder/noop.py +58 -0
  324. wandb/sdk/launch/builder/templates/_wandb_bootstrap.py +187 -0
  325. wandb/sdk/launch/create_job.py +520 -0
  326. wandb/sdk/launch/environment/abstract.py +29 -0
  327. wandb/sdk/launch/environment/aws_environment.py +297 -0
  328. wandb/sdk/launch/environment/azure_environment.py +105 -0
  329. wandb/sdk/launch/environment/gcp_environment.py +335 -0
  330. wandb/sdk/launch/environment/local_environment.py +66 -0
  331. wandb/sdk/launch/errors.py +19 -0
  332. wandb/sdk/launch/git_reference.py +109 -0
  333. wandb/sdk/launch/loader.py +249 -0
  334. wandb/sdk/launch/registry/abstract.py +48 -0
  335. wandb/sdk/launch/registry/anon.py +29 -0
  336. wandb/sdk/launch/registry/azure_container_registry.py +124 -0
  337. wandb/sdk/launch/registry/elastic_container_registry.py +192 -0
  338. wandb/sdk/launch/registry/google_artifact_registry.py +219 -0
  339. wandb/sdk/launch/registry/local_registry.py +67 -0
  340. wandb/sdk/launch/runner/__init__.py +0 -0
  341. wandb/sdk/launch/runner/abstract.py +195 -0
  342. wandb/sdk/launch/runner/kubernetes_monitor.py +441 -0
  343. wandb/sdk/launch/runner/kubernetes_runner.py +893 -0
  344. wandb/sdk/launch/runner/local_container.py +299 -0
  345. wandb/sdk/launch/runner/local_process.py +99 -0
  346. wandb/sdk/launch/runner/sagemaker_runner.py +422 -0
  347. wandb/sdk/launch/runner/vertex_runner.py +229 -0
  348. wandb/sdk/launch/sweeps/__init__.py +39 -0
  349. wandb/sdk/launch/sweeps/scheduler.py +738 -0
  350. wandb/sdk/launch/sweeps/scheduler_sweep.py +91 -0
  351. wandb/sdk/launch/sweeps/utils.py +316 -0
  352. wandb/sdk/launch/utils.py +866 -0
  353. wandb/sdk/launch/wandb_reference.py +138 -0
  354. wandb/sdk/lib/__init__.py +5 -0
  355. wandb/sdk/lib/_settings_toposort_generate.py +159 -0
  356. wandb/sdk/lib/_settings_toposort_generated.py +244 -0
  357. wandb/sdk/lib/_wburls_generate.py +25 -0
  358. wandb/sdk/lib/_wburls_generated.py +22 -0
  359. wandb/sdk/lib/apikey.py +258 -0
  360. wandb/sdk/lib/capped_dict.py +26 -0
  361. wandb/sdk/lib/config_util.py +101 -0
  362. wandb/sdk/lib/console.py +39 -0
  363. wandb/sdk/lib/deprecate.py +42 -0
  364. wandb/sdk/lib/disabled.py +190 -0
  365. wandb/sdk/lib/exit_hooks.py +54 -0
  366. wandb/sdk/lib/file_stream_utils.py +118 -0
  367. wandb/sdk/lib/filenames.py +64 -0
  368. wandb/sdk/lib/filesystem.py +372 -0
  369. wandb/sdk/lib/fsm.py +174 -0
  370. wandb/sdk/lib/gitlib.py +239 -0
  371. wandb/sdk/lib/gql_request.py +65 -0
  372. wandb/sdk/lib/handler_util.py +21 -0
  373. wandb/sdk/lib/hashutil.py +62 -0
  374. wandb/sdk/lib/import_hooks.py +275 -0
  375. wandb/sdk/lib/ipython.py +146 -0
  376. wandb/sdk/lib/json_util.py +80 -0
  377. wandb/sdk/lib/lazyloader.py +63 -0
  378. wandb/sdk/lib/mailbox.py +460 -0
  379. wandb/sdk/lib/module.py +69 -0
  380. wandb/sdk/lib/paths.py +106 -0
  381. wandb/sdk/lib/preinit.py +42 -0
  382. wandb/sdk/lib/printer.py +313 -0
  383. wandb/sdk/lib/proto_util.py +69 -0
  384. wandb/sdk/lib/redirect.py +840 -0
  385. wandb/sdk/lib/reporting.py +99 -0
  386. wandb/sdk/lib/retry.py +289 -0
  387. wandb/sdk/lib/run_moment.py +78 -0
  388. wandb/sdk/lib/runid.py +12 -0
  389. wandb/sdk/lib/server.py +52 -0
  390. wandb/sdk/lib/sock_client.py +291 -0
  391. wandb/sdk/lib/sparkline.py +45 -0
  392. wandb/sdk/lib/telemetry.py +100 -0
  393. wandb/sdk/lib/timed_input.py +133 -0
  394. wandb/sdk/lib/timer.py +19 -0
  395. wandb/sdk/lib/tracelog.py +255 -0
  396. wandb/sdk/lib/wburls.py +46 -0
  397. wandb/sdk/service/__init__.py +0 -0
  398. wandb/sdk/service/_startup_debug.py +22 -0
  399. wandb/sdk/service/port_file.py +53 -0
  400. wandb/sdk/service/server.py +119 -0
  401. wandb/sdk/service/server_sock.py +276 -0
  402. wandb/sdk/service/service.py +266 -0
  403. wandb/sdk/service/service_base.py +50 -0
  404. wandb/sdk/service/service_sock.py +70 -0
  405. wandb/sdk/service/streams.py +426 -0
  406. wandb/sdk/verify/__init__.py +0 -0
  407. wandb/sdk/verify/verify.py +501 -0
  408. wandb/sdk/wandb_alerts.py +12 -0
  409. wandb/sdk/wandb_config.py +319 -0
  410. wandb/sdk/wandb_helper.py +54 -0
  411. wandb/sdk/wandb_init.py +1220 -0
  412. wandb/sdk/wandb_login.py +339 -0
  413. wandb/sdk/wandb_manager.py +222 -0
  414. wandb/sdk/wandb_metric.py +110 -0
  415. wandb/sdk/wandb_require.py +92 -0
  416. wandb/sdk/wandb_require_helpers.py +44 -0
  417. wandb/sdk/wandb_run.py +4191 -0
  418. wandb/sdk/wandb_settings.py +1973 -0
  419. wandb/sdk/wandb_setup.py +335 -0
  420. wandb/sdk/wandb_summary.py +150 -0
  421. wandb/sdk/wandb_sweep.py +114 -0
  422. wandb/sdk/wandb_sync.py +75 -0
  423. wandb/sdk/wandb_watch.py +128 -0
  424. wandb/sklearn/__init__.py +37 -0
  425. wandb/sklearn/calculate/__init__.py +32 -0
  426. wandb/sklearn/calculate/calibration_curves.py +125 -0
  427. wandb/sklearn/calculate/class_proportions.py +68 -0
  428. wandb/sklearn/calculate/confusion_matrix.py +92 -0
  429. wandb/sklearn/calculate/decision_boundaries.py +40 -0
  430. wandb/sklearn/calculate/elbow_curve.py +55 -0
  431. wandb/sklearn/calculate/feature_importances.py +67 -0
  432. wandb/sklearn/calculate/learning_curve.py +64 -0
  433. wandb/sklearn/calculate/outlier_candidates.py +69 -0
  434. wandb/sklearn/calculate/residuals.py +86 -0
  435. wandb/sklearn/calculate/silhouette.py +118 -0
  436. wandb/sklearn/calculate/summary_metrics.py +62 -0
  437. wandb/sklearn/plot/__init__.py +35 -0
  438. wandb/sklearn/plot/classifier.py +331 -0
  439. wandb/sklearn/plot/clusterer.py +142 -0
  440. wandb/sklearn/plot/regressor.py +121 -0
  441. wandb/sklearn/plot/shared.py +91 -0
  442. wandb/sklearn/utils.py +183 -0
  443. wandb/sync/__init__.py +3 -0
  444. wandb/sync/sync.py +443 -0
  445. wandb/testing/relay.py +859 -0
  446. wandb/trigger.py +29 -0
  447. wandb/util.py +1925 -0
  448. wandb/vendor/__init__.py +0 -0
  449. wandb/vendor/gql-0.2.0/setup.py +40 -0
  450. wandb/vendor/gql-0.2.0/tests/__init__.py +0 -0
  451. wandb/vendor/gql-0.2.0/tests/starwars/__init__.py +0 -0
  452. wandb/vendor/gql-0.2.0/tests/starwars/fixtures.py +96 -0
  453. wandb/vendor/gql-0.2.0/tests/starwars/schema.py +146 -0
  454. wandb/vendor/gql-0.2.0/tests/starwars/test_dsl.py +293 -0
  455. wandb/vendor/gql-0.2.0/tests/starwars/test_query.py +355 -0
  456. wandb/vendor/gql-0.2.0/tests/starwars/test_validation.py +171 -0
  457. wandb/vendor/gql-0.2.0/tests/test_client.py +31 -0
  458. wandb/vendor/gql-0.2.0/tests/test_transport.py +89 -0
  459. wandb/vendor/gql-0.2.0/wandb_gql/__init__.py +4 -0
  460. wandb/vendor/gql-0.2.0/wandb_gql/client.py +75 -0
  461. wandb/vendor/gql-0.2.0/wandb_gql/dsl.py +152 -0
  462. wandb/vendor/gql-0.2.0/wandb_gql/gql.py +10 -0
  463. wandb/vendor/gql-0.2.0/wandb_gql/transport/__init__.py +0 -0
  464. wandb/vendor/gql-0.2.0/wandb_gql/transport/http.py +6 -0
  465. wandb/vendor/gql-0.2.0/wandb_gql/transport/local_schema.py +15 -0
  466. wandb/vendor/gql-0.2.0/wandb_gql/transport/requests.py +46 -0
  467. wandb/vendor/gql-0.2.0/wandb_gql/utils.py +21 -0
  468. wandb/vendor/graphql-core-1.1/setup.py +86 -0
  469. wandb/vendor/graphql-core-1.1/wandb_graphql/__init__.py +287 -0
  470. wandb/vendor/graphql-core-1.1/wandb_graphql/error/__init__.py +6 -0
  471. wandb/vendor/graphql-core-1.1/wandb_graphql/error/base.py +42 -0
  472. wandb/vendor/graphql-core-1.1/wandb_graphql/error/format_error.py +11 -0
  473. wandb/vendor/graphql-core-1.1/wandb_graphql/error/located_error.py +29 -0
  474. wandb/vendor/graphql-core-1.1/wandb_graphql/error/syntax_error.py +36 -0
  475. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/__init__.py +26 -0
  476. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/base.py +311 -0
  477. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executor.py +398 -0
  478. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/__init__.py +0 -0
  479. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/asyncio.py +53 -0
  480. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/gevent.py +22 -0
  481. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/process.py +32 -0
  482. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/sync.py +7 -0
  483. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/thread.py +35 -0
  484. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/utils.py +6 -0
  485. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/__init__.py +0 -0
  486. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/executor.py +66 -0
  487. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/fragment.py +252 -0
  488. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/resolver.py +151 -0
  489. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/utils.py +7 -0
  490. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/middleware.py +57 -0
  491. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/values.py +145 -0
  492. wandb/vendor/graphql-core-1.1/wandb_graphql/graphql.py +60 -0
  493. wandb/vendor/graphql-core-1.1/wandb_graphql/language/__init__.py +0 -0
  494. wandb/vendor/graphql-core-1.1/wandb_graphql/language/ast.py +1349 -0
  495. wandb/vendor/graphql-core-1.1/wandb_graphql/language/base.py +19 -0
  496. wandb/vendor/graphql-core-1.1/wandb_graphql/language/lexer.py +435 -0
  497. wandb/vendor/graphql-core-1.1/wandb_graphql/language/location.py +30 -0
  498. wandb/vendor/graphql-core-1.1/wandb_graphql/language/parser.py +779 -0
  499. wandb/vendor/graphql-core-1.1/wandb_graphql/language/printer.py +193 -0
  500. wandb/vendor/graphql-core-1.1/wandb_graphql/language/source.py +18 -0
  501. wandb/vendor/graphql-core-1.1/wandb_graphql/language/visitor.py +222 -0
  502. wandb/vendor/graphql-core-1.1/wandb_graphql/language/visitor_meta.py +82 -0
  503. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/__init__.py +0 -0
  504. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/cached_property.py +17 -0
  505. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/contain_subset.py +28 -0
  506. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/default_ordered_dict.py +40 -0
  507. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/ordereddict.py +8 -0
  508. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/pair_set.py +43 -0
  509. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/version.py +78 -0
  510. wandb/vendor/graphql-core-1.1/wandb_graphql/type/__init__.py +67 -0
  511. wandb/vendor/graphql-core-1.1/wandb_graphql/type/definition.py +619 -0
  512. wandb/vendor/graphql-core-1.1/wandb_graphql/type/directives.py +132 -0
  513. wandb/vendor/graphql-core-1.1/wandb_graphql/type/introspection.py +440 -0
  514. wandb/vendor/graphql-core-1.1/wandb_graphql/type/scalars.py +131 -0
  515. wandb/vendor/graphql-core-1.1/wandb_graphql/type/schema.py +100 -0
  516. wandb/vendor/graphql-core-1.1/wandb_graphql/type/typemap.py +145 -0
  517. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/__init__.py +0 -0
  518. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/assert_valid_name.py +9 -0
  519. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/ast_from_value.py +65 -0
  520. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/ast_to_code.py +49 -0
  521. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/ast_to_dict.py +24 -0
  522. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/base.py +75 -0
  523. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/build_ast_schema.py +291 -0
  524. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/build_client_schema.py +250 -0
  525. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/concat_ast.py +9 -0
  526. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/extend_schema.py +357 -0
  527. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/get_field_def.py +27 -0
  528. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/get_operation_ast.py +21 -0
  529. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/introspection_query.py +90 -0
  530. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/is_valid_literal_value.py +67 -0
  531. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/is_valid_value.py +66 -0
  532. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/quoted_or_list.py +21 -0
  533. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/schema_printer.py +168 -0
  534. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/suggestion_list.py +56 -0
  535. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/type_comparators.py +69 -0
  536. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/type_from_ast.py +21 -0
  537. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/type_info.py +149 -0
  538. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/value_from_ast.py +69 -0
  539. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/__init__.py +4 -0
  540. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/__init__.py +79 -0
  541. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/arguments_of_correct_type.py +24 -0
  542. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/base.py +8 -0
  543. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/default_values_of_correct_type.py +44 -0
  544. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/fields_on_correct_type.py +113 -0
  545. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/fragments_on_composite_types.py +33 -0
  546. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_argument_names.py +70 -0
  547. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_directives.py +97 -0
  548. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_fragment_names.py +19 -0
  549. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_type_names.py +43 -0
  550. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/lone_anonymous_operation.py +23 -0
  551. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_fragment_cycles.py +59 -0
  552. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_undefined_variables.py +36 -0
  553. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_unused_fragments.py +38 -0
  554. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_unused_variables.py +37 -0
  555. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/overlapping_fields_can_be_merged.py +529 -0
  556. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/possible_fragment_spreads.py +44 -0
  557. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/provided_non_null_arguments.py +46 -0
  558. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/scalar_leafs.py +33 -0
  559. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_argument_names.py +32 -0
  560. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_fragment_names.py +28 -0
  561. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_input_field_names.py +33 -0
  562. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_operation_names.py +31 -0
  563. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_variable_names.py +27 -0
  564. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/variables_are_input_types.py +21 -0
  565. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/variables_in_allowed_position.py +53 -0
  566. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/validation.py +158 -0
  567. wandb/vendor/promise-2.3.0/conftest.py +30 -0
  568. wandb/vendor/promise-2.3.0/setup.py +64 -0
  569. wandb/vendor/promise-2.3.0/tests/__init__.py +0 -0
  570. wandb/vendor/promise-2.3.0/tests/conftest.py +8 -0
  571. wandb/vendor/promise-2.3.0/tests/test_awaitable.py +32 -0
  572. wandb/vendor/promise-2.3.0/tests/test_awaitable_35.py +47 -0
  573. wandb/vendor/promise-2.3.0/tests/test_benchmark.py +116 -0
  574. wandb/vendor/promise-2.3.0/tests/test_complex_threads.py +23 -0
  575. wandb/vendor/promise-2.3.0/tests/test_dataloader.py +452 -0
  576. wandb/vendor/promise-2.3.0/tests/test_dataloader_awaitable_35.py +99 -0
  577. wandb/vendor/promise-2.3.0/tests/test_dataloader_extra.py +65 -0
  578. wandb/vendor/promise-2.3.0/tests/test_extra.py +670 -0
  579. wandb/vendor/promise-2.3.0/tests/test_issues.py +132 -0
  580. wandb/vendor/promise-2.3.0/tests/test_promise_list.py +70 -0
  581. wandb/vendor/promise-2.3.0/tests/test_spec.py +584 -0
  582. wandb/vendor/promise-2.3.0/tests/test_thread_safety.py +115 -0
  583. wandb/vendor/promise-2.3.0/tests/utils.py +3 -0
  584. wandb/vendor/promise-2.3.0/wandb_promise/__init__.py +38 -0
  585. wandb/vendor/promise-2.3.0/wandb_promise/async_.py +135 -0
  586. wandb/vendor/promise-2.3.0/wandb_promise/compat.py +32 -0
  587. wandb/vendor/promise-2.3.0/wandb_promise/dataloader.py +326 -0
  588. wandb/vendor/promise-2.3.0/wandb_promise/iterate_promise.py +12 -0
  589. wandb/vendor/promise-2.3.0/wandb_promise/promise.py +848 -0
  590. wandb/vendor/promise-2.3.0/wandb_promise/promise_list.py +151 -0
  591. wandb/vendor/promise-2.3.0/wandb_promise/pyutils/__init__.py +0 -0
  592. wandb/vendor/promise-2.3.0/wandb_promise/pyutils/version.py +83 -0
  593. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/__init__.py +0 -0
  594. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/asyncio.py +22 -0
  595. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/gevent.py +21 -0
  596. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/immediate.py +27 -0
  597. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/thread.py +18 -0
  598. wandb/vendor/promise-2.3.0/wandb_promise/utils.py +56 -0
  599. wandb/vendor/pygments/__init__.py +90 -0
  600. wandb/vendor/pygments/cmdline.py +568 -0
  601. wandb/vendor/pygments/console.py +74 -0
  602. wandb/vendor/pygments/filter.py +74 -0
  603. wandb/vendor/pygments/filters/__init__.py +350 -0
  604. wandb/vendor/pygments/formatter.py +95 -0
  605. wandb/vendor/pygments/formatters/__init__.py +153 -0
  606. wandb/vendor/pygments/formatters/_mapping.py +85 -0
  607. wandb/vendor/pygments/formatters/bbcode.py +109 -0
  608. wandb/vendor/pygments/formatters/html.py +851 -0
  609. wandb/vendor/pygments/formatters/img.py +600 -0
  610. wandb/vendor/pygments/formatters/irc.py +182 -0
  611. wandb/vendor/pygments/formatters/latex.py +482 -0
  612. wandb/vendor/pygments/formatters/other.py +160 -0
  613. wandb/vendor/pygments/formatters/rtf.py +147 -0
  614. wandb/vendor/pygments/formatters/svg.py +153 -0
  615. wandb/vendor/pygments/formatters/terminal.py +136 -0
  616. wandb/vendor/pygments/formatters/terminal256.py +309 -0
  617. wandb/vendor/pygments/lexer.py +871 -0
  618. wandb/vendor/pygments/lexers/__init__.py +329 -0
  619. wandb/vendor/pygments/lexers/_asy_builtins.py +1645 -0
  620. wandb/vendor/pygments/lexers/_cl_builtins.py +232 -0
  621. wandb/vendor/pygments/lexers/_cocoa_builtins.py +72 -0
  622. wandb/vendor/pygments/lexers/_csound_builtins.py +1346 -0
  623. wandb/vendor/pygments/lexers/_lasso_builtins.py +5327 -0
  624. wandb/vendor/pygments/lexers/_lua_builtins.py +295 -0
  625. wandb/vendor/pygments/lexers/_mapping.py +500 -0
  626. wandb/vendor/pygments/lexers/_mql_builtins.py +1172 -0
  627. wandb/vendor/pygments/lexers/_openedge_builtins.py +2547 -0
  628. wandb/vendor/pygments/lexers/_php_builtins.py +4756 -0
  629. wandb/vendor/pygments/lexers/_postgres_builtins.py +621 -0
  630. wandb/vendor/pygments/lexers/_scilab_builtins.py +3094 -0
  631. wandb/vendor/pygments/lexers/_sourcemod_builtins.py +1163 -0
  632. wandb/vendor/pygments/lexers/_stan_builtins.py +532 -0
  633. wandb/vendor/pygments/lexers/_stata_builtins.py +419 -0
  634. wandb/vendor/pygments/lexers/_tsql_builtins.py +1004 -0
  635. wandb/vendor/pygments/lexers/_vim_builtins.py +1939 -0
  636. wandb/vendor/pygments/lexers/actionscript.py +240 -0
  637. wandb/vendor/pygments/lexers/agile.py +24 -0
  638. wandb/vendor/pygments/lexers/algebra.py +221 -0
  639. wandb/vendor/pygments/lexers/ambient.py +76 -0
  640. wandb/vendor/pygments/lexers/ampl.py +87 -0
  641. wandb/vendor/pygments/lexers/apl.py +101 -0
  642. wandb/vendor/pygments/lexers/archetype.py +318 -0
  643. wandb/vendor/pygments/lexers/asm.py +641 -0
  644. wandb/vendor/pygments/lexers/automation.py +374 -0
  645. wandb/vendor/pygments/lexers/basic.py +500 -0
  646. wandb/vendor/pygments/lexers/bibtex.py +160 -0
  647. wandb/vendor/pygments/lexers/business.py +612 -0
  648. wandb/vendor/pygments/lexers/c_cpp.py +252 -0
  649. wandb/vendor/pygments/lexers/c_like.py +541 -0
  650. wandb/vendor/pygments/lexers/capnproto.py +78 -0
  651. wandb/vendor/pygments/lexers/chapel.py +102 -0
  652. wandb/vendor/pygments/lexers/clean.py +288 -0
  653. wandb/vendor/pygments/lexers/compiled.py +34 -0
  654. wandb/vendor/pygments/lexers/configs.py +833 -0
  655. wandb/vendor/pygments/lexers/console.py +114 -0
  656. wandb/vendor/pygments/lexers/crystal.py +393 -0
  657. wandb/vendor/pygments/lexers/csound.py +366 -0
  658. wandb/vendor/pygments/lexers/css.py +689 -0
  659. wandb/vendor/pygments/lexers/d.py +251 -0
  660. wandb/vendor/pygments/lexers/dalvik.py +125 -0
  661. wandb/vendor/pygments/lexers/data.py +555 -0
  662. wandb/vendor/pygments/lexers/diff.py +165 -0
  663. wandb/vendor/pygments/lexers/dotnet.py +691 -0
  664. wandb/vendor/pygments/lexers/dsls.py +878 -0
  665. wandb/vendor/pygments/lexers/dylan.py +289 -0
  666. wandb/vendor/pygments/lexers/ecl.py +125 -0
  667. wandb/vendor/pygments/lexers/eiffel.py +65 -0
  668. wandb/vendor/pygments/lexers/elm.py +121 -0
  669. wandb/vendor/pygments/lexers/erlang.py +533 -0
  670. wandb/vendor/pygments/lexers/esoteric.py +277 -0
  671. wandb/vendor/pygments/lexers/ezhil.py +69 -0
  672. wandb/vendor/pygments/lexers/factor.py +344 -0
  673. wandb/vendor/pygments/lexers/fantom.py +250 -0
  674. wandb/vendor/pygments/lexers/felix.py +273 -0
  675. wandb/vendor/pygments/lexers/forth.py +177 -0
  676. wandb/vendor/pygments/lexers/fortran.py +205 -0
  677. wandb/vendor/pygments/lexers/foxpro.py +428 -0
  678. wandb/vendor/pygments/lexers/functional.py +21 -0
  679. wandb/vendor/pygments/lexers/go.py +101 -0
  680. wandb/vendor/pygments/lexers/grammar_notation.py +213 -0
  681. wandb/vendor/pygments/lexers/graph.py +80 -0
  682. wandb/vendor/pygments/lexers/graphics.py +553 -0
  683. wandb/vendor/pygments/lexers/haskell.py +843 -0
  684. wandb/vendor/pygments/lexers/haxe.py +936 -0
  685. wandb/vendor/pygments/lexers/hdl.py +382 -0
  686. wandb/vendor/pygments/lexers/hexdump.py +103 -0
  687. wandb/vendor/pygments/lexers/html.py +602 -0
  688. wandb/vendor/pygments/lexers/idl.py +270 -0
  689. wandb/vendor/pygments/lexers/igor.py +288 -0
  690. wandb/vendor/pygments/lexers/inferno.py +96 -0
  691. wandb/vendor/pygments/lexers/installers.py +322 -0
  692. wandb/vendor/pygments/lexers/int_fiction.py +1343 -0
  693. wandb/vendor/pygments/lexers/iolang.py +63 -0
  694. wandb/vendor/pygments/lexers/j.py +146 -0
  695. wandb/vendor/pygments/lexers/javascript.py +1525 -0
  696. wandb/vendor/pygments/lexers/julia.py +333 -0
  697. wandb/vendor/pygments/lexers/jvm.py +1573 -0
  698. wandb/vendor/pygments/lexers/lisp.py +2621 -0
  699. wandb/vendor/pygments/lexers/make.py +202 -0
  700. wandb/vendor/pygments/lexers/markup.py +595 -0
  701. wandb/vendor/pygments/lexers/math.py +21 -0
  702. wandb/vendor/pygments/lexers/matlab.py +663 -0
  703. wandb/vendor/pygments/lexers/ml.py +769 -0
  704. wandb/vendor/pygments/lexers/modeling.py +358 -0
  705. wandb/vendor/pygments/lexers/modula2.py +1561 -0
  706. wandb/vendor/pygments/lexers/monte.py +204 -0
  707. wandb/vendor/pygments/lexers/ncl.py +894 -0
  708. wandb/vendor/pygments/lexers/nimrod.py +159 -0
  709. wandb/vendor/pygments/lexers/nit.py +64 -0
  710. wandb/vendor/pygments/lexers/nix.py +136 -0
  711. wandb/vendor/pygments/lexers/oberon.py +105 -0
  712. wandb/vendor/pygments/lexers/objective.py +504 -0
  713. wandb/vendor/pygments/lexers/ooc.py +85 -0
  714. wandb/vendor/pygments/lexers/other.py +41 -0
  715. wandb/vendor/pygments/lexers/parasail.py +79 -0
  716. wandb/vendor/pygments/lexers/parsers.py +835 -0
  717. wandb/vendor/pygments/lexers/pascal.py +644 -0
  718. wandb/vendor/pygments/lexers/pawn.py +199 -0
  719. wandb/vendor/pygments/lexers/perl.py +620 -0
  720. wandb/vendor/pygments/lexers/php.py +267 -0
  721. wandb/vendor/pygments/lexers/praat.py +294 -0
  722. wandb/vendor/pygments/lexers/prolog.py +306 -0
  723. wandb/vendor/pygments/lexers/python.py +939 -0
  724. wandb/vendor/pygments/lexers/qvt.py +152 -0
  725. wandb/vendor/pygments/lexers/r.py +453 -0
  726. wandb/vendor/pygments/lexers/rdf.py +270 -0
  727. wandb/vendor/pygments/lexers/rebol.py +431 -0
  728. wandb/vendor/pygments/lexers/resource.py +85 -0
  729. wandb/vendor/pygments/lexers/rnc.py +67 -0
  730. wandb/vendor/pygments/lexers/roboconf.py +82 -0
  731. wandb/vendor/pygments/lexers/robotframework.py +560 -0
  732. wandb/vendor/pygments/lexers/ruby.py +519 -0
  733. wandb/vendor/pygments/lexers/rust.py +220 -0
  734. wandb/vendor/pygments/lexers/sas.py +228 -0
  735. wandb/vendor/pygments/lexers/scripting.py +1222 -0
  736. wandb/vendor/pygments/lexers/shell.py +794 -0
  737. wandb/vendor/pygments/lexers/smalltalk.py +195 -0
  738. wandb/vendor/pygments/lexers/smv.py +79 -0
  739. wandb/vendor/pygments/lexers/snobol.py +83 -0
  740. wandb/vendor/pygments/lexers/special.py +103 -0
  741. wandb/vendor/pygments/lexers/sql.py +681 -0
  742. wandb/vendor/pygments/lexers/stata.py +108 -0
  743. wandb/vendor/pygments/lexers/supercollider.py +90 -0
  744. wandb/vendor/pygments/lexers/tcl.py +145 -0
  745. wandb/vendor/pygments/lexers/templates.py +2283 -0
  746. wandb/vendor/pygments/lexers/testing.py +207 -0
  747. wandb/vendor/pygments/lexers/text.py +25 -0
  748. wandb/vendor/pygments/lexers/textedit.py +169 -0
  749. wandb/vendor/pygments/lexers/textfmts.py +297 -0
  750. wandb/vendor/pygments/lexers/theorem.py +458 -0
  751. wandb/vendor/pygments/lexers/trafficscript.py +54 -0
  752. wandb/vendor/pygments/lexers/typoscript.py +226 -0
  753. wandb/vendor/pygments/lexers/urbi.py +133 -0
  754. wandb/vendor/pygments/lexers/varnish.py +190 -0
  755. wandb/vendor/pygments/lexers/verification.py +111 -0
  756. wandb/vendor/pygments/lexers/web.py +24 -0
  757. wandb/vendor/pygments/lexers/webmisc.py +988 -0
  758. wandb/vendor/pygments/lexers/whiley.py +116 -0
  759. wandb/vendor/pygments/lexers/x10.py +69 -0
  760. wandb/vendor/pygments/modeline.py +44 -0
  761. wandb/vendor/pygments/plugin.py +68 -0
  762. wandb/vendor/pygments/regexopt.py +92 -0
  763. wandb/vendor/pygments/scanner.py +105 -0
  764. wandb/vendor/pygments/sphinxext.py +158 -0
  765. wandb/vendor/pygments/style.py +155 -0
  766. wandb/vendor/pygments/styles/__init__.py +80 -0
  767. wandb/vendor/pygments/styles/abap.py +29 -0
  768. wandb/vendor/pygments/styles/algol.py +63 -0
  769. wandb/vendor/pygments/styles/algol_nu.py +63 -0
  770. wandb/vendor/pygments/styles/arduino.py +98 -0
  771. wandb/vendor/pygments/styles/autumn.py +65 -0
  772. wandb/vendor/pygments/styles/borland.py +51 -0
  773. wandb/vendor/pygments/styles/bw.py +49 -0
  774. wandb/vendor/pygments/styles/colorful.py +81 -0
  775. wandb/vendor/pygments/styles/default.py +73 -0
  776. wandb/vendor/pygments/styles/emacs.py +72 -0
  777. wandb/vendor/pygments/styles/friendly.py +72 -0
  778. wandb/vendor/pygments/styles/fruity.py +42 -0
  779. wandb/vendor/pygments/styles/igor.py +29 -0
  780. wandb/vendor/pygments/styles/lovelace.py +97 -0
  781. wandb/vendor/pygments/styles/manni.py +75 -0
  782. wandb/vendor/pygments/styles/monokai.py +106 -0
  783. wandb/vendor/pygments/styles/murphy.py +80 -0
  784. wandb/vendor/pygments/styles/native.py +65 -0
  785. wandb/vendor/pygments/styles/paraiso_dark.py +125 -0
  786. wandb/vendor/pygments/styles/paraiso_light.py +125 -0
  787. wandb/vendor/pygments/styles/pastie.py +75 -0
  788. wandb/vendor/pygments/styles/perldoc.py +69 -0
  789. wandb/vendor/pygments/styles/rainbow_dash.py +89 -0
  790. wandb/vendor/pygments/styles/rrt.py +33 -0
  791. wandb/vendor/pygments/styles/sas.py +44 -0
  792. wandb/vendor/pygments/styles/stata.py +40 -0
  793. wandb/vendor/pygments/styles/tango.py +141 -0
  794. wandb/vendor/pygments/styles/trac.py +63 -0
  795. wandb/vendor/pygments/styles/vim.py +63 -0
  796. wandb/vendor/pygments/styles/vs.py +38 -0
  797. wandb/vendor/pygments/styles/xcode.py +51 -0
  798. wandb/vendor/pygments/token.py +213 -0
  799. wandb/vendor/pygments/unistring.py +217 -0
  800. wandb/vendor/pygments/util.py +388 -0
  801. wandb/vendor/pynvml/__init__.py +0 -0
  802. wandb/vendor/pynvml/pynvml.py +4779 -0
  803. wandb/vendor/watchdog_0_9_0/wandb_watchdog/__init__.py +17 -0
  804. wandb/vendor/watchdog_0_9_0/wandb_watchdog/events.py +615 -0
  805. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/__init__.py +98 -0
  806. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/api.py +369 -0
  807. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/fsevents.py +172 -0
  808. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/fsevents2.py +239 -0
  809. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/inotify.py +218 -0
  810. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/inotify_buffer.py +81 -0
  811. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/inotify_c.py +575 -0
  812. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/kqueue.py +730 -0
  813. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/polling.py +145 -0
  814. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/read_directory_changes.py +133 -0
  815. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/winapi.py +348 -0
  816. wandb/vendor/watchdog_0_9_0/wandb_watchdog/patterns.py +265 -0
  817. wandb/vendor/watchdog_0_9_0/wandb_watchdog/tricks/__init__.py +174 -0
  818. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/__init__.py +151 -0
  819. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/bricks.py +249 -0
  820. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/compat.py +29 -0
  821. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/decorators.py +198 -0
  822. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/delayed_queue.py +88 -0
  823. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/dirsnapshot.py +293 -0
  824. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/echo.py +157 -0
  825. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/event_backport.py +41 -0
  826. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/importlib2.py +40 -0
  827. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/platform.py +57 -0
  828. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/unicode_paths.py +64 -0
  829. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/win32stat.py +123 -0
  830. wandb/vendor/watchdog_0_9_0/wandb_watchdog/version.py +28 -0
  831. wandb/vendor/watchdog_0_9_0/wandb_watchdog/watchmedo.py +577 -0
  832. wandb/viz.py +123 -0
  833. wandb/wandb_agent.py +586 -0
  834. wandb/wandb_controller.py +720 -0
  835. wandb/wandb_run.py +9 -0
  836. wandb/wandb_torch.py +550 -0
  837. wandb/xgboost/__init__.py +9 -0
  838. wandb-0.17.0rc1.dist-info/METADATA +219 -0
  839. wandb-0.17.0rc1.dist-info/RECORD +842 -0
  840. wandb-0.17.0rc1.dist-info/WHEEL +4 -0
  841. wandb-0.17.0rc1.dist-info/entry_points.txt +3 -0
  842. wandb-0.17.0rc1.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,1220 @@
1
+ """Defines wandb.init() and associated classes and methods.
2
+
3
+ `wandb.init()` indicates the beginning of a new run. In an ML training pipeline,
4
+ you could add `wandb.init()` to the beginning of your training script as well as
5
+ your evaluation script, and each step would be tracked as a run in W&B.
6
+
7
+ For more on using `wandb.init()`, including code snippets, check out our
8
+ [guide and FAQs](https://docs.wandb.ai/guides/track/launch).
9
+ """
10
+
11
+ import copy
12
+ import json
13
+ import logging
14
+ import os
15
+ import platform
16
+ import sys
17
+ import tempfile
18
+ import traceback
19
+ from typing import TYPE_CHECKING, Any, Dict, List, Optional, Sequence, Union
20
+
21
+ import wandb
22
+ import wandb.env
23
+ from wandb import trigger
24
+ from wandb.errors import CommError, Error, UsageError
25
+ from wandb.errors.util import ProtobufErrorHandler
26
+ from wandb.integration import sagemaker
27
+ from wandb.integration.magic import magic_install
28
+ from wandb.sdk.lib import runid
29
+ from wandb.sdk.lib.paths import StrPath
30
+ from wandb.util import _is_artifact_representation
31
+
32
+ from . import wandb_login, wandb_setup
33
+ from .backend.backend import Backend
34
+ from .lib import (
35
+ RunDisabled,
36
+ SummaryDisabled,
37
+ filesystem,
38
+ ipython,
39
+ module,
40
+ reporting,
41
+ telemetry,
42
+ )
43
+ from .lib.deprecate import Deprecated, deprecate
44
+ from .lib.mailbox import Mailbox, MailboxProgress
45
+ from .lib.printer import Printer, get_printer
46
+ from .lib.wburls import wburls
47
+ from .wandb_helper import parse_config
48
+ from .wandb_run import Run, TeardownHook, TeardownStage
49
+ from .wandb_settings import Settings, Source
50
+
51
+ if TYPE_CHECKING:
52
+ from wandb.proto import wandb_internal_pb2 as pb
53
+
54
+ logger: Optional[logging.Logger] = None # logger configured during wandb.init()
55
+
56
+
57
+ def _set_logger(log_object: logging.Logger) -> None:
58
+ """Configure module logger."""
59
+ global logger
60
+ logger = log_object
61
+
62
+
63
+ def _huggingface_version() -> Optional[str]:
64
+ if "transformers" in sys.modules:
65
+ trans = wandb.util.get_module("transformers")
66
+ if hasattr(trans, "__version__"):
67
+ return str(trans.__version__)
68
+ return None
69
+
70
+
71
+ def _maybe_mp_process(backend: Backend) -> bool:
72
+ parent_process = getattr(
73
+ backend._multiprocessing, "parent_process", None
74
+ ) # New in version 3.8.
75
+ if parent_process:
76
+ return parent_process() is not None
77
+ process = backend._multiprocessing.current_process()
78
+ if process.name == "MainProcess":
79
+ return False
80
+ if process.name.startswith("Process-"):
81
+ return True
82
+ return False
83
+
84
+
85
+ def _handle_launch_config(settings: "Settings") -> Dict[str, Any]:
86
+ launch_run_config: Dict[str, Any] = {}
87
+ if not settings.launch:
88
+ return launch_run_config
89
+ if os.environ.get("WANDB_CONFIG") is not None:
90
+ try:
91
+ launch_run_config = json.loads(os.environ.get("WANDB_CONFIG", "{}"))
92
+ except (ValueError, SyntaxError):
93
+ wandb.termwarn("Malformed WANDB_CONFIG, using original config")
94
+ elif settings.launch_config_path and os.path.exists(settings.launch_config_path):
95
+ with open(settings.launch_config_path) as fp:
96
+ launch_config = json.loads(fp.read())
97
+ launch_run_config = launch_config.get("overrides", {}).get("run_config")
98
+ else:
99
+ i = 0
100
+ chunks = []
101
+ while True:
102
+ key = f"WANDB_CONFIG_{i}"
103
+ if key in os.environ:
104
+ chunks.append(os.environ[key])
105
+ i += 1
106
+ else:
107
+ break
108
+ if len(chunks) > 0:
109
+ config_string = "".join(chunks)
110
+ try:
111
+ launch_run_config = json.loads(config_string)
112
+ except (ValueError, SyntaxError):
113
+ wandb.termwarn("Malformed WANDB_CONFIG, using original config")
114
+
115
+ return launch_run_config
116
+
117
+
118
+ class _WandbInit:
119
+ _init_telemetry_obj: telemetry.TelemetryRecord
120
+
121
+ def __init__(self) -> None:
122
+ self.kwargs = None
123
+ self.settings: Optional[Settings] = None
124
+ self.sweep_config: Dict[str, Any] = {}
125
+ self.launch_config: Dict[str, Any] = {}
126
+ self.config: Dict[str, Any] = {}
127
+ self.run: Optional[Run] = None
128
+ self.backend: Optional[Backend] = None
129
+
130
+ self._teardown_hooks: List[TeardownHook] = []
131
+ self._wl: Optional[wandb_setup._WandbSetup] = None
132
+ self._reporter: Optional[wandb.sdk.lib.reporting.Reporter] = None
133
+ self.notebook: Optional[wandb.jupyter.Notebook] = None # type: ignore
134
+ self.printer: Optional[Printer] = None
135
+
136
+ self._init_telemetry_obj = telemetry.TelemetryRecord()
137
+
138
+ self.deprecated_features_used: Dict[str, str] = dict()
139
+
140
+ def _setup_printer(self, settings: Settings) -> None:
141
+ if self.printer:
142
+ return
143
+ self.printer = get_printer(settings._jupyter)
144
+
145
+ def setup(self, kwargs: Any) -> None: # noqa: C901
146
+ """Complete setup for `wandb.init()`.
147
+
148
+ This includes parsing all arguments, applying them with settings and enabling logging.
149
+ """
150
+ self.kwargs = kwargs
151
+
152
+ # if the user ran, for example, `wandb.login(`) before `wandb.init()`,
153
+ # the singleton will already be set up and so if e.g. env vars are set
154
+ # in between, they will be ignored, which we need to inform the user about.
155
+ singleton = wandb_setup._WandbSetup._instance
156
+ if singleton is not None:
157
+ self._setup_printer(settings=singleton._settings)
158
+ assert self.printer
159
+ exclude_env_vars = {"WANDB_SERVICE", "WANDB_KUBEFLOW_URL"}
160
+ # check if environment variables have changed
161
+ singleton_env = {
162
+ k: v
163
+ for k, v in singleton._environ.items()
164
+ if k.startswith("WANDB_") and k not in exclude_env_vars
165
+ }
166
+ os_env = {
167
+ k: v
168
+ for k, v in os.environ.items()
169
+ if k.startswith("WANDB_") and k not in exclude_env_vars
170
+ }
171
+ if set(singleton_env.keys()) != set(os_env.keys()) or set(
172
+ singleton_env.values()
173
+ ) != set(os_env.values()):
174
+ line = (
175
+ "Changes to your `wandb` environment variables will be ignored "
176
+ "because your `wandb` session has already started. "
177
+ "For more information on how to modify your settings with "
178
+ "`wandb.init()` arguments, please refer to "
179
+ f"{self.printer.link(wburls.get('wandb_init'), 'the W&B docs')}."
180
+ )
181
+ self.printer.display(line, level="warn")
182
+
183
+ # we add this logic to be backward compatible with the old behavior of disable
184
+ # where it would disable the service if the mode was set to disabled
185
+ mode = kwargs.get("mode")
186
+ settings_mode = (kwargs.get("settings") or {}).get("mode")
187
+ _disable_service = mode == "disabled" or settings_mode == "disabled"
188
+ setup_settings = {"_disable_service": _disable_service}
189
+
190
+ self._wl = wandb_setup.setup(settings=setup_settings)
191
+ # Make sure we have a logger setup (might be an early logger)
192
+ assert self._wl is not None
193
+ _set_logger(self._wl._get_logger())
194
+
195
+ # Start with settings from wandb library singleton
196
+ settings: Settings = self._wl.settings.copy()
197
+
198
+ settings_param = kwargs.pop("settings", None)
199
+ if settings_param is not None and isinstance(settings_param, (Settings, dict)):
200
+ settings.update(settings_param, source=Source.INIT)
201
+
202
+ self._setup_printer(settings)
203
+ self._reporter = reporting.setup_reporter(settings=settings)
204
+
205
+ sagemaker_config: Dict = (
206
+ dict() if settings.sagemaker_disable else sagemaker.parse_sm_config()
207
+ )
208
+ if sagemaker_config:
209
+ sagemaker_api_key = sagemaker_config.get("wandb_api_key", None)
210
+ sagemaker_run, sagemaker_env = sagemaker.parse_sm_resources()
211
+ if sagemaker_env:
212
+ if sagemaker_api_key:
213
+ sagemaker_env["WANDB_API_KEY"] = sagemaker_api_key
214
+ settings._apply_env_vars(sagemaker_env)
215
+ wandb.setup(settings=settings)
216
+ settings.update(sagemaker_run, source=Source.SETUP)
217
+ with telemetry.context(obj=self._init_telemetry_obj) as tel:
218
+ tel.feature.sagemaker = True
219
+
220
+ with telemetry.context(obj=self._init_telemetry_obj) as tel:
221
+ if kwargs.get("config"):
222
+ tel.feature.set_init_config = True
223
+ if kwargs.get("name"):
224
+ tel.feature.set_init_name = True
225
+ if kwargs.get("id"):
226
+ tel.feature.set_init_id = True
227
+ if kwargs.get("tags"):
228
+ tel.feature.set_init_tags = True
229
+
230
+ # Remove parameters that are not part of settings
231
+ init_config = kwargs.pop("config", None) or dict()
232
+
233
+ # todo: remove this once officially deprecated
234
+ deprecated_kwargs = {
235
+ "config_include_keys": (
236
+ "Use `config=wandb.helper.parse_config(config_object, include=('key',))` instead."
237
+ ),
238
+ "config_exclude_keys": (
239
+ "Use `config=wandb.helper.parse_config(config_object, exclude=('key',))` instead."
240
+ ),
241
+ }
242
+ for deprecated_kwarg, msg in deprecated_kwargs.items():
243
+ if kwargs.get(deprecated_kwarg):
244
+ self.deprecated_features_used[deprecated_kwarg] = msg
245
+
246
+ init_config = parse_config(
247
+ init_config,
248
+ include=kwargs.pop("config_include_keys", None),
249
+ exclude=kwargs.pop("config_exclude_keys", None),
250
+ )
251
+
252
+ # merge config with sweep or sagemaker (or config file)
253
+ self.sweep_config = dict()
254
+ sweep_config = self._wl._sweep_config or dict()
255
+ self.config = dict()
256
+ self.init_artifact_config: Dict[str, Any] = dict()
257
+ for config_data in (
258
+ sagemaker_config,
259
+ self._wl._config,
260
+ init_config,
261
+ ):
262
+ if not config_data:
263
+ continue
264
+ # split out artifacts, since when inserted into
265
+ # config they will trigger use_artifact
266
+ # but the run is not yet upserted
267
+ self._split_artifacts_from_config(config_data, self.config)
268
+
269
+ if sweep_config:
270
+ self._split_artifacts_from_config(sweep_config, self.sweep_config)
271
+
272
+ monitor_gym = kwargs.pop("monitor_gym", None)
273
+ if monitor_gym and len(wandb.patched["gym"]) == 0:
274
+ wandb.gym.monitor()
275
+
276
+ if wandb.patched["tensorboard"]:
277
+ with telemetry.context(obj=self._init_telemetry_obj) as tel:
278
+ tel.feature.tensorboard_patch = True
279
+
280
+ tensorboard = kwargs.pop("tensorboard", None)
281
+ sync_tensorboard = kwargs.pop("sync_tensorboard", None)
282
+ if tensorboard or sync_tensorboard and len(wandb.patched["tensorboard"]) == 0:
283
+ wandb.tensorboard.patch()
284
+ with telemetry.context(obj=self._init_telemetry_obj) as tel:
285
+ tel.feature.tensorboard_sync = True
286
+
287
+ magic = kwargs.get("magic")
288
+ if magic not in (None, False):
289
+ magic_install(kwargs)
290
+
291
+ # handle login related parameters as these are applied to global state
292
+ init_settings = {
293
+ key: kwargs[key]
294
+ for key in ["anonymous", "force", "mode", "resume"]
295
+ if kwargs.get(key) is not None
296
+ }
297
+ if init_settings:
298
+ settings.update(init_settings, source=Source.INIT)
299
+
300
+ if not settings._offline and not settings._noop:
301
+ wandb_login._login(
302
+ anonymous=kwargs.pop("anonymous", None),
303
+ force=kwargs.pop("force", None),
304
+ _disable_warning=True,
305
+ _silent=settings.quiet or settings.silent,
306
+ _entity=kwargs.get("entity") or settings.entity,
307
+ )
308
+
309
+ # apply updated global state after login was handled
310
+ wl = wandb.setup()
311
+ assert wl is not None
312
+ settings._apply_settings(wl.settings)
313
+
314
+ # get status of code saving before applying user settings
315
+ save_code_pre_user_settings = settings.save_code
316
+
317
+ settings._apply_init(kwargs)
318
+ if not settings._offline and not settings._noop:
319
+ user_settings = self._wl._load_user_settings()
320
+ settings._apply_user(user_settings)
321
+
322
+ # ensure that user settings don't set saving to true
323
+ # if user explicitly set these to false in UI
324
+ if save_code_pre_user_settings is False:
325
+ settings.update({"save_code": False}, source=Source.INIT)
326
+
327
+ # TODO(jhr): should this be moved? probably.
328
+ settings._set_run_start_time(source=Source.INIT)
329
+
330
+ if not settings._noop:
331
+ self._log_setup(settings)
332
+
333
+ if settings._jupyter:
334
+ self._jupyter_setup(settings)
335
+ launch_config = _handle_launch_config(settings)
336
+ if launch_config:
337
+ self._split_artifacts_from_config(launch_config, self.launch_config)
338
+
339
+ self.settings = settings
340
+
341
+ # self.settings.freeze()
342
+
343
+ def teardown(self) -> None:
344
+ # TODO: currently this is only called on failed wandb.init attempts
345
+ # normally this happens on the run object
346
+ assert logger
347
+ logger.info("tearing down wandb.init")
348
+ for hook in self._teardown_hooks:
349
+ hook.call()
350
+
351
+ def _split_artifacts_from_config(
352
+ self, config_source: dict, config_target: dict
353
+ ) -> None:
354
+ for k, v in config_source.items():
355
+ if _is_artifact_representation(v):
356
+ self.init_artifact_config[k] = v
357
+ else:
358
+ config_target.setdefault(k, v)
359
+
360
+ def _enable_logging(self, log_fname: str, run_id: Optional[str] = None) -> None:
361
+ """Enable logging to the global debug log.
362
+
363
+ This adds a run_id to the log, in case of multiple processes on the same machine.
364
+ Currently, there is no way to disable logging after it's enabled.
365
+ """
366
+ handler = logging.FileHandler(log_fname)
367
+ handler.setLevel(logging.INFO)
368
+
369
+ class WBFilter(logging.Filter):
370
+ def filter(self, record: logging.LogRecord) -> bool:
371
+ record.run_id = run_id
372
+ return True
373
+
374
+ if run_id:
375
+ formatter = logging.Formatter(
376
+ "%(asctime)s %(levelname)-7s %(threadName)-10s:%(process)d "
377
+ "[%(run_id)s:%(filename)s:%(funcName)s():%(lineno)s] %(message)s"
378
+ )
379
+ else:
380
+ formatter = logging.Formatter(
381
+ "%(asctime)s %(levelname)-7s %(threadName)-10s:%(process)d "
382
+ "[%(filename)s:%(funcName)s():%(lineno)s] %(message)s"
383
+ )
384
+
385
+ handler.setFormatter(formatter)
386
+ if run_id:
387
+ handler.addFilter(WBFilter())
388
+ assert logger is not None
389
+ logger.propagate = False
390
+ logger.addHandler(handler)
391
+ # TODO: make me configurable
392
+ logger.setLevel(logging.DEBUG)
393
+ self._teardown_hooks.append(
394
+ TeardownHook(
395
+ lambda: (handler.close(), logger.removeHandler(handler)), # type: ignore
396
+ TeardownStage.LATE,
397
+ )
398
+ )
399
+
400
+ def _safe_symlink(
401
+ self, base: str, target: str, name: str, delete: bool = False
402
+ ) -> None:
403
+ # TODO(jhr): do this with relpaths, but i cant figure it out on no sleep
404
+ if not hasattr(os, "symlink"):
405
+ return
406
+
407
+ pid = os.getpid()
408
+ tmp_name = os.path.join(base, "%s.%d" % (name, pid))
409
+
410
+ if delete:
411
+ try:
412
+ os.remove(os.path.join(base, name))
413
+ except OSError:
414
+ pass
415
+ target = os.path.relpath(target, base)
416
+ try:
417
+ os.symlink(target, tmp_name)
418
+ os.rename(tmp_name, os.path.join(base, name))
419
+ except OSError:
420
+ pass
421
+
422
+ def _pause_backend(self, *args: Any, **kwargs: Any) -> None: # noqa
423
+ if self.backend is None:
424
+ return None
425
+
426
+ # Attempt to save the code on every execution
427
+ if self.notebook.save_ipynb(): # type: ignore
428
+ assert self.run is not None
429
+ res = self.run.log_code(root=None)
430
+ logger.info("saved code: %s", res) # type: ignore
431
+ if self.backend.interface is not None:
432
+ logger.info("pausing backend") # type: ignore
433
+ self.backend.interface.publish_pause()
434
+
435
+ def _resume_backend(self, *args: Any, **kwargs: Any) -> None: # noqa
436
+ if self.backend is not None and self.backend.interface is not None:
437
+ logger.info("resuming backend") # type: ignore
438
+ self.backend.interface.publish_resume()
439
+
440
+ def _jupyter_teardown(self) -> None:
441
+ """Teardown hooks and display saving, called with wandb.finish."""
442
+ assert self.notebook
443
+ ipython = self.notebook.shell
444
+ self.notebook.save_history()
445
+ if self.notebook.save_ipynb():
446
+ assert self.run is not None
447
+ res = self.run.log_code(root=None)
448
+ logger.info("saved code and history: %s", res) # type: ignore
449
+ logger.info("cleaning up jupyter logic") # type: ignore
450
+ # because of how we bind our methods we manually find them to unregister
451
+ for hook in ipython.events.callbacks["pre_run_cell"]:
452
+ if "_resume_backend" in hook.__name__:
453
+ ipython.events.unregister("pre_run_cell", hook)
454
+ for hook in ipython.events.callbacks["post_run_cell"]:
455
+ if "_pause_backend" in hook.__name__:
456
+ ipython.events.unregister("post_run_cell", hook)
457
+ ipython.display_pub.publish = ipython.display_pub._orig_publish
458
+ del ipython.display_pub._orig_publish
459
+
460
+ def _jupyter_setup(self, settings: Settings) -> None:
461
+ """Add hooks, and session history saving."""
462
+ self.notebook = wandb.jupyter.Notebook(settings)
463
+ ipython = self.notebook.shell
464
+
465
+ # Monkey patch ipython publish to capture displayed outputs
466
+ if not hasattr(ipython.display_pub, "_orig_publish"):
467
+ logger.info("configuring jupyter hooks %s", self) # type: ignore
468
+ ipython.display_pub._orig_publish = ipython.display_pub.publish
469
+ # Registering resume and pause hooks
470
+
471
+ ipython.events.register("pre_run_cell", self._resume_backend)
472
+ ipython.events.register("post_run_cell", self._pause_backend)
473
+ self._teardown_hooks.append(
474
+ TeardownHook(self._jupyter_teardown, TeardownStage.EARLY)
475
+ )
476
+
477
+ def publish(data, metadata=None, **kwargs) -> None: # type: ignore
478
+ ipython.display_pub._orig_publish(data, metadata=metadata, **kwargs)
479
+ assert self.notebook is not None
480
+ self.notebook.save_display(
481
+ ipython.execution_count, {"data": data, "metadata": metadata}
482
+ )
483
+
484
+ ipython.display_pub.publish = publish
485
+
486
+ def _log_setup(self, settings: Settings) -> None:
487
+ """Set up logging from settings."""
488
+ filesystem.mkdir_exists_ok(os.path.dirname(settings.log_user))
489
+ filesystem.mkdir_exists_ok(os.path.dirname(settings.log_internal))
490
+ filesystem.mkdir_exists_ok(os.path.dirname(settings.sync_file))
491
+ filesystem.mkdir_exists_ok(settings.files_dir)
492
+ filesystem.mkdir_exists_ok(settings._tmp_code_dir)
493
+
494
+ if settings.symlink:
495
+ self._safe_symlink(
496
+ os.path.dirname(settings.sync_symlink_latest),
497
+ os.path.dirname(settings.sync_file),
498
+ os.path.basename(settings.sync_symlink_latest),
499
+ delete=True,
500
+ )
501
+ self._safe_symlink(
502
+ os.path.dirname(settings.log_symlink_user),
503
+ settings.log_user,
504
+ os.path.basename(settings.log_symlink_user),
505
+ delete=True,
506
+ )
507
+ self._safe_symlink(
508
+ os.path.dirname(settings.log_symlink_internal),
509
+ settings.log_internal,
510
+ os.path.basename(settings.log_symlink_internal),
511
+ delete=True,
512
+ )
513
+
514
+ _set_logger(logging.getLogger("wandb"))
515
+ self._enable_logging(settings.log_user)
516
+
517
+ assert self._wl
518
+ assert logger
519
+
520
+ self._wl._early_logger_flush(logger)
521
+ logger.info(f"Logging user logs to {settings.log_user}")
522
+ logger.info(f"Logging internal logs to {settings.log_internal}")
523
+
524
+ def _make_run_disabled(self) -> RunDisabled:
525
+ drun = RunDisabled()
526
+ drun.config = wandb.wandb_sdk.wandb_config.Config()
527
+ drun.config.update(self.sweep_config)
528
+ drun.config.update(self.config)
529
+ drun.summary = SummaryDisabled()
530
+ drun.log = lambda data, *_, **__: drun.summary.update(data)
531
+ drun.finish = lambda *_, **__: module.unset_globals()
532
+ drun.step = 0
533
+ drun.resumed = False
534
+ drun.disabled = True
535
+ drun.id = runid.generate_id()
536
+ drun.name = "dummy-" + drun.id
537
+ drun.dir = tempfile.gettempdir()
538
+ module.set_global(
539
+ run=drun,
540
+ config=drun.config,
541
+ log=drun.log,
542
+ summary=drun.summary,
543
+ save=drun.save,
544
+ use_artifact=drun.use_artifact,
545
+ log_artifact=drun.log_artifact,
546
+ define_metric=drun.define_metric,
547
+ plot_table=drun.plot_table,
548
+ alert=drun.alert,
549
+ )
550
+ return drun
551
+
552
+ def _on_progress_init(self, handle: MailboxProgress) -> None:
553
+ assert self.printer
554
+ line = "Waiting for wandb.init()...\r"
555
+ percent_done = handle.percent_done
556
+ self.printer.progress_update(line, percent_done=percent_done)
557
+
558
+ def init(self) -> Union[Run, RunDisabled, None]: # noqa: C901
559
+ if logger is None:
560
+ raise RuntimeError("Logger not initialized")
561
+ logger.info("calling init triggers")
562
+ trigger.call("on_init", **self.kwargs) # type: ignore
563
+
564
+ assert self.settings is not None
565
+ assert self._wl is not None
566
+ assert self._reporter is not None
567
+
568
+ logger.info(
569
+ f"wandb.init called with sweep_config: {self.sweep_config}\nconfig: {self.config}"
570
+ )
571
+
572
+ if self.settings._noop:
573
+ return self._make_run_disabled()
574
+ if self.settings.reinit or (
575
+ self.settings._jupyter and self.settings.reinit is not False
576
+ ):
577
+ if len(self._wl._global_run_stack) > 0:
578
+ if len(self._wl._global_run_stack) > 1:
579
+ wandb.termwarn(
580
+ "If you want to track multiple runs concurrently in wandb, "
581
+ "you should use multi-processing not threads"
582
+ )
583
+
584
+ latest_run = self._wl._global_run_stack[-1]
585
+
586
+ logger.info(
587
+ f"re-initializing run, found existing run on stack: {latest_run._run_id}"
588
+ )
589
+
590
+ jupyter = self.settings._jupyter
591
+ if jupyter and not self.settings.silent:
592
+ ipython.display_html(
593
+ f"Finishing last run (ID:{latest_run._run_id}) before initializing another..."
594
+ )
595
+
596
+ latest_run.finish()
597
+
598
+ if jupyter and not self.settings.silent:
599
+ ipython.display_html(
600
+ f"Successfully finished last run (ID:{latest_run._run_id}). Initializing new run:<br/>"
601
+ )
602
+ elif isinstance(wandb.run, Run):
603
+ manager = self._wl._get_manager()
604
+ # We shouldn't return a stale global run if we are in a new pid
605
+ if not manager or os.getpid() == wandb.run._init_pid:
606
+ logger.info("wandb.init() called when a run is still active")
607
+ with telemetry.context() as tel:
608
+ tel.feature.init_return_run = True
609
+ return wandb.run
610
+
611
+ logger.info("starting backend")
612
+
613
+ manager = self._wl._get_manager()
614
+ if manager:
615
+ logger.info("setting up manager")
616
+ manager._inform_init(
617
+ settings=self.settings.to_proto(), run_id=self.settings.run_id
618
+ )
619
+
620
+ mailbox = Mailbox()
621
+ backend = Backend(settings=self.settings, manager=manager, mailbox=mailbox)
622
+ backend.ensure_launched()
623
+ logger.info("backend started and connected")
624
+ # Make sure we are logged in
625
+ # wandb_login._login(_backend=backend, _settings=self.settings)
626
+
627
+ # resuming needs access to the server, check server_status()?
628
+ run = Run(
629
+ config=self.config,
630
+ settings=self.settings,
631
+ sweep_config=self.sweep_config,
632
+ launch_config=self.launch_config,
633
+ )
634
+
635
+ # Populate initial telemetry
636
+ with telemetry.context(run=run, obj=self._init_telemetry_obj) as tel:
637
+ tel.cli_version = wandb.__version__
638
+ tel.python_version = platform.python_version()
639
+ tel.platform = f"{platform.system()}-{platform.machine()}".lower()
640
+ hf_version = _huggingface_version()
641
+ if hf_version:
642
+ tel.huggingface_version = hf_version
643
+ if self.settings._jupyter:
644
+ tel.env.jupyter = True
645
+ if self.settings._ipython:
646
+ tel.env.ipython = True
647
+ if self.settings._colab:
648
+ tel.env.colab = True
649
+ if self.settings._kaggle:
650
+ tel.env.kaggle = True
651
+ if self.settings._windows:
652
+ tel.env.windows = True
653
+
654
+ if self.settings.launch:
655
+ tel.feature.launch = True
656
+
657
+ if self.settings._async_upload_concurrency_limit:
658
+ tel.feature.async_uploads = True
659
+
660
+ for module_name in telemetry.list_telemetry_imports(only_imported=True):
661
+ setattr(tel.imports_init, module_name, True)
662
+
663
+ # probe the active start method
664
+ active_start_method: Optional[str] = None
665
+ if self.settings.start_method == "thread":
666
+ active_start_method = self.settings.start_method
667
+ else:
668
+ active_start_method = getattr(
669
+ backend._multiprocessing, "get_start_method", lambda: None
670
+ )()
671
+
672
+ if active_start_method == "spawn":
673
+ tel.env.start_spawn = True
674
+ elif active_start_method == "fork":
675
+ tel.env.start_fork = True
676
+ elif active_start_method == "forkserver":
677
+ tel.env.start_forkserver = True
678
+ elif active_start_method == "thread":
679
+ tel.env.start_thread = True
680
+
681
+ if os.environ.get("PEX"):
682
+ tel.env.pex = True
683
+
684
+ if self.settings._aws_lambda:
685
+ tel.env.aws_lambda = True
686
+
687
+ if os.environ.get(wandb.env._DISABLE_SERVICE):
688
+ tel.feature.service_disabled = True
689
+
690
+ if manager:
691
+ tel.feature.service = True
692
+ if self.settings._flow_control_disabled:
693
+ tel.feature.flow_control_disabled = True
694
+ if self.settings._flow_control_custom:
695
+ tel.feature.flow_control_custom = True
696
+ if self.settings._require_core:
697
+ tel.feature.core = True
698
+
699
+ tel.env.maybe_mp = _maybe_mp_process(backend)
700
+
701
+ if not self.settings.label_disable:
702
+ if self.notebook:
703
+ run._label_probe_notebook(self.notebook)
704
+ else:
705
+ run._label_probe_main()
706
+
707
+ for deprecated_feature, msg in self.deprecated_features_used.items():
708
+ warning_message = f"`{deprecated_feature}` is deprecated. {msg}"
709
+ deprecate(
710
+ field_name=getattr(Deprecated, "init__" + deprecated_feature),
711
+ warning_message=warning_message,
712
+ run=run,
713
+ )
714
+
715
+ logger.info("updated telemetry")
716
+
717
+ run._set_library(self._wl)
718
+ run._set_backend(backend)
719
+ run._set_reporter(self._reporter)
720
+ run._set_teardown_hooks(self._teardown_hooks)
721
+
722
+ backend._hack_set_run(run)
723
+ assert backend.interface
724
+ mailbox.enable_keepalive()
725
+ backend.interface.publish_header()
726
+
727
+ # Using GitRepo() blocks & can be slow, depending on user's current git setup.
728
+ # We don't want to block run initialization/start request, so populate run's git
729
+ # info beforehand.
730
+ if not self.settings.disable_git:
731
+ run._populate_git_info()
732
+
733
+ run_result: Optional[pb.RunUpdateResult] = None
734
+
735
+ if self.settings._offline:
736
+ with telemetry.context(run=run) as tel:
737
+ tel.feature.offline = True
738
+
739
+ if self.settings.resume:
740
+ wandb.termwarn(
741
+ "`resume` will be ignored since W&B syncing is set to `offline`. "
742
+ f"Starting a new run with run id {run.id}."
743
+ )
744
+ error: Optional[wandb.errors.Error] = None
745
+
746
+ timeout = self.settings.init_timeout
747
+
748
+ logger.info(f"communicating run to backend with {timeout} second timeout")
749
+
750
+ run_init_handle = backend.interface.deliver_run(run)
751
+ result = run_init_handle.wait(
752
+ timeout=timeout,
753
+ on_progress=self._on_progress_init,
754
+ cancel=True,
755
+ )
756
+ if result:
757
+ run_result = result.run_result
758
+
759
+ if run_result is None:
760
+ error_message = (
761
+ f"Run initialization has timed out after {timeout} sec. "
762
+ f"\nPlease refer to the documentation for additional information: {wburls.get('doc_start_err')}"
763
+ )
764
+ # We're not certain whether the error we encountered is due to an issue
765
+ # with the server (a "CommError") or if it's a problem within the SDK (an "Error").
766
+ # This means that the error could be a result of the server being unresponsive,
767
+ # or it could be because we were unable to communicate with the wandb service.
768
+ error = CommError(error_message)
769
+ run_init_handle._cancel()
770
+ elif run_result.HasField("error"):
771
+ error = ProtobufErrorHandler.to_exception(run_result.error)
772
+
773
+ if error is not None:
774
+ logger.error(f"encountered error: {error}")
775
+ if not manager:
776
+ # Shutdown the backend and get rid of the logger
777
+ # we don't need to do console cleanup at this point
778
+ backend.cleanup()
779
+ self.teardown()
780
+ raise error
781
+
782
+ assert run_result is not None # for mypy
783
+
784
+ if not run_result.HasField("run"):
785
+ raise Error(
786
+ "It appears that something have gone wrong during the program execution as an unexpected missing field was encountered. "
787
+ "(run_result is missing the 'run' field)"
788
+ )
789
+
790
+ if run_result.run.resumed:
791
+ logger.info("run resumed")
792
+ with telemetry.context(run=run) as tel:
793
+ tel.feature.resumed = run_result.run.resumed
794
+
795
+ run._set_run_obj(run_result.run)
796
+
797
+ run._on_init()
798
+
799
+ logger.info("starting run threads in backend")
800
+ # initiate run (stats and metadata probing)
801
+
802
+ if manager:
803
+ manager._inform_start(
804
+ settings=self.settings.to_proto(), run_id=self.settings.run_id
805
+ )
806
+
807
+ assert backend.interface
808
+ assert run._run_obj
809
+
810
+ run_start_handle = backend.interface.deliver_run_start(run._run_obj)
811
+ # TODO: add progress to let user know we are doing something
812
+ run_start_result = run_start_handle.wait(timeout=30)
813
+ if run_start_result is None:
814
+ run_start_handle.abandon()
815
+
816
+ assert self._wl is not None
817
+ self._wl._global_run_stack.append(run)
818
+ self.run = run
819
+
820
+ run._handle_launch_artifact_overrides()
821
+ if (
822
+ self.settings.launch
823
+ and self.settings.launch_config_path
824
+ and os.path.exists(self.settings.launch_config_path)
825
+ ):
826
+ run.save(self.settings.launch_config_path)
827
+ # put artifacts in run config here
828
+ # since doing so earlier will cause an error
829
+ # as the run is not upserted
830
+ for k, v in self.init_artifact_config.items():
831
+ run.config.update({k: v}, allow_val_change=True)
832
+ job_artifact = run._launch_artifact_mapping.get(
833
+ wandb.util.LAUNCH_JOB_ARTIFACT_SLOT_NAME
834
+ )
835
+ if job_artifact:
836
+ run.use_artifact(job_artifact)
837
+
838
+ self.backend = backend
839
+ assert self._reporter
840
+ self._reporter.set_context(run=run)
841
+ run._on_start()
842
+ logger.info("run started, returning control to user process")
843
+ return run
844
+
845
+
846
+ def getcaller() -> None:
847
+ if not logger:
848
+ return None
849
+ src, line, func, stack = logger.findCaller(stack_info=True)
850
+ print("Problem at:", src, line, func)
851
+
852
+
853
+ def _attach(
854
+ attach_id: Optional[str] = None,
855
+ run_id: Optional[str] = None,
856
+ *,
857
+ run: Optional["Run"] = None,
858
+ ) -> Union[Run, RunDisabled, None]:
859
+ """Attach to a run currently executing in another process/thread.
860
+
861
+ Arguments:
862
+ attach_id: (str, optional) The id of the run or an attach identifier
863
+ that maps to a run.
864
+ run_id: (str, optional) The id of the run to attach to.
865
+ run: (Run, optional) The run instance to attach
866
+ """
867
+ attach_id = attach_id or run_id
868
+ if not ((attach_id is None) ^ (run is None)):
869
+ raise UsageError("Either (`attach_id` or `run_id`) or `run` must be specified")
870
+
871
+ attach_id = attach_id or (run._attach_id if run else None)
872
+
873
+ if attach_id is None:
874
+ raise UsageError(
875
+ "Either `attach_id` or `run_id` must be specified or `run` must have `_attach_id`"
876
+ )
877
+ wandb._assert_is_user_process()
878
+
879
+ _wl = wandb_setup._setup()
880
+ assert _wl
881
+
882
+ _set_logger(_wl._get_logger())
883
+ if logger is None:
884
+ raise UsageError("logger is not initialized")
885
+
886
+ manager = _wl._get_manager()
887
+ response = manager._inform_attach(attach_id=attach_id) if manager else None
888
+ if response is None:
889
+ raise UsageError(f"Unable to attach to run {attach_id}")
890
+
891
+ settings: Settings = copy.copy(_wl._settings)
892
+
893
+ settings.update(
894
+ {
895
+ "run_id": attach_id,
896
+ "_start_time": response._start_time.value,
897
+ "_start_datetime": response._start_datetime.value,
898
+ "_offline": response._offline.value,
899
+ },
900
+ source=Source.INIT,
901
+ )
902
+
903
+ # TODO: consolidate this codepath with wandb.init()
904
+ mailbox = Mailbox()
905
+ backend = Backend(settings=settings, manager=manager, mailbox=mailbox)
906
+ backend.ensure_launched()
907
+ logger.info("attach backend started and connected")
908
+
909
+ if run is None:
910
+ run = Run(settings=settings)
911
+ else:
912
+ run._init(settings=settings)
913
+ run._set_library(_wl)
914
+ run._set_backend(backend)
915
+ backend._hack_set_run(run)
916
+ assert backend.interface
917
+
918
+ mailbox.enable_keepalive()
919
+
920
+ attach_handle = backend.interface.deliver_attach(attach_id)
921
+ # TODO: add progress to let user know we are doing something
922
+ attach_result = attach_handle.wait(timeout=30)
923
+ if not attach_result:
924
+ attach_handle.abandon()
925
+ raise UsageError("Timeout attaching to run")
926
+ attach_response = attach_result.response.attach_response
927
+ if attach_response.error and attach_response.error.message:
928
+ raise UsageError(f"Failed to attach to run: {attach_response.error.message}")
929
+
930
+ run._set_run_obj(attach_response.run)
931
+ run._on_attach()
932
+ return run
933
+
934
+
935
+ def init(
936
+ job_type: Optional[str] = None,
937
+ dir: Optional[StrPath] = None,
938
+ config: Union[Dict, str, None] = None,
939
+ project: Optional[str] = None,
940
+ entity: Optional[str] = None,
941
+ reinit: Optional[bool] = None,
942
+ tags: Optional[Sequence] = None,
943
+ group: Optional[str] = None,
944
+ name: Optional[str] = None,
945
+ notes: Optional[str] = None,
946
+ magic: Optional[Union[dict, str, bool]] = None,
947
+ config_exclude_keys: Optional[List[str]] = None,
948
+ config_include_keys: Optional[List[str]] = None,
949
+ anonymous: Optional[str] = None,
950
+ mode: Optional[str] = None,
951
+ allow_val_change: Optional[bool] = None,
952
+ resume: Optional[Union[bool, str]] = None,
953
+ force: Optional[bool] = None,
954
+ tensorboard: Optional[bool] = None, # alias for sync_tensorboard
955
+ sync_tensorboard: Optional[bool] = None,
956
+ monitor_gym: Optional[bool] = None,
957
+ save_code: Optional[bool] = None,
958
+ id: Optional[str] = None,
959
+ fork_from: Optional[str] = None,
960
+ settings: Union[Settings, Dict[str, Any], None] = None,
961
+ ) -> Union[Run, RunDisabled, None]:
962
+ r"""Start a new run to track and log to W&B.
963
+
964
+ In an ML training pipeline, you could add `wandb.init()`
965
+ to the beginning of your training script as well as your evaluation
966
+ script, and each piece would be tracked as a run in W&B.
967
+
968
+ `wandb.init()` spawns a new background process to log data to a run, and it
969
+ also syncs data to wandb.ai by default, so you can see live visualizations.
970
+
971
+ Call `wandb.init()` to start a run before logging data with `wandb.log()`:
972
+ <!--yeadoc-test:init-method-log-->
973
+ ```python
974
+ import wandb
975
+
976
+ wandb.init()
977
+ # ... calculate metrics, generate media
978
+ wandb.log({"accuracy": 0.9})
979
+ ```
980
+
981
+ `wandb.init()` returns a run object, and you can also access the run object
982
+ via `wandb.run`:
983
+ <!--yeadoc-test:init-and-assert-global-->
984
+ ```python
985
+ import wandb
986
+
987
+ run = wandb.init()
988
+
989
+ assert run is wandb.run
990
+ ```
991
+
992
+ At the end of your script, we will automatically call `wandb.finish` to
993
+ finalize and cleanup the run. However, if you call `wandb.init` from a
994
+ child process, you must explicitly call `wandb.finish` at the end of the
995
+ child process.
996
+
997
+ For more on using `wandb.init()`, including detailed examples, check out our
998
+ [guide and FAQs](https://docs.wandb.ai/guides/track/launch).
999
+
1000
+ Arguments:
1001
+ project: (str, optional) The name of the project where you're sending
1002
+ the new run. If the project is not specified, the run is put in an
1003
+ "Uncategorized" project.
1004
+ entity: (str, optional) An entity is a username or team name where
1005
+ you're sending runs. This entity must exist before you can send runs
1006
+ there, so make sure to create your account or team in the UI before
1007
+ starting to log runs.
1008
+ If you don't specify an entity, the run will be sent to your default
1009
+ entity, which is usually your username. Change your default entity
1010
+ in [your settings](https://wandb.ai/settings) under "default location
1011
+ to create new projects".
1012
+ config: (dict, argparse, absl.flags, str, optional)
1013
+ This sets `wandb.config`, a dictionary-like object for saving inputs
1014
+ to your job, like hyperparameters for a model or settings for a data
1015
+ preprocessing job. The config will show up in a table in the UI that
1016
+ you can use to group, filter, and sort runs. Keys should not contain
1017
+ `.` in their names, and values should be under 10 MB.
1018
+ If dict, argparse or absl.flags: will load the key value pairs into
1019
+ the `wandb.config` object.
1020
+ If str: will look for a yaml file by that name, and load config from
1021
+ that file into the `wandb.config` object.
1022
+ save_code: (bool, optional) Turn this on to save the main script or
1023
+ notebook to W&B. This is valuable for improving experiment
1024
+ reproducibility and to diff code across experiments in the UI. By
1025
+ default this is off, but you can flip the default behavior to on
1026
+ in [your settings page](https://wandb.ai/settings).
1027
+ group: (str, optional) Specify a group to organize individual runs into
1028
+ a larger experiment. For example, you might be doing cross
1029
+ validation, or you might have multiple jobs that train and evaluate
1030
+ a model against different test sets. Group gives you a way to
1031
+ organize runs together into a larger whole, and you can toggle this
1032
+ on and off in the UI. For more details, see our
1033
+ [guide to grouping runs](https://docs.wandb.com/guides/runs/grouping).
1034
+ job_type: (str, optional) Specify the type of run, which is useful when
1035
+ you're grouping runs together into larger experiments using group.
1036
+ For example, you might have multiple jobs in a group, with job types
1037
+ like train and eval. Setting this makes it easy to filter and group
1038
+ similar runs together in the UI so you can compare apples to apples.
1039
+ tags: (list, optional) A list of strings, which will populate the list
1040
+ of tags on this run in the UI. Tags are useful for organizing runs
1041
+ together, or applying temporary labels like "baseline" or
1042
+ "production". It's easy to add and remove tags in the UI, or filter
1043
+ down to just runs with a specific tag.
1044
+ If you are resuming a run, its tags will be overwritten by the tags
1045
+ you pass to `wandb.init()`. If you want to add tags to a resumed run
1046
+ without overwriting its existing tags, use `run.tags += ["new_tag"]`
1047
+ after `wandb.init()`.
1048
+ name: (str, optional) A short display name for this run, which is how
1049
+ you'll identify this run in the UI. By default, we generate a random
1050
+ two-word name that lets you easily cross-reference runs from the
1051
+ table to charts. Keeping these run names short makes the chart
1052
+ legends and tables easier to read. If you're looking for a place to
1053
+ save your hyperparameters, we recommend saving those in config.
1054
+ notes: (str, optional) A longer description of the run, like a `-m` commit
1055
+ message in git. This helps you remember what you were doing when you
1056
+ ran this run.
1057
+ dir: (str or pathlib.Path, optional) An absolute path to a directory where
1058
+ metadata will be stored. When you call `download()` on an artifact,
1059
+ this is the directory where downloaded files will be saved. By default,
1060
+ this is the `./wandb` directory.
1061
+ resume: (bool, str, optional) Sets the resuming behavior. Options:
1062
+ `"allow"`, `"must"`, `"never"`, `"auto"` or `None`. Defaults to `None`.
1063
+ Cases:
1064
+ - `None` (default): If the new run has the same ID as a previous run,
1065
+ this run overwrites that data.
1066
+ - `"auto"` (or `True`): if the previous run on this machine crashed,
1067
+ automatically resume it. Otherwise, start a new run.
1068
+ - `"allow"`: if id is set with `init(id="UNIQUE_ID")` or
1069
+ `WANDB_RUN_ID="UNIQUE_ID"` and it is identical to a previous run,
1070
+ wandb will automatically resume the run with that id. Otherwise,
1071
+ wandb will start a new run.
1072
+ - `"never"`: if id is set with `init(id="UNIQUE_ID")` or
1073
+ `WANDB_RUN_ID="UNIQUE_ID"` and it is identical to a previous run,
1074
+ wandb will crash.
1075
+ - `"must"`: if id is set with `init(id="UNIQUE_ID")` or
1076
+ `WANDB_RUN_ID="UNIQUE_ID"` and it is identical to a previous run,
1077
+ wandb will automatically resume the run with the id. Otherwise,
1078
+ wandb will crash.
1079
+ See [our guide to resuming runs](https://docs.wandb.com/guides/runs/resuming)
1080
+ for more.
1081
+ reinit: (bool, optional) Allow multiple `wandb.init()` calls in the same
1082
+ process. (default: `False`)
1083
+ magic: (bool, dict, or str, optional) The bool controls whether we try to
1084
+ auto-instrument your script, capturing basic details of your run
1085
+ without you having to add more wandb code. (default: `False`)
1086
+ You can also pass a dict, json string, or yaml filename.
1087
+ config_exclude_keys: (list, optional) string keys to exclude from
1088
+ `wandb.config`.
1089
+ config_include_keys: (list, optional) string keys to include in
1090
+ `wandb.config`.
1091
+ anonymous: (str, optional) Controls anonymous data logging. Options:
1092
+ - `"never"` (default): requires you to link your W&B account before
1093
+ tracking the run, so you don't accidentally create an anonymous
1094
+ run.
1095
+ - `"allow"`: lets a logged-in user track runs with their account, but
1096
+ lets someone who is running the script without a W&B account see
1097
+ the charts in the UI.
1098
+ - `"must"`: sends the run to an anonymous account instead of to a
1099
+ signed-up user account.
1100
+ mode: (str, optional) Can be `"online"`, `"offline"` or `"disabled"`. Defaults to
1101
+ online.
1102
+ allow_val_change: (bool, optional) Whether to allow config values to
1103
+ change after setting the keys once. By default, we throw an exception
1104
+ if a config value is overwritten. If you want to track something
1105
+ like a varying learning rate at multiple times during training, use
1106
+ `wandb.log()` instead. (default: `False` in scripts, `True` in Jupyter)
1107
+ force: (bool, optional) If `True`, this crashes the script if a user isn't
1108
+ logged in to W&B. If `False`, this will let the script run in offline
1109
+ mode if a user isn't logged in to W&B. (default: `False`)
1110
+ sync_tensorboard: (bool, optional) Synchronize wandb logs from tensorboard or
1111
+ tensorboardX and save the relevant events file. (default: `False`)
1112
+ monitor_gym: (bool, optional) Automatically log videos of environment when
1113
+ using OpenAI Gym. (default: `False`)
1114
+ See [our guide to this integration](https://docs.wandb.com/guides/integrations/openai-gym).
1115
+ id: (str, optional) A unique ID for this run, used for resuming. It must
1116
+ be unique in the project, and if you delete a run you can't reuse
1117
+ the ID. Use the `name` field for a short descriptive name, or `config`
1118
+ for saving hyperparameters to compare across runs. The ID cannot
1119
+ contain the following special characters: `/\#?%:`.
1120
+ See [our guide to resuming runs](https://docs.wandb.com/guides/runs/resuming).
1121
+ fork_from: (str, optional) A string with the format {run_id}?_step={step} describing
1122
+ a moment in a previous run to fork a new run from. Creates a new run that picks up
1123
+ logging history from the specified run at the specified moment. The target run must
1124
+ be in the current project. Example: `fork_from="my-run-id?_step=1234"`.
1125
+
1126
+ Examples:
1127
+ ### Set where the run is logged
1128
+
1129
+ You can change where the run is logged, just like changing
1130
+ the organization, repository, and branch in git:
1131
+ ```python
1132
+ import wandb
1133
+
1134
+ user = "geoff"
1135
+ project = "capsules"
1136
+ display_name = "experiment-2021-10-31"
1137
+
1138
+ wandb.init(entity=user, project=project, name=display_name)
1139
+ ```
1140
+
1141
+ ### Add metadata about the run to the config
1142
+
1143
+ Pass a dictionary-style object as the `config` keyword argument to add
1144
+ metadata, like hyperparameters, to your run.
1145
+ <!--yeadoc-test:init-set-config-->
1146
+ ```python
1147
+ import wandb
1148
+
1149
+ config = {"lr": 3e-4, "batch_size": 32}
1150
+ config.update({"architecture": "resnet", "depth": 34})
1151
+ wandb.init(config=config)
1152
+ ```
1153
+
1154
+ Raises:
1155
+ Error: if some unknown or internal error happened during the run initialization.
1156
+ AuthenticationError: if the user failed to provide valid credentials.
1157
+ CommError: if there was a problem communicating with the WandB server.
1158
+ UsageError: if the user provided invalid arguments.
1159
+ KeyboardInterrupt: if user interrupts the run.
1160
+
1161
+ Returns:
1162
+ A `Run` object.
1163
+ """
1164
+ wandb._assert_is_user_process()
1165
+
1166
+ kwargs = dict(locals())
1167
+ error_seen = None
1168
+ except_exit = None
1169
+ run: Optional[Union[Run, RunDisabled]] = None
1170
+
1171
+ # convert fork_from into a version that can be passed to settings
1172
+ if fork_from is not None and resume is not None:
1173
+ raise ValueError("Cannot specify both `fork_from` and `resume`")
1174
+
1175
+ try:
1176
+ wi = _WandbInit()
1177
+ wi.setup(kwargs)
1178
+ assert wi.settings
1179
+ except_exit = wi.settings._except_exit
1180
+ try:
1181
+ run = wi.init()
1182
+ except_exit = wi.settings._except_exit
1183
+ except (KeyboardInterrupt, Exception) as e:
1184
+ if not isinstance(e, KeyboardInterrupt):
1185
+ wandb._sentry.exception(e)
1186
+ if not (
1187
+ wandb.wandb_agent._is_running() and isinstance(e, KeyboardInterrupt)
1188
+ ):
1189
+ getcaller()
1190
+ assert logger
1191
+ if wi.settings.problem == "fatal":
1192
+ raise
1193
+ if wi.settings.problem == "warn":
1194
+ pass
1195
+ # TODO(jhr): figure out how to make this RunDummy
1196
+ run = None
1197
+ except Error as e:
1198
+ if logger is not None:
1199
+ logger.exception(str(e))
1200
+ raise e
1201
+ except KeyboardInterrupt as e:
1202
+ assert logger
1203
+ logger.warning("interrupted", exc_info=e)
1204
+ raise e
1205
+ except Exception as e:
1206
+ error_seen = e
1207
+ traceback.print_exc()
1208
+ assert logger
1209
+ logger.error("error", exc_info=e)
1210
+ # Need to build delay into this sentry capture because our exit hooks
1211
+ # mess with sentry's ability to send out errors before the program ends.
1212
+ wandb._sentry.exception(e)
1213
+ # reraise(*sys.exc_info())
1214
+ finally:
1215
+ if error_seen:
1216
+ if except_exit:
1217
+ wandb.termerror("Abnormal program exit")
1218
+ os._exit(1)
1219
+ raise Error("An unexpected error occurred") from error_seen
1220
+ return run