wandb 0.19.1rc1__py3-none-musllinux_1_2_aarch64.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (822) hide show
  1. package_readme.md +97 -0
  2. wandb/__init__.py +252 -0
  3. wandb/__init__.pyi +1197 -0
  4. wandb/__main__.py +3 -0
  5. wandb/_globals.py +19 -0
  6. wandb/agents/__init__.py +0 -0
  7. wandb/agents/pyagent.py +363 -0
  8. wandb/analytics/__init__.py +3 -0
  9. wandb/analytics/sentry.py +263 -0
  10. wandb/apis/__init__.py +48 -0
  11. wandb/apis/attrs.py +51 -0
  12. wandb/apis/importers/__init__.py +1 -0
  13. wandb/apis/importers/internals/internal.py +385 -0
  14. wandb/apis/importers/internals/protocols.py +103 -0
  15. wandb/apis/importers/internals/util.py +78 -0
  16. wandb/apis/importers/mlflow.py +254 -0
  17. wandb/apis/importers/validation.py +108 -0
  18. wandb/apis/importers/wandb.py +1603 -0
  19. wandb/apis/internal.py +232 -0
  20. wandb/apis/normalize.py +73 -0
  21. wandb/apis/paginator.py +81 -0
  22. wandb/apis/public/__init__.py +34 -0
  23. wandb/apis/public/api.py +1387 -0
  24. wandb/apis/public/artifacts.py +1095 -0
  25. wandb/apis/public/const.py +4 -0
  26. wandb/apis/public/files.py +263 -0
  27. wandb/apis/public/history.py +149 -0
  28. wandb/apis/public/jobs.py +653 -0
  29. wandb/apis/public/projects.py +154 -0
  30. wandb/apis/public/query_generator.py +166 -0
  31. wandb/apis/public/reports.py +458 -0
  32. wandb/apis/public/runs.py +1012 -0
  33. wandb/apis/public/sweeps.py +240 -0
  34. wandb/apis/public/teams.py +198 -0
  35. wandb/apis/public/users.py +136 -0
  36. wandb/apis/public/utils.py +68 -0
  37. wandb/apis/reports/__init__.py +1 -0
  38. wandb/apis/reports/v1/__init__.py +8 -0
  39. wandb/apis/reports/v2/__init__.py +8 -0
  40. wandb/apis/workspaces/__init__.py +8 -0
  41. wandb/beta/workflows.py +288 -0
  42. wandb/bin/gpu_stats +0 -0
  43. wandb/bin/wandb-core +0 -0
  44. wandb/cli/__init__.py +0 -0
  45. wandb/cli/beta.py +178 -0
  46. wandb/cli/cli.py +2812 -0
  47. wandb/data_types.py +66 -0
  48. wandb/docker/__init__.py +343 -0
  49. wandb/docker/auth.py +435 -0
  50. wandb/docker/wandb-entrypoint.sh +33 -0
  51. wandb/docker/www_authenticate.py +94 -0
  52. wandb/env.py +513 -0
  53. wandb/errors/__init__.py +17 -0
  54. wandb/errors/errors.py +37 -0
  55. wandb/errors/links.py +73 -0
  56. wandb/errors/term.py +415 -0
  57. wandb/errors/util.py +57 -0
  58. wandb/errors/warnings.py +2 -0
  59. wandb/filesync/__init__.py +0 -0
  60. wandb/filesync/dir_watcher.py +403 -0
  61. wandb/filesync/stats.py +100 -0
  62. wandb/filesync/step_checksum.py +142 -0
  63. wandb/filesync/step_prepare.py +179 -0
  64. wandb/filesync/step_upload.py +287 -0
  65. wandb/filesync/upload_job.py +142 -0
  66. wandb/integration/__init__.py +0 -0
  67. wandb/integration/catboost/__init__.py +5 -0
  68. wandb/integration/catboost/catboost.py +178 -0
  69. wandb/integration/cohere/__init__.py +3 -0
  70. wandb/integration/cohere/cohere.py +21 -0
  71. wandb/integration/cohere/resolver.py +347 -0
  72. wandb/integration/diffusers/__init__.py +3 -0
  73. wandb/integration/diffusers/autologger.py +76 -0
  74. wandb/integration/diffusers/pipeline_resolver.py +50 -0
  75. wandb/integration/diffusers/resolvers/__init__.py +9 -0
  76. wandb/integration/diffusers/resolvers/multimodal.py +882 -0
  77. wandb/integration/diffusers/resolvers/utils.py +102 -0
  78. wandb/integration/fastai/__init__.py +245 -0
  79. wandb/integration/gym/__init__.py +99 -0
  80. wandb/integration/huggingface/__init__.py +3 -0
  81. wandb/integration/huggingface/huggingface.py +18 -0
  82. wandb/integration/huggingface/resolver.py +213 -0
  83. wandb/integration/keras/__init__.py +11 -0
  84. wandb/integration/keras/callbacks/__init__.py +5 -0
  85. wandb/integration/keras/callbacks/metrics_logger.py +129 -0
  86. wandb/integration/keras/callbacks/model_checkpoint.py +188 -0
  87. wandb/integration/keras/callbacks/tables_builder.py +228 -0
  88. wandb/integration/keras/keras.py +1089 -0
  89. wandb/integration/kfp/__init__.py +6 -0
  90. wandb/integration/kfp/helpers.py +28 -0
  91. wandb/integration/kfp/kfp_patch.py +334 -0
  92. wandb/integration/kfp/wandb_logging.py +182 -0
  93. wandb/integration/langchain/__init__.py +3 -0
  94. wandb/integration/langchain/wandb_tracer.py +48 -0
  95. wandb/integration/lightgbm/__init__.py +239 -0
  96. wandb/integration/lightning/__init__.py +0 -0
  97. wandb/integration/lightning/fabric/__init__.py +3 -0
  98. wandb/integration/lightning/fabric/logger.py +764 -0
  99. wandb/integration/metaflow/__init__.py +3 -0
  100. wandb/integration/metaflow/metaflow.py +383 -0
  101. wandb/integration/openai/__init__.py +3 -0
  102. wandb/integration/openai/fine_tuning.py +480 -0
  103. wandb/integration/openai/openai.py +22 -0
  104. wandb/integration/openai/resolver.py +240 -0
  105. wandb/integration/prodigy/__init__.py +3 -0
  106. wandb/integration/prodigy/prodigy.py +299 -0
  107. wandb/integration/sacred/__init__.py +117 -0
  108. wandb/integration/sagemaker/__init__.py +12 -0
  109. wandb/integration/sagemaker/auth.py +28 -0
  110. wandb/integration/sagemaker/config.py +49 -0
  111. wandb/integration/sagemaker/files.py +3 -0
  112. wandb/integration/sagemaker/resources.py +34 -0
  113. wandb/integration/sb3/__init__.py +3 -0
  114. wandb/integration/sb3/sb3.py +147 -0
  115. wandb/integration/sklearn/__init__.py +37 -0
  116. wandb/integration/sklearn/calculate/__init__.py +32 -0
  117. wandb/integration/sklearn/calculate/calibration_curves.py +125 -0
  118. wandb/integration/sklearn/calculate/class_proportions.py +68 -0
  119. wandb/integration/sklearn/calculate/confusion_matrix.py +93 -0
  120. wandb/integration/sklearn/calculate/decision_boundaries.py +40 -0
  121. wandb/integration/sklearn/calculate/elbow_curve.py +55 -0
  122. wandb/integration/sklearn/calculate/feature_importances.py +67 -0
  123. wandb/integration/sklearn/calculate/learning_curve.py +64 -0
  124. wandb/integration/sklearn/calculate/outlier_candidates.py +69 -0
  125. wandb/integration/sklearn/calculate/residuals.py +86 -0
  126. wandb/integration/sklearn/calculate/silhouette.py +118 -0
  127. wandb/integration/sklearn/calculate/summary_metrics.py +62 -0
  128. wandb/integration/sklearn/plot/__init__.py +35 -0
  129. wandb/integration/sklearn/plot/classifier.py +329 -0
  130. wandb/integration/sklearn/plot/clusterer.py +146 -0
  131. wandb/integration/sklearn/plot/regressor.py +121 -0
  132. wandb/integration/sklearn/plot/shared.py +91 -0
  133. wandb/integration/sklearn/utils.py +183 -0
  134. wandb/integration/tensorboard/__init__.py +10 -0
  135. wandb/integration/tensorboard/log.py +354 -0
  136. wandb/integration/tensorboard/monkeypatch.py +186 -0
  137. wandb/integration/tensorflow/__init__.py +5 -0
  138. wandb/integration/tensorflow/estimator_hook.py +54 -0
  139. wandb/integration/torch/__init__.py +0 -0
  140. wandb/integration/torch/wandb_torch.py +554 -0
  141. wandb/integration/ultralytics/__init__.py +11 -0
  142. wandb/integration/ultralytics/bbox_utils.py +215 -0
  143. wandb/integration/ultralytics/callback.py +524 -0
  144. wandb/integration/ultralytics/classification_utils.py +83 -0
  145. wandb/integration/ultralytics/mask_utils.py +202 -0
  146. wandb/integration/ultralytics/pose_utils.py +103 -0
  147. wandb/integration/xgboost/__init__.py +11 -0
  148. wandb/integration/xgboost/xgboost.py +189 -0
  149. wandb/integration/yolov8/__init__.py +0 -0
  150. wandb/integration/yolov8/yolov8.py +284 -0
  151. wandb/jupyter.py +513 -0
  152. wandb/mpmain/__init__.py +0 -0
  153. wandb/mpmain/__main__.py +1 -0
  154. wandb/old/__init__.py +0 -0
  155. wandb/old/core.py +53 -0
  156. wandb/old/settings.py +173 -0
  157. wandb/old/summary.py +440 -0
  158. wandb/plot/__init__.py +28 -0
  159. wandb/plot/bar.py +70 -0
  160. wandb/plot/confusion_matrix.py +181 -0
  161. wandb/plot/custom_chart.py +124 -0
  162. wandb/plot/histogram.py +65 -0
  163. wandb/plot/line.py +74 -0
  164. wandb/plot/line_series.py +176 -0
  165. wandb/plot/pr_curve.py +185 -0
  166. wandb/plot/roc_curve.py +163 -0
  167. wandb/plot/scatter.py +66 -0
  168. wandb/plot/utils.py +183 -0
  169. wandb/plot/viz.py +41 -0
  170. wandb/proto/__init__.py +0 -0
  171. wandb/proto/v3/__init__.py +0 -0
  172. wandb/proto/v3/wandb_base_pb2.py +55 -0
  173. wandb/proto/v3/wandb_internal_pb2.py +1658 -0
  174. wandb/proto/v3/wandb_server_pb2.py +228 -0
  175. wandb/proto/v3/wandb_settings_pb2.py +122 -0
  176. wandb/proto/v3/wandb_telemetry_pb2.py +106 -0
  177. wandb/proto/v4/__init__.py +0 -0
  178. wandb/proto/v4/wandb_base_pb2.py +30 -0
  179. wandb/proto/v4/wandb_internal_pb2.py +370 -0
  180. wandb/proto/v4/wandb_server_pb2.py +67 -0
  181. wandb/proto/v4/wandb_settings_pb2.py +47 -0
  182. wandb/proto/v4/wandb_telemetry_pb2.py +41 -0
  183. wandb/proto/v5/wandb_base_pb2.py +31 -0
  184. wandb/proto/v5/wandb_internal_pb2.py +371 -0
  185. wandb/proto/v5/wandb_server_pb2.py +68 -0
  186. wandb/proto/v5/wandb_settings_pb2.py +48 -0
  187. wandb/proto/v5/wandb_telemetry_pb2.py +42 -0
  188. wandb/proto/wandb_base_pb2.py +10 -0
  189. wandb/proto/wandb_deprecated.py +45 -0
  190. wandb/proto/wandb_generate_deprecated.py +30 -0
  191. wandb/proto/wandb_generate_proto.py +49 -0
  192. wandb/proto/wandb_internal_pb2.py +16 -0
  193. wandb/proto/wandb_server_pb2.py +10 -0
  194. wandb/proto/wandb_settings_pb2.py +10 -0
  195. wandb/proto/wandb_telemetry_pb2.py +10 -0
  196. wandb/py.typed +0 -0
  197. wandb/sdk/__init__.py +37 -0
  198. wandb/sdk/artifacts/__init__.py +0 -0
  199. wandb/sdk/artifacts/_validators.py +121 -0
  200. wandb/sdk/artifacts/artifact.py +2364 -0
  201. wandb/sdk/artifacts/artifact_download_logger.py +43 -0
  202. wandb/sdk/artifacts/artifact_file_cache.py +249 -0
  203. wandb/sdk/artifacts/artifact_instance_cache.py +17 -0
  204. wandb/sdk/artifacts/artifact_manifest.py +75 -0
  205. wandb/sdk/artifacts/artifact_manifest_entry.py +249 -0
  206. wandb/sdk/artifacts/artifact_manifests/__init__.py +0 -0
  207. wandb/sdk/artifacts/artifact_manifests/artifact_manifest_v1.py +92 -0
  208. wandb/sdk/artifacts/artifact_saver.py +265 -0
  209. wandb/sdk/artifacts/artifact_state.py +11 -0
  210. wandb/sdk/artifacts/artifact_ttl.py +7 -0
  211. wandb/sdk/artifacts/exceptions.py +57 -0
  212. wandb/sdk/artifacts/staging.py +25 -0
  213. wandb/sdk/artifacts/storage_handler.py +62 -0
  214. wandb/sdk/artifacts/storage_handlers/__init__.py +0 -0
  215. wandb/sdk/artifacts/storage_handlers/azure_handler.py +213 -0
  216. wandb/sdk/artifacts/storage_handlers/gcs_handler.py +224 -0
  217. wandb/sdk/artifacts/storage_handlers/http_handler.py +114 -0
  218. wandb/sdk/artifacts/storage_handlers/local_file_handler.py +139 -0
  219. wandb/sdk/artifacts/storage_handlers/multi_handler.py +56 -0
  220. wandb/sdk/artifacts/storage_handlers/s3_handler.py +298 -0
  221. wandb/sdk/artifacts/storage_handlers/tracking_handler.py +72 -0
  222. wandb/sdk/artifacts/storage_handlers/wb_artifact_handler.py +135 -0
  223. wandb/sdk/artifacts/storage_handlers/wb_local_artifact_handler.py +74 -0
  224. wandb/sdk/artifacts/storage_layout.py +6 -0
  225. wandb/sdk/artifacts/storage_policies/__init__.py +4 -0
  226. wandb/sdk/artifacts/storage_policies/register.py +1 -0
  227. wandb/sdk/artifacts/storage_policies/wandb_storage_policy.py +378 -0
  228. wandb/sdk/artifacts/storage_policy.py +72 -0
  229. wandb/sdk/backend/__init__.py +0 -0
  230. wandb/sdk/backend/backend.py +221 -0
  231. wandb/sdk/data_types/__init__.py +0 -0
  232. wandb/sdk/data_types/_dtypes.py +918 -0
  233. wandb/sdk/data_types/_private.py +10 -0
  234. wandb/sdk/data_types/audio.py +165 -0
  235. wandb/sdk/data_types/base_types/__init__.py +0 -0
  236. wandb/sdk/data_types/base_types/json_metadata.py +55 -0
  237. wandb/sdk/data_types/base_types/media.py +376 -0
  238. wandb/sdk/data_types/base_types/wb_value.py +282 -0
  239. wandb/sdk/data_types/bokeh.py +70 -0
  240. wandb/sdk/data_types/graph.py +405 -0
  241. wandb/sdk/data_types/helper_types/__init__.py +0 -0
  242. wandb/sdk/data_types/helper_types/bounding_boxes_2d.py +305 -0
  243. wandb/sdk/data_types/helper_types/classes.py +159 -0
  244. wandb/sdk/data_types/helper_types/image_mask.py +241 -0
  245. wandb/sdk/data_types/histogram.py +94 -0
  246. wandb/sdk/data_types/html.py +115 -0
  247. wandb/sdk/data_types/image.py +847 -0
  248. wandb/sdk/data_types/molecule.py +241 -0
  249. wandb/sdk/data_types/object_3d.py +470 -0
  250. wandb/sdk/data_types/plotly.py +82 -0
  251. wandb/sdk/data_types/saved_model.py +445 -0
  252. wandb/sdk/data_types/table.py +1204 -0
  253. wandb/sdk/data_types/trace_tree.py +438 -0
  254. wandb/sdk/data_types/utils.py +228 -0
  255. wandb/sdk/data_types/video.py +268 -0
  256. wandb/sdk/integration_utils/__init__.py +0 -0
  257. wandb/sdk/integration_utils/auto_logging.py +232 -0
  258. wandb/sdk/integration_utils/data_logging.py +475 -0
  259. wandb/sdk/interface/__init__.py +0 -0
  260. wandb/sdk/interface/constants.py +4 -0
  261. wandb/sdk/interface/interface.py +1010 -0
  262. wandb/sdk/interface/interface_queue.py +53 -0
  263. wandb/sdk/interface/interface_relay.py +53 -0
  264. wandb/sdk/interface/interface_shared.py +546 -0
  265. wandb/sdk/interface/interface_sock.py +61 -0
  266. wandb/sdk/interface/message_future.py +27 -0
  267. wandb/sdk/interface/message_future_poll.py +50 -0
  268. wandb/sdk/interface/router.py +115 -0
  269. wandb/sdk/interface/router_queue.py +41 -0
  270. wandb/sdk/interface/router_relay.py +37 -0
  271. wandb/sdk/interface/router_sock.py +36 -0
  272. wandb/sdk/interface/summary_record.py +67 -0
  273. wandb/sdk/internal/__init__.py +0 -0
  274. wandb/sdk/internal/context.py +89 -0
  275. wandb/sdk/internal/datastore.py +297 -0
  276. wandb/sdk/internal/file_pusher.py +181 -0
  277. wandb/sdk/internal/file_stream.py +695 -0
  278. wandb/sdk/internal/flow_control.py +263 -0
  279. wandb/sdk/internal/handler.py +905 -0
  280. wandb/sdk/internal/internal.py +403 -0
  281. wandb/sdk/internal/internal_api.py +4587 -0
  282. wandb/sdk/internal/internal_util.py +97 -0
  283. wandb/sdk/internal/job_builder.py +638 -0
  284. wandb/sdk/internal/profiler.py +78 -0
  285. wandb/sdk/internal/progress.py +79 -0
  286. wandb/sdk/internal/run.py +25 -0
  287. wandb/sdk/internal/sample.py +70 -0
  288. wandb/sdk/internal/sender.py +1696 -0
  289. wandb/sdk/internal/sender_config.py +197 -0
  290. wandb/sdk/internal/settings_static.py +97 -0
  291. wandb/sdk/internal/system/__init__.py +0 -0
  292. wandb/sdk/internal/system/assets/__init__.py +25 -0
  293. wandb/sdk/internal/system/assets/aggregators.py +37 -0
  294. wandb/sdk/internal/system/assets/asset_registry.py +20 -0
  295. wandb/sdk/internal/system/assets/cpu.py +163 -0
  296. wandb/sdk/internal/system/assets/disk.py +210 -0
  297. wandb/sdk/internal/system/assets/gpu.py +416 -0
  298. wandb/sdk/internal/system/assets/gpu_amd.py +233 -0
  299. wandb/sdk/internal/system/assets/interfaces.py +205 -0
  300. wandb/sdk/internal/system/assets/ipu.py +177 -0
  301. wandb/sdk/internal/system/assets/memory.py +166 -0
  302. wandb/sdk/internal/system/assets/network.py +125 -0
  303. wandb/sdk/internal/system/assets/open_metrics.py +293 -0
  304. wandb/sdk/internal/system/assets/tpu.py +154 -0
  305. wandb/sdk/internal/system/assets/trainium.py +393 -0
  306. wandb/sdk/internal/system/env_probe_helpers.py +13 -0
  307. wandb/sdk/internal/system/system_info.py +250 -0
  308. wandb/sdk/internal/system/system_monitor.py +222 -0
  309. wandb/sdk/internal/tb_watcher.py +519 -0
  310. wandb/sdk/internal/thread_local_settings.py +18 -0
  311. wandb/sdk/internal/writer.py +204 -0
  312. wandb/sdk/launch/__init__.py +15 -0
  313. wandb/sdk/launch/_launch.py +331 -0
  314. wandb/sdk/launch/_launch_add.py +255 -0
  315. wandb/sdk/launch/_project_spec.py +566 -0
  316. wandb/sdk/launch/agent/__init__.py +5 -0
  317. wandb/sdk/launch/agent/agent.py +924 -0
  318. wandb/sdk/launch/agent/config.py +296 -0
  319. wandb/sdk/launch/agent/job_status_tracker.py +53 -0
  320. wandb/sdk/launch/agent/run_queue_item_file_saver.py +39 -0
  321. wandb/sdk/launch/builder/__init__.py +0 -0
  322. wandb/sdk/launch/builder/abstract.py +156 -0
  323. wandb/sdk/launch/builder/build.py +297 -0
  324. wandb/sdk/launch/builder/context_manager.py +235 -0
  325. wandb/sdk/launch/builder/docker_builder.py +177 -0
  326. wandb/sdk/launch/builder/kaniko_builder.py +594 -0
  327. wandb/sdk/launch/builder/noop.py +58 -0
  328. wandb/sdk/launch/builder/templates/_wandb_bootstrap.py +188 -0
  329. wandb/sdk/launch/builder/templates/dockerfile.py +92 -0
  330. wandb/sdk/launch/create_job.py +528 -0
  331. wandb/sdk/launch/environment/abstract.py +29 -0
  332. wandb/sdk/launch/environment/aws_environment.py +322 -0
  333. wandb/sdk/launch/environment/azure_environment.py +105 -0
  334. wandb/sdk/launch/environment/gcp_environment.py +335 -0
  335. wandb/sdk/launch/environment/local_environment.py +65 -0
  336. wandb/sdk/launch/errors.py +13 -0
  337. wandb/sdk/launch/git_reference.py +109 -0
  338. wandb/sdk/launch/inputs/files.py +148 -0
  339. wandb/sdk/launch/inputs/internal.py +315 -0
  340. wandb/sdk/launch/inputs/manage.py +113 -0
  341. wandb/sdk/launch/inputs/schema.py +39 -0
  342. wandb/sdk/launch/loader.py +249 -0
  343. wandb/sdk/launch/registry/abstract.py +48 -0
  344. wandb/sdk/launch/registry/anon.py +29 -0
  345. wandb/sdk/launch/registry/azure_container_registry.py +124 -0
  346. wandb/sdk/launch/registry/elastic_container_registry.py +192 -0
  347. wandb/sdk/launch/registry/google_artifact_registry.py +219 -0
  348. wandb/sdk/launch/registry/local_registry.py +65 -0
  349. wandb/sdk/launch/runner/__init__.py +0 -0
  350. wandb/sdk/launch/runner/abstract.py +185 -0
  351. wandb/sdk/launch/runner/kubernetes_monitor.py +472 -0
  352. wandb/sdk/launch/runner/kubernetes_runner.py +963 -0
  353. wandb/sdk/launch/runner/local_container.py +301 -0
  354. wandb/sdk/launch/runner/local_process.py +78 -0
  355. wandb/sdk/launch/runner/sagemaker_runner.py +426 -0
  356. wandb/sdk/launch/runner/vertex_runner.py +230 -0
  357. wandb/sdk/launch/sweeps/__init__.py +37 -0
  358. wandb/sdk/launch/sweeps/scheduler.py +740 -0
  359. wandb/sdk/launch/sweeps/scheduler_sweep.py +90 -0
  360. wandb/sdk/launch/sweeps/utils.py +316 -0
  361. wandb/sdk/launch/utils.py +747 -0
  362. wandb/sdk/launch/wandb_reference.py +138 -0
  363. wandb/sdk/lib/__init__.py +5 -0
  364. wandb/sdk/lib/apikey.py +269 -0
  365. wandb/sdk/lib/capped_dict.py +26 -0
  366. wandb/sdk/lib/config_util.py +101 -0
  367. wandb/sdk/lib/credentials.py +141 -0
  368. wandb/sdk/lib/deprecate.py +42 -0
  369. wandb/sdk/lib/disabled.py +29 -0
  370. wandb/sdk/lib/exit_hooks.py +54 -0
  371. wandb/sdk/lib/file_stream_utils.py +118 -0
  372. wandb/sdk/lib/filenames.py +64 -0
  373. wandb/sdk/lib/filesystem.py +372 -0
  374. wandb/sdk/lib/fsm.py +180 -0
  375. wandb/sdk/lib/gitlib.py +239 -0
  376. wandb/sdk/lib/gql_request.py +65 -0
  377. wandb/sdk/lib/handler_util.py +21 -0
  378. wandb/sdk/lib/hashutil.py +84 -0
  379. wandb/sdk/lib/import_hooks.py +275 -0
  380. wandb/sdk/lib/ipython.py +126 -0
  381. wandb/sdk/lib/json_util.py +80 -0
  382. wandb/sdk/lib/lazyloader.py +63 -0
  383. wandb/sdk/lib/mailbox.py +456 -0
  384. wandb/sdk/lib/module.py +78 -0
  385. wandb/sdk/lib/paths.py +106 -0
  386. wandb/sdk/lib/preinit.py +42 -0
  387. wandb/sdk/lib/printer.py +548 -0
  388. wandb/sdk/lib/progress.py +273 -0
  389. wandb/sdk/lib/proto_util.py +90 -0
  390. wandb/sdk/lib/redirect.py +845 -0
  391. wandb/sdk/lib/retry.py +289 -0
  392. wandb/sdk/lib/run_moment.py +72 -0
  393. wandb/sdk/lib/runid.py +12 -0
  394. wandb/sdk/lib/server.py +38 -0
  395. wandb/sdk/lib/service_connection.py +216 -0
  396. wandb/sdk/lib/service_token.py +94 -0
  397. wandb/sdk/lib/sock_client.py +290 -0
  398. wandb/sdk/lib/sparkline.py +44 -0
  399. wandb/sdk/lib/telemetry.py +100 -0
  400. wandb/sdk/lib/timed_input.py +133 -0
  401. wandb/sdk/lib/timer.py +19 -0
  402. wandb/sdk/service/__init__.py +0 -0
  403. wandb/sdk/service/_startup_debug.py +22 -0
  404. wandb/sdk/service/port_file.py +53 -0
  405. wandb/sdk/service/server.py +107 -0
  406. wandb/sdk/service/server_sock.py +274 -0
  407. wandb/sdk/service/service.py +242 -0
  408. wandb/sdk/service/streams.py +425 -0
  409. wandb/sdk/verify/__init__.py +0 -0
  410. wandb/sdk/verify/verify.py +501 -0
  411. wandb/sdk/wandb_alerts.py +12 -0
  412. wandb/sdk/wandb_config.py +322 -0
  413. wandb/sdk/wandb_helper.py +54 -0
  414. wandb/sdk/wandb_init.py +1313 -0
  415. wandb/sdk/wandb_login.py +339 -0
  416. wandb/sdk/wandb_metric.py +110 -0
  417. wandb/sdk/wandb_require.py +94 -0
  418. wandb/sdk/wandb_require_helpers.py +44 -0
  419. wandb/sdk/wandb_run.py +4066 -0
  420. wandb/sdk/wandb_settings.py +1309 -0
  421. wandb/sdk/wandb_setup.py +402 -0
  422. wandb/sdk/wandb_summary.py +150 -0
  423. wandb/sdk/wandb_sweep.py +119 -0
  424. wandb/sdk/wandb_sync.py +82 -0
  425. wandb/sdk/wandb_watch.py +150 -0
  426. wandb/sklearn.py +35 -0
  427. wandb/sync/__init__.py +3 -0
  428. wandb/sync/sync.py +442 -0
  429. wandb/trigger.py +29 -0
  430. wandb/util.py +1955 -0
  431. wandb/vendor/__init__.py +0 -0
  432. wandb/vendor/gql-0.2.0/setup.py +40 -0
  433. wandb/vendor/gql-0.2.0/tests/__init__.py +0 -0
  434. wandb/vendor/gql-0.2.0/tests/starwars/__init__.py +0 -0
  435. wandb/vendor/gql-0.2.0/tests/starwars/fixtures.py +96 -0
  436. wandb/vendor/gql-0.2.0/tests/starwars/schema.py +146 -0
  437. wandb/vendor/gql-0.2.0/tests/starwars/test_dsl.py +293 -0
  438. wandb/vendor/gql-0.2.0/tests/starwars/test_query.py +355 -0
  439. wandb/vendor/gql-0.2.0/tests/starwars/test_validation.py +171 -0
  440. wandb/vendor/gql-0.2.0/tests/test_client.py +31 -0
  441. wandb/vendor/gql-0.2.0/tests/test_transport.py +89 -0
  442. wandb/vendor/gql-0.2.0/wandb_gql/__init__.py +4 -0
  443. wandb/vendor/gql-0.2.0/wandb_gql/client.py +75 -0
  444. wandb/vendor/gql-0.2.0/wandb_gql/dsl.py +152 -0
  445. wandb/vendor/gql-0.2.0/wandb_gql/gql.py +10 -0
  446. wandb/vendor/gql-0.2.0/wandb_gql/transport/__init__.py +0 -0
  447. wandb/vendor/gql-0.2.0/wandb_gql/transport/http.py +6 -0
  448. wandb/vendor/gql-0.2.0/wandb_gql/transport/local_schema.py +15 -0
  449. wandb/vendor/gql-0.2.0/wandb_gql/transport/requests.py +46 -0
  450. wandb/vendor/gql-0.2.0/wandb_gql/utils.py +21 -0
  451. wandb/vendor/graphql-core-1.1/setup.py +86 -0
  452. wandb/vendor/graphql-core-1.1/wandb_graphql/__init__.py +287 -0
  453. wandb/vendor/graphql-core-1.1/wandb_graphql/error/__init__.py +6 -0
  454. wandb/vendor/graphql-core-1.1/wandb_graphql/error/base.py +42 -0
  455. wandb/vendor/graphql-core-1.1/wandb_graphql/error/format_error.py +11 -0
  456. wandb/vendor/graphql-core-1.1/wandb_graphql/error/located_error.py +29 -0
  457. wandb/vendor/graphql-core-1.1/wandb_graphql/error/syntax_error.py +36 -0
  458. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/__init__.py +26 -0
  459. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/base.py +311 -0
  460. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executor.py +398 -0
  461. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/__init__.py +0 -0
  462. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/asyncio.py +53 -0
  463. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/gevent.py +22 -0
  464. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/process.py +32 -0
  465. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/sync.py +7 -0
  466. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/thread.py +35 -0
  467. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/executors/utils.py +6 -0
  468. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/__init__.py +0 -0
  469. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/executor.py +66 -0
  470. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/fragment.py +252 -0
  471. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/resolver.py +151 -0
  472. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/experimental/utils.py +7 -0
  473. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/middleware.py +57 -0
  474. wandb/vendor/graphql-core-1.1/wandb_graphql/execution/values.py +145 -0
  475. wandb/vendor/graphql-core-1.1/wandb_graphql/graphql.py +60 -0
  476. wandb/vendor/graphql-core-1.1/wandb_graphql/language/__init__.py +0 -0
  477. wandb/vendor/graphql-core-1.1/wandb_graphql/language/ast.py +1349 -0
  478. wandb/vendor/graphql-core-1.1/wandb_graphql/language/base.py +19 -0
  479. wandb/vendor/graphql-core-1.1/wandb_graphql/language/lexer.py +435 -0
  480. wandb/vendor/graphql-core-1.1/wandb_graphql/language/location.py +30 -0
  481. wandb/vendor/graphql-core-1.1/wandb_graphql/language/parser.py +779 -0
  482. wandb/vendor/graphql-core-1.1/wandb_graphql/language/printer.py +193 -0
  483. wandb/vendor/graphql-core-1.1/wandb_graphql/language/source.py +18 -0
  484. wandb/vendor/graphql-core-1.1/wandb_graphql/language/visitor.py +222 -0
  485. wandb/vendor/graphql-core-1.1/wandb_graphql/language/visitor_meta.py +82 -0
  486. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/__init__.py +0 -0
  487. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/cached_property.py +17 -0
  488. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/contain_subset.py +28 -0
  489. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/default_ordered_dict.py +40 -0
  490. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/ordereddict.py +8 -0
  491. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/pair_set.py +43 -0
  492. wandb/vendor/graphql-core-1.1/wandb_graphql/pyutils/version.py +78 -0
  493. wandb/vendor/graphql-core-1.1/wandb_graphql/type/__init__.py +67 -0
  494. wandb/vendor/graphql-core-1.1/wandb_graphql/type/definition.py +619 -0
  495. wandb/vendor/graphql-core-1.1/wandb_graphql/type/directives.py +132 -0
  496. wandb/vendor/graphql-core-1.1/wandb_graphql/type/introspection.py +440 -0
  497. wandb/vendor/graphql-core-1.1/wandb_graphql/type/scalars.py +131 -0
  498. wandb/vendor/graphql-core-1.1/wandb_graphql/type/schema.py +100 -0
  499. wandb/vendor/graphql-core-1.1/wandb_graphql/type/typemap.py +145 -0
  500. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/__init__.py +0 -0
  501. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/assert_valid_name.py +9 -0
  502. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/ast_from_value.py +65 -0
  503. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/ast_to_code.py +49 -0
  504. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/ast_to_dict.py +24 -0
  505. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/base.py +75 -0
  506. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/build_ast_schema.py +291 -0
  507. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/build_client_schema.py +250 -0
  508. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/concat_ast.py +9 -0
  509. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/extend_schema.py +357 -0
  510. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/get_field_def.py +27 -0
  511. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/get_operation_ast.py +21 -0
  512. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/introspection_query.py +90 -0
  513. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/is_valid_literal_value.py +67 -0
  514. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/is_valid_value.py +66 -0
  515. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/quoted_or_list.py +21 -0
  516. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/schema_printer.py +168 -0
  517. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/suggestion_list.py +56 -0
  518. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/type_comparators.py +69 -0
  519. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/type_from_ast.py +21 -0
  520. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/type_info.py +149 -0
  521. wandb/vendor/graphql-core-1.1/wandb_graphql/utils/value_from_ast.py +69 -0
  522. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/__init__.py +4 -0
  523. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/__init__.py +79 -0
  524. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/arguments_of_correct_type.py +24 -0
  525. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/base.py +8 -0
  526. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/default_values_of_correct_type.py +44 -0
  527. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/fields_on_correct_type.py +113 -0
  528. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/fragments_on_composite_types.py +33 -0
  529. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_argument_names.py +70 -0
  530. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_directives.py +97 -0
  531. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_fragment_names.py +19 -0
  532. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/known_type_names.py +43 -0
  533. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/lone_anonymous_operation.py +23 -0
  534. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_fragment_cycles.py +59 -0
  535. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_undefined_variables.py +36 -0
  536. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_unused_fragments.py +38 -0
  537. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/no_unused_variables.py +37 -0
  538. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/overlapping_fields_can_be_merged.py +529 -0
  539. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/possible_fragment_spreads.py +44 -0
  540. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/provided_non_null_arguments.py +46 -0
  541. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/scalar_leafs.py +33 -0
  542. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_argument_names.py +32 -0
  543. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_fragment_names.py +28 -0
  544. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_input_field_names.py +33 -0
  545. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_operation_names.py +31 -0
  546. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/unique_variable_names.py +27 -0
  547. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/variables_are_input_types.py +21 -0
  548. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/rules/variables_in_allowed_position.py +53 -0
  549. wandb/vendor/graphql-core-1.1/wandb_graphql/validation/validation.py +158 -0
  550. wandb/vendor/promise-2.3.0/conftest.py +30 -0
  551. wandb/vendor/promise-2.3.0/setup.py +64 -0
  552. wandb/vendor/promise-2.3.0/tests/__init__.py +0 -0
  553. wandb/vendor/promise-2.3.0/tests/conftest.py +8 -0
  554. wandb/vendor/promise-2.3.0/tests/test_awaitable.py +32 -0
  555. wandb/vendor/promise-2.3.0/tests/test_awaitable_35.py +47 -0
  556. wandb/vendor/promise-2.3.0/tests/test_benchmark.py +116 -0
  557. wandb/vendor/promise-2.3.0/tests/test_complex_threads.py +23 -0
  558. wandb/vendor/promise-2.3.0/tests/test_dataloader.py +452 -0
  559. wandb/vendor/promise-2.3.0/tests/test_dataloader_awaitable_35.py +99 -0
  560. wandb/vendor/promise-2.3.0/tests/test_dataloader_extra.py +65 -0
  561. wandb/vendor/promise-2.3.0/tests/test_extra.py +670 -0
  562. wandb/vendor/promise-2.3.0/tests/test_issues.py +132 -0
  563. wandb/vendor/promise-2.3.0/tests/test_promise_list.py +70 -0
  564. wandb/vendor/promise-2.3.0/tests/test_spec.py +584 -0
  565. wandb/vendor/promise-2.3.0/tests/test_thread_safety.py +115 -0
  566. wandb/vendor/promise-2.3.0/tests/utils.py +3 -0
  567. wandb/vendor/promise-2.3.0/wandb_promise/__init__.py +38 -0
  568. wandb/vendor/promise-2.3.0/wandb_promise/async_.py +135 -0
  569. wandb/vendor/promise-2.3.0/wandb_promise/compat.py +32 -0
  570. wandb/vendor/promise-2.3.0/wandb_promise/dataloader.py +326 -0
  571. wandb/vendor/promise-2.3.0/wandb_promise/iterate_promise.py +12 -0
  572. wandb/vendor/promise-2.3.0/wandb_promise/promise.py +848 -0
  573. wandb/vendor/promise-2.3.0/wandb_promise/promise_list.py +151 -0
  574. wandb/vendor/promise-2.3.0/wandb_promise/pyutils/__init__.py +0 -0
  575. wandb/vendor/promise-2.3.0/wandb_promise/pyutils/version.py +83 -0
  576. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/__init__.py +0 -0
  577. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/asyncio.py +22 -0
  578. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/gevent.py +21 -0
  579. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/immediate.py +27 -0
  580. wandb/vendor/promise-2.3.0/wandb_promise/schedulers/thread.py +18 -0
  581. wandb/vendor/promise-2.3.0/wandb_promise/utils.py +56 -0
  582. wandb/vendor/pygments/__init__.py +90 -0
  583. wandb/vendor/pygments/cmdline.py +568 -0
  584. wandb/vendor/pygments/console.py +74 -0
  585. wandb/vendor/pygments/filter.py +74 -0
  586. wandb/vendor/pygments/filters/__init__.py +350 -0
  587. wandb/vendor/pygments/formatter.py +95 -0
  588. wandb/vendor/pygments/formatters/__init__.py +153 -0
  589. wandb/vendor/pygments/formatters/_mapping.py +85 -0
  590. wandb/vendor/pygments/formatters/bbcode.py +109 -0
  591. wandb/vendor/pygments/formatters/html.py +851 -0
  592. wandb/vendor/pygments/formatters/img.py +600 -0
  593. wandb/vendor/pygments/formatters/irc.py +182 -0
  594. wandb/vendor/pygments/formatters/latex.py +482 -0
  595. wandb/vendor/pygments/formatters/other.py +160 -0
  596. wandb/vendor/pygments/formatters/rtf.py +147 -0
  597. wandb/vendor/pygments/formatters/svg.py +153 -0
  598. wandb/vendor/pygments/formatters/terminal.py +136 -0
  599. wandb/vendor/pygments/formatters/terminal256.py +309 -0
  600. wandb/vendor/pygments/lexer.py +871 -0
  601. wandb/vendor/pygments/lexers/__init__.py +329 -0
  602. wandb/vendor/pygments/lexers/_asy_builtins.py +1645 -0
  603. wandb/vendor/pygments/lexers/_cl_builtins.py +232 -0
  604. wandb/vendor/pygments/lexers/_cocoa_builtins.py +72 -0
  605. wandb/vendor/pygments/lexers/_csound_builtins.py +1346 -0
  606. wandb/vendor/pygments/lexers/_lasso_builtins.py +5327 -0
  607. wandb/vendor/pygments/lexers/_lua_builtins.py +295 -0
  608. wandb/vendor/pygments/lexers/_mapping.py +500 -0
  609. wandb/vendor/pygments/lexers/_mql_builtins.py +1172 -0
  610. wandb/vendor/pygments/lexers/_openedge_builtins.py +2547 -0
  611. wandb/vendor/pygments/lexers/_php_builtins.py +4756 -0
  612. wandb/vendor/pygments/lexers/_postgres_builtins.py +621 -0
  613. wandb/vendor/pygments/lexers/_scilab_builtins.py +3094 -0
  614. wandb/vendor/pygments/lexers/_sourcemod_builtins.py +1163 -0
  615. wandb/vendor/pygments/lexers/_stan_builtins.py +532 -0
  616. wandb/vendor/pygments/lexers/_stata_builtins.py +419 -0
  617. wandb/vendor/pygments/lexers/_tsql_builtins.py +1004 -0
  618. wandb/vendor/pygments/lexers/_vim_builtins.py +1939 -0
  619. wandb/vendor/pygments/lexers/actionscript.py +240 -0
  620. wandb/vendor/pygments/lexers/agile.py +24 -0
  621. wandb/vendor/pygments/lexers/algebra.py +221 -0
  622. wandb/vendor/pygments/lexers/ambient.py +76 -0
  623. wandb/vendor/pygments/lexers/ampl.py +87 -0
  624. wandb/vendor/pygments/lexers/apl.py +101 -0
  625. wandb/vendor/pygments/lexers/archetype.py +318 -0
  626. wandb/vendor/pygments/lexers/asm.py +641 -0
  627. wandb/vendor/pygments/lexers/automation.py +374 -0
  628. wandb/vendor/pygments/lexers/basic.py +500 -0
  629. wandb/vendor/pygments/lexers/bibtex.py +160 -0
  630. wandb/vendor/pygments/lexers/business.py +612 -0
  631. wandb/vendor/pygments/lexers/c_cpp.py +252 -0
  632. wandb/vendor/pygments/lexers/c_like.py +541 -0
  633. wandb/vendor/pygments/lexers/capnproto.py +78 -0
  634. wandb/vendor/pygments/lexers/chapel.py +102 -0
  635. wandb/vendor/pygments/lexers/clean.py +288 -0
  636. wandb/vendor/pygments/lexers/compiled.py +34 -0
  637. wandb/vendor/pygments/lexers/configs.py +833 -0
  638. wandb/vendor/pygments/lexers/console.py +114 -0
  639. wandb/vendor/pygments/lexers/crystal.py +393 -0
  640. wandb/vendor/pygments/lexers/csound.py +366 -0
  641. wandb/vendor/pygments/lexers/css.py +689 -0
  642. wandb/vendor/pygments/lexers/d.py +251 -0
  643. wandb/vendor/pygments/lexers/dalvik.py +125 -0
  644. wandb/vendor/pygments/lexers/data.py +555 -0
  645. wandb/vendor/pygments/lexers/diff.py +165 -0
  646. wandb/vendor/pygments/lexers/dotnet.py +691 -0
  647. wandb/vendor/pygments/lexers/dsls.py +878 -0
  648. wandb/vendor/pygments/lexers/dylan.py +289 -0
  649. wandb/vendor/pygments/lexers/ecl.py +125 -0
  650. wandb/vendor/pygments/lexers/eiffel.py +65 -0
  651. wandb/vendor/pygments/lexers/elm.py +121 -0
  652. wandb/vendor/pygments/lexers/erlang.py +533 -0
  653. wandb/vendor/pygments/lexers/esoteric.py +277 -0
  654. wandb/vendor/pygments/lexers/ezhil.py +69 -0
  655. wandb/vendor/pygments/lexers/factor.py +344 -0
  656. wandb/vendor/pygments/lexers/fantom.py +250 -0
  657. wandb/vendor/pygments/lexers/felix.py +273 -0
  658. wandb/vendor/pygments/lexers/forth.py +177 -0
  659. wandb/vendor/pygments/lexers/fortran.py +205 -0
  660. wandb/vendor/pygments/lexers/foxpro.py +428 -0
  661. wandb/vendor/pygments/lexers/functional.py +21 -0
  662. wandb/vendor/pygments/lexers/go.py +101 -0
  663. wandb/vendor/pygments/lexers/grammar_notation.py +213 -0
  664. wandb/vendor/pygments/lexers/graph.py +80 -0
  665. wandb/vendor/pygments/lexers/graphics.py +553 -0
  666. wandb/vendor/pygments/lexers/haskell.py +843 -0
  667. wandb/vendor/pygments/lexers/haxe.py +936 -0
  668. wandb/vendor/pygments/lexers/hdl.py +382 -0
  669. wandb/vendor/pygments/lexers/hexdump.py +103 -0
  670. wandb/vendor/pygments/lexers/html.py +602 -0
  671. wandb/vendor/pygments/lexers/idl.py +270 -0
  672. wandb/vendor/pygments/lexers/igor.py +288 -0
  673. wandb/vendor/pygments/lexers/inferno.py +96 -0
  674. wandb/vendor/pygments/lexers/installers.py +322 -0
  675. wandb/vendor/pygments/lexers/int_fiction.py +1343 -0
  676. wandb/vendor/pygments/lexers/iolang.py +63 -0
  677. wandb/vendor/pygments/lexers/j.py +146 -0
  678. wandb/vendor/pygments/lexers/javascript.py +1525 -0
  679. wandb/vendor/pygments/lexers/julia.py +333 -0
  680. wandb/vendor/pygments/lexers/jvm.py +1573 -0
  681. wandb/vendor/pygments/lexers/lisp.py +2621 -0
  682. wandb/vendor/pygments/lexers/make.py +202 -0
  683. wandb/vendor/pygments/lexers/markup.py +595 -0
  684. wandb/vendor/pygments/lexers/math.py +21 -0
  685. wandb/vendor/pygments/lexers/matlab.py +663 -0
  686. wandb/vendor/pygments/lexers/ml.py +769 -0
  687. wandb/vendor/pygments/lexers/modeling.py +358 -0
  688. wandb/vendor/pygments/lexers/modula2.py +1561 -0
  689. wandb/vendor/pygments/lexers/monte.py +204 -0
  690. wandb/vendor/pygments/lexers/ncl.py +894 -0
  691. wandb/vendor/pygments/lexers/nimrod.py +159 -0
  692. wandb/vendor/pygments/lexers/nit.py +64 -0
  693. wandb/vendor/pygments/lexers/nix.py +136 -0
  694. wandb/vendor/pygments/lexers/oberon.py +105 -0
  695. wandb/vendor/pygments/lexers/objective.py +504 -0
  696. wandb/vendor/pygments/lexers/ooc.py +85 -0
  697. wandb/vendor/pygments/lexers/other.py +41 -0
  698. wandb/vendor/pygments/lexers/parasail.py +79 -0
  699. wandb/vendor/pygments/lexers/parsers.py +835 -0
  700. wandb/vendor/pygments/lexers/pascal.py +644 -0
  701. wandb/vendor/pygments/lexers/pawn.py +199 -0
  702. wandb/vendor/pygments/lexers/perl.py +620 -0
  703. wandb/vendor/pygments/lexers/php.py +267 -0
  704. wandb/vendor/pygments/lexers/praat.py +294 -0
  705. wandb/vendor/pygments/lexers/prolog.py +306 -0
  706. wandb/vendor/pygments/lexers/python.py +939 -0
  707. wandb/vendor/pygments/lexers/qvt.py +152 -0
  708. wandb/vendor/pygments/lexers/r.py +453 -0
  709. wandb/vendor/pygments/lexers/rdf.py +270 -0
  710. wandb/vendor/pygments/lexers/rebol.py +431 -0
  711. wandb/vendor/pygments/lexers/resource.py +85 -0
  712. wandb/vendor/pygments/lexers/rnc.py +67 -0
  713. wandb/vendor/pygments/lexers/roboconf.py +82 -0
  714. wandb/vendor/pygments/lexers/robotframework.py +560 -0
  715. wandb/vendor/pygments/lexers/ruby.py +519 -0
  716. wandb/vendor/pygments/lexers/rust.py +220 -0
  717. wandb/vendor/pygments/lexers/sas.py +228 -0
  718. wandb/vendor/pygments/lexers/scripting.py +1222 -0
  719. wandb/vendor/pygments/lexers/shell.py +794 -0
  720. wandb/vendor/pygments/lexers/smalltalk.py +195 -0
  721. wandb/vendor/pygments/lexers/smv.py +79 -0
  722. wandb/vendor/pygments/lexers/snobol.py +83 -0
  723. wandb/vendor/pygments/lexers/special.py +103 -0
  724. wandb/vendor/pygments/lexers/sql.py +681 -0
  725. wandb/vendor/pygments/lexers/stata.py +108 -0
  726. wandb/vendor/pygments/lexers/supercollider.py +90 -0
  727. wandb/vendor/pygments/lexers/tcl.py +145 -0
  728. wandb/vendor/pygments/lexers/templates.py +2283 -0
  729. wandb/vendor/pygments/lexers/testing.py +207 -0
  730. wandb/vendor/pygments/lexers/text.py +25 -0
  731. wandb/vendor/pygments/lexers/textedit.py +169 -0
  732. wandb/vendor/pygments/lexers/textfmts.py +297 -0
  733. wandb/vendor/pygments/lexers/theorem.py +458 -0
  734. wandb/vendor/pygments/lexers/trafficscript.py +54 -0
  735. wandb/vendor/pygments/lexers/typoscript.py +226 -0
  736. wandb/vendor/pygments/lexers/urbi.py +133 -0
  737. wandb/vendor/pygments/lexers/varnish.py +190 -0
  738. wandb/vendor/pygments/lexers/verification.py +111 -0
  739. wandb/vendor/pygments/lexers/web.py +24 -0
  740. wandb/vendor/pygments/lexers/webmisc.py +988 -0
  741. wandb/vendor/pygments/lexers/whiley.py +116 -0
  742. wandb/vendor/pygments/lexers/x10.py +69 -0
  743. wandb/vendor/pygments/modeline.py +44 -0
  744. wandb/vendor/pygments/plugin.py +68 -0
  745. wandb/vendor/pygments/regexopt.py +92 -0
  746. wandb/vendor/pygments/scanner.py +105 -0
  747. wandb/vendor/pygments/sphinxext.py +158 -0
  748. wandb/vendor/pygments/style.py +155 -0
  749. wandb/vendor/pygments/styles/__init__.py +80 -0
  750. wandb/vendor/pygments/styles/abap.py +29 -0
  751. wandb/vendor/pygments/styles/algol.py +63 -0
  752. wandb/vendor/pygments/styles/algol_nu.py +63 -0
  753. wandb/vendor/pygments/styles/arduino.py +98 -0
  754. wandb/vendor/pygments/styles/autumn.py +65 -0
  755. wandb/vendor/pygments/styles/borland.py +51 -0
  756. wandb/vendor/pygments/styles/bw.py +49 -0
  757. wandb/vendor/pygments/styles/colorful.py +81 -0
  758. wandb/vendor/pygments/styles/default.py +73 -0
  759. wandb/vendor/pygments/styles/emacs.py +72 -0
  760. wandb/vendor/pygments/styles/friendly.py +72 -0
  761. wandb/vendor/pygments/styles/fruity.py +42 -0
  762. wandb/vendor/pygments/styles/igor.py +29 -0
  763. wandb/vendor/pygments/styles/lovelace.py +97 -0
  764. wandb/vendor/pygments/styles/manni.py +75 -0
  765. wandb/vendor/pygments/styles/monokai.py +106 -0
  766. wandb/vendor/pygments/styles/murphy.py +80 -0
  767. wandb/vendor/pygments/styles/native.py +65 -0
  768. wandb/vendor/pygments/styles/paraiso_dark.py +125 -0
  769. wandb/vendor/pygments/styles/paraiso_light.py +125 -0
  770. wandb/vendor/pygments/styles/pastie.py +75 -0
  771. wandb/vendor/pygments/styles/perldoc.py +69 -0
  772. wandb/vendor/pygments/styles/rainbow_dash.py +89 -0
  773. wandb/vendor/pygments/styles/rrt.py +33 -0
  774. wandb/vendor/pygments/styles/sas.py +44 -0
  775. wandb/vendor/pygments/styles/stata.py +40 -0
  776. wandb/vendor/pygments/styles/tango.py +141 -0
  777. wandb/vendor/pygments/styles/trac.py +63 -0
  778. wandb/vendor/pygments/styles/vim.py +63 -0
  779. wandb/vendor/pygments/styles/vs.py +38 -0
  780. wandb/vendor/pygments/styles/xcode.py +51 -0
  781. wandb/vendor/pygments/token.py +213 -0
  782. wandb/vendor/pygments/unistring.py +217 -0
  783. wandb/vendor/pygments/util.py +388 -0
  784. wandb/vendor/pynvml/__init__.py +0 -0
  785. wandb/vendor/pynvml/pynvml.py +4779 -0
  786. wandb/vendor/watchdog_0_9_0/wandb_watchdog/__init__.py +17 -0
  787. wandb/vendor/watchdog_0_9_0/wandb_watchdog/events.py +615 -0
  788. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/__init__.py +98 -0
  789. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/api.py +369 -0
  790. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/fsevents.py +172 -0
  791. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/fsevents2.py +239 -0
  792. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/inotify.py +218 -0
  793. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/inotify_buffer.py +81 -0
  794. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/inotify_c.py +575 -0
  795. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/kqueue.py +730 -0
  796. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/polling.py +145 -0
  797. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/read_directory_changes.py +133 -0
  798. wandb/vendor/watchdog_0_9_0/wandb_watchdog/observers/winapi.py +348 -0
  799. wandb/vendor/watchdog_0_9_0/wandb_watchdog/patterns.py +265 -0
  800. wandb/vendor/watchdog_0_9_0/wandb_watchdog/tricks/__init__.py +174 -0
  801. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/__init__.py +151 -0
  802. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/bricks.py +249 -0
  803. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/compat.py +29 -0
  804. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/decorators.py +198 -0
  805. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/delayed_queue.py +88 -0
  806. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/dirsnapshot.py +293 -0
  807. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/echo.py +157 -0
  808. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/event_backport.py +41 -0
  809. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/importlib2.py +40 -0
  810. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/platform.py +57 -0
  811. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/unicode_paths.py +64 -0
  812. wandb/vendor/watchdog_0_9_0/wandb_watchdog/utils/win32stat.py +123 -0
  813. wandb/vendor/watchdog_0_9_0/wandb_watchdog/version.py +28 -0
  814. wandb/vendor/watchdog_0_9_0/wandb_watchdog/watchmedo.py +577 -0
  815. wandb/wandb_agent.py +588 -0
  816. wandb/wandb_controller.py +719 -0
  817. wandb/wandb_run.py +9 -0
  818. wandb-0.19.1rc1.dist-info/METADATA +223 -0
  819. wandb-0.19.1rc1.dist-info/RECORD +822 -0
  820. wandb-0.19.1rc1.dist-info/WHEEL +5 -0
  821. wandb-0.19.1rc1.dist-info/entry_points.txt +3 -0
  822. wandb-0.19.1rc1.dist-info/licenses/LICENSE +21 -0
wandb/vendor/pygments/formatters/html.py ADDED
@@ -0,0 +1,851 @@
1
+ # -*- coding: utf-8 -*-
2
+ """
3
+ pygments.formatters.html
4
+ ~~~~~~~~~~~~~~~~~~~~~~~~
5
+
6
+ Formatter for HTML output.
7
+
8
+ :copyright: Copyright 2006-2017 by the Pygments team, see AUTHORS.
9
+ :license: BSD, see LICENSE for details.
10
+ """
11
+
12
+ from __future__ import print_function
13
+
14
+ import os
15
+ import sys
16
+ import os.path
17
+
18
+ from pygments.formatter import Formatter
19
+ from pygments.token import Token, Text, STANDARD_TYPES
20
+ from pygments.util import get_bool_opt, get_int_opt, get_list_opt, \
21
+ StringIO, string_types, iteritems
22
+
23
+ try:
24
+ import ctags
25
+ except ImportError:
26
+ ctags = None
27
+
28
+ __all__ = ['HtmlFormatter']
29
+
30
+
31
+ _escape_html_table = {
32
+ ord('&'): u'&',
33
+ ord('<'): u'&lt;',
34
+ ord('>'): u'&gt;',
35
+ ord('"'): u'&quot;',
36
+ ord("'"): u'&#39;',
37
+ }
38
+
39
+
40
+ def escape_html(text, table=_escape_html_table):
41
+ """Escape &, <, > as well as single and double quotes for HTML."""
42
+ return text.translate(table)
43
+
44
+
45
+ def _get_ttype_class(ttype):
46
+ fname = STANDARD_TYPES.get(ttype)
47
+ if fname:
48
+ return fname
49
+ aname = ''
50
+ while fname is None:
51
+ aname = '-' + ttype[-1] + aname
52
+ ttype = ttype.parent
53
+ fname = STANDARD_TYPES.get(ttype)
54
+ return fname + aname
55
+
56
+
57
+ CSSFILE_TEMPLATE = '''\
58
+ td.linenos { background-color: #f0f0f0; padding-right: 10px; }
59
+ span.lineno { background-color: #f0f0f0; padding: 0 5px 0 5px; }
60
+ pre { line-height: 125%%; }
61
+ %(styledefs)s
62
+ '''
63
+
64
+ DOC_HEADER = '''\
65
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
66
+ "http://www.w3.org/TR/html4/strict.dtd">
67
+
68
+ <html>
69
+ <head>
70
+ <title>%(title)s</title>
71
+ <meta http-equiv="content-type" content="text/html; charset=%(encoding)s">
72
+ <style type="text/css">
73
+ ''' + CSSFILE_TEMPLATE + '''
74
+ </style>
75
+ </head>
76
+ <body>
77
+ <h2>%(title)s</h2>
78
+
79
+ '''
80
+
81
+ DOC_HEADER_EXTERNALCSS = '''\
82
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
83
+ "http://www.w3.org/TR/html4/strict.dtd">
84
+
85
+ <html>
86
+ <head>
87
+ <title>%(title)s</title>
88
+ <meta http-equiv="content-type" content="text/html; charset=%(encoding)s">
89
+ <link rel="stylesheet" href="%(cssfile)s" type="text/css">
90
+ </head>
91
+ <body>
92
+ <h2>%(title)s</h2>
93
+
94
+ '''
95
+
96
+ DOC_FOOTER = '''\
97
+ </body>
98
+ </html>
99
+ '''
100
+
101
+
102
+ class HtmlFormatter(Formatter):
103
+ r"""
104
+ Format tokens as HTML 4 ``<span>`` tags within a ``<pre>`` tag, wrapped
105
+ in a ``<div>`` tag. The ``<div>``'s CSS class can be set by the `cssclass`
106
+ option.
107
+
108
+ If the `linenos` option is set to ``"table"``, the ``<pre>`` is
109
+ additionally wrapped inside a ``<table>`` which has one row and two
110
+ cells: one containing the line numbers and one containing the code.
111
+ Example:
112
+
113
+ .. sourcecode:: html
114
+
115
+ <div class="highlight" >
116
+ <table><tr>
117
+ <td class="linenos" title="click to toggle"
118
+ onclick="with (this.firstChild.style)
119
+ { display = (display == '') ? 'none' : '' }">
120
+ <pre>1
121
+ 2</pre>
122
+ </td>
123
+ <td class="code">
124
+ <pre><span class="Ke">def </span><span class="NaFu">foo</span>(bar):
125
+ <span class="Ke">pass</span>
126
+ </pre>
127
+ </td>
128
+ </tr></table></div>
129
+
130
+ (whitespace added to improve clarity).
131
+
132
+ Wrapping can be disabled using the `nowrap` option.
133
+
134
+ A list of lines can be specified using the `hl_lines` option to make these
135
+ lines highlighted (as of Pygments 0.11).
136
+
137
+ With the `full` option, a complete HTML 4 document is output, including
138
+ the style definitions inside a ``<style>`` tag, or in a separate file if
139
+ the `cssfile` option is given.
140
+
141
+ When `tagsfile` is set to the path of a ctags index file, it is used to
142
+ generate hyperlinks from names to their definition. You must enable
143
+ `lineanchors` and run ctags with the `-n` option for this to work. The
144
+ `python-ctags` module from PyPI must be installed to use this feature;
145
+ otherwise a `RuntimeError` will be raised.
146
+
147
+ The `get_style_defs(arg='')` method of a `HtmlFormatter` returns a string
148
+ containing CSS rules for the CSS classes used by the formatter. The
149
+ argument `arg` can be used to specify additional CSS selectors that
150
+ are prepended to the classes. A call `fmter.get_style_defs('td .code')`
151
+ would result in the following CSS classes:
152
+
153
+ .. sourcecode:: css
154
+
155
+ td .code .kw { font-weight: bold; color: #00FF00 }
156
+ td .code .cm { color: #999999 }
157
+ ...
158
+
159
+ If you have Pygments 0.6 or higher, you can also pass a list or tuple to the
160
+ `get_style_defs()` method to request multiple prefixes for the tokens:
161
+
162
+ .. sourcecode:: python
163
+
164
+ formatter.get_style_defs(['div.syntax pre', 'pre.syntax'])
165
+
166
+ The output would then look like this:
167
+
168
+ .. sourcecode:: css
169
+
170
+ div.syntax pre .kw,
171
+ pre.syntax .kw { font-weight: bold; color: #00FF00 }
172
+ div.syntax pre .cm,
173
+ pre.syntax .cm { color: #999999 }
174
+ ...
175
+
176
+ Additional options accepted:
177
+
178
+ `nowrap`
179
+ If set to ``True``, don't wrap the tokens at all, not even inside a ``<pre>``
180
+ tag. This disables most other options (default: ``False``).
181
+
182
+ `full`
183
+ Tells the formatter to output a "full" document, i.e. a complete
184
+ self-contained document (default: ``False``).
185
+
186
+ `title`
187
+ If `full` is true, the title that should be used to caption the
188
+ document (default: ``''``).
189
+
190
+ `style`
191
+ The style to use, can be a string or a Style subclass (default:
192
+ ``'default'``). This option has no effect if the `cssfile`
193
+ and `noclobber_cssfile` option are given and the file specified in
194
+ `cssfile` exists.
195
+
196
+ `noclasses`
197
+ If set to true, token ``<span>`` tags will not use CSS classes, but
198
+ inline styles. This is not recommended for larger pieces of code since
199
+ it increases output size by quite a bit (default: ``False``).
200
+
201
+ `classprefix`
202
+ Since the token types use relatively short class names, they may clash
203
+ with some of your own class names. In this case you can use the
204
+ `classprefix` option to give a string to prepend to all Pygments-generated
205
+ CSS class names for token types.
206
+ Note that this option also affects the output of `get_style_defs()`.
207
+
208
+ `cssclass`
209
+ CSS class for the wrapping ``<div>`` tag (default: ``'highlight'``).
210
+ If you set this option, the default selector for `get_style_defs()`
211
+ will be this class.
212
+
213
+ .. versionadded:: 0.9
214
+ If you select the ``'table'`` line numbers, the wrapping table will
215
+ have a CSS class of this string plus ``'table'``, the default is
216
+ accordingly ``'highlighttable'``.
217
+
218
+ `cssstyles`
219
+ Inline CSS styles for the wrapping ``<div>`` tag (default: ``''``).
220
+
221
+ `prestyles`
222
+ Inline CSS styles for the ``<pre>`` tag (default: ``''``).
223
+
224
+ .. versionadded:: 0.11
225
+
226
+ `cssfile`
227
+ If the `full` option is true and this option is given, it must be the
228
+ name of an external file. If the filename does not include an absolute
229
+ path, the file's path will be assumed to be relative to the main output
230
+ file's path, if the latter can be found. The stylesheet is then written
231
+ to this file instead of the HTML file.
232
+
233
+ .. versionadded:: 0.6
234
+
235
+ `noclobber_cssfile`
236
+ If `cssfile` is given and the specified file exists, the css file will
237
+ not be overwritten. This allows the use of the `full` option in
238
+ combination with a user specified css file. Default is ``False``.
239
+
240
+ .. versionadded:: 1.1
241
+
242
+ `linenos`
243
+ If set to ``'table'``, output line numbers as a table with two cells,
244
+ one containing the line numbers, the other the whole code. This is
245
+ copy-and-paste-friendly, but may cause alignment problems with some
246
+ browsers or fonts. If set to ``'inline'``, the line numbers will be
247
+ integrated in the ``<pre>`` tag that contains the code (that setting
248
+ is *new in Pygments 0.8*).
249
+
250
+ For compatibility with Pygments 0.7 and earlier, every true value
251
+ except ``'inline'`` means the same as ``'table'`` (in particular, that
252
+ means also ``True``).
253
+
254
+ The default value is ``False``, which means no line numbers at all.
255
+
256
+ **Note:** with the default ("table") line number mechanism, the line
257
+ numbers and code can have different line heights in Internet Explorer
258
+ unless you give the enclosing ``<pre>`` tags an explicit ``line-height``
259
+ CSS property (you get the default line spacing with ``line-height:
260
+ 125%``).
261
+
262
+ `hl_lines`
263
+ Specify a list of lines to be highlighted.
264
+
265
+ .. versionadded:: 0.11
266
+
267
+ `linenostart`
268
+ The line number for the first line (default: ``1``).
269
+
270
+ `linenostep`
271
+ If set to a number n > 1, only every nth line number is printed.
272
+
273
+ `linenospecial`
274
+ If set to a number n > 0, every nth line number is given the CSS
275
+ class ``"special"`` (default: ``0``).
276
+
277
+ `nobackground`
278
+ If set to ``True``, the formatter won't output the background color
279
+ for the wrapping element (this automatically defaults to ``False``
280
+ when there is no wrapping element [eg: no argument for the
281
+ `get_syntax_defs` method given]) (default: ``False``).
282
+
283
+ .. versionadded:: 0.6
284
+
285
+ `lineseparator`
286
+ This string is output between lines of code. It defaults to ``"\n"``,
287
+ which is enough to break a line inside ``<pre>`` tags, but you can
288
+ e.g. set it to ``"<br>"`` to get HTML line breaks.
289
+
290
+ .. versionadded:: 0.7
291
+
292
+ `lineanchors`
293
+ If set to a nonempty string, e.g. ``foo``, the formatter will wrap each
294
+ output line in an anchor tag with a ``name`` of ``foo-linenumber``.
295
+ This allows easy linking to certain lines.
296
+
297
+ .. versionadded:: 0.9
298
+
299
+ `linespans`
300
+ If set to a nonempty string, e.g. ``foo``, the formatter will wrap each
301
+ output line in a span tag with an ``id`` of ``foo-linenumber``.
302
+ This allows easy access to lines via javascript.
303
+
304
+ .. versionadded:: 1.6
305
+
306
+ `anchorlinenos`
307
+ If set to `True`, will wrap line numbers in <a> tags. Used in
308
+ combination with `linenos` and `lineanchors`.
309
+
310
+ `tagsfile`
311
+ If set to the path of a ctags file, wrap names in anchor tags that
312
+ link to their definitions. `lineanchors` should be used, and the
313
+ tags file should specify line numbers (see the `-n` option to ctags).
314
+
315
+ .. versionadded:: 1.6
316
+
317
+ `tagurlformat`
318
+ A string formatting pattern used to generate links to ctags definitions.
319
+ Available variables are `%(path)s`, `%(fname)s` and `%(fext)s`.
320
+ Defaults to an empty string, resulting in just `#prefix-number` links.
321
+
322
+ .. versionadded:: 1.6
323
+
324
+ `filename`
325
+ A string used to generate a filename when rendering <pre> blocks,
326
+ for example if displaying source code.
327
+
328
+ .. versionadded:: 2.1
329
+
330
+
331
+ **Subclassing the HTML formatter**
332
+
333
+ .. versionadded:: 0.7
334
+
335
+ The HTML formatter is now built in a way that allows easy subclassing, thus
336
+ customizing the output HTML code. The `format()` method calls
337
+ `self._format_lines()` which returns a generator that yields tuples of ``(1,
338
+ line)``, where the ``1`` indicates that the ``line`` is a line of the
339
+ formatted source code.
340
+
341
+ If the `nowrap` option is set, the generator is the iterated over and the
342
+ resulting HTML is output.
343
+
344
+ Otherwise, `format()` calls `self.wrap()`, which wraps the generator with
345
+ other generators. These may add some HTML code to the one generated by
346
+ `_format_lines()`, either by modifying the lines generated by the latter,
347
+ then yielding them again with ``(1, line)``, and/or by yielding other HTML
348
+ code before or after the lines, with ``(0, html)``. The distinction between
349
+ source lines and other code makes it possible to wrap the generator multiple
350
+ times.
351
+
352
+ The default `wrap()` implementation adds a ``<div>`` and a ``<pre>`` tag.
353
+
354
+ A custom `HtmlFormatter` subclass could look like this:
355
+
356
+ .. sourcecode:: python
357
+
358
+ class CodeHtmlFormatter(HtmlFormatter):
359
+
360
+ def wrap(self, source, outfile):
361
+ return self._wrap_code(source)
362
+
363
+ def _wrap_code(self, source):
364
+ yield 0, '<code>'
365
+ for i, t in source:
366
+ if i == 1:
367
+ # it's a line of formatted code
368
+ t += '<br>'
369
+ yield i, t
370
+ yield 0, '</code>'
371
+
372
+ This results in wrapping the formatted lines with a ``<code>`` tag, where the
373
+ source lines are broken using ``<br>`` tags.
374
+
375
+ After calling `wrap()`, the `format()` method also adds the "line numbers"
376
+ and/or "full document" wrappers if the respective options are set. Then, all
377
+ HTML yielded by the wrapped generator is output.
378
+ """
379
+
380
+ name = 'HTML'
381
+ aliases = ['html']
382
+ filenames = ['*.html', '*.htm']
383
+
384
+ def __init__(self, **options):
385
+ Formatter.__init__(self, **options)
386
+ self.title = self._decodeifneeded(self.title)
387
+ self.nowrap = get_bool_opt(options, 'nowrap', False)
388
+ self.noclasses = get_bool_opt(options, 'noclasses', False)
389
+ self.classprefix = options.get('classprefix', '')
390
+ self.cssclass = self._decodeifneeded(options.get('cssclass', 'highlight'))
391
+ self.cssstyles = self._decodeifneeded(options.get('cssstyles', ''))
392
+ self.prestyles = self._decodeifneeded(options.get('prestyles', ''))
393
+ self.cssfile = self._decodeifneeded(options.get('cssfile', ''))
394
+ self.noclobber_cssfile = get_bool_opt(options, 'noclobber_cssfile', False)
395
+ self.tagsfile = self._decodeifneeded(options.get('tagsfile', ''))
396
+ self.tagurlformat = self._decodeifneeded(options.get('tagurlformat', ''))
397
+ self.filename = self._decodeifneeded(options.get('filename', ''))
398
+
399
+ if self.tagsfile:
400
+ if not ctags:
401
+ raise RuntimeError('The "ctags" package must to be installed '
402
+ 'to be able to use the "tagsfile" feature.')
403
+ self._ctags = ctags.CTags(self.tagsfile)
404
+
405
+ linenos = options.get('linenos', False)
406
+ if linenos == 'inline':
407
+ self.linenos = 2
408
+ elif linenos:
409
+ # compatibility with <= 0.7
410
+ self.linenos = 1
411
+ else:
412
+ self.linenos = 0
413
+ self.linenostart = abs(get_int_opt(options, 'linenostart', 1))
414
+ self.linenostep = abs(get_int_opt(options, 'linenostep', 1))
415
+ self.linenospecial = abs(get_int_opt(options, 'linenospecial', 0))
416
+ self.nobackground = get_bool_opt(options, 'nobackground', False)
417
+ self.lineseparator = options.get('lineseparator', '\n')
418
+ self.lineanchors = options.get('lineanchors', '')
419
+ self.linespans = options.get('linespans', '')
420
+ self.anchorlinenos = options.get('anchorlinenos', False)
421
+ self.hl_lines = set()
422
+ for lineno in get_list_opt(options, 'hl_lines', []):
423
+ try:
424
+ self.hl_lines.add(int(lineno))
425
+ except ValueError:
426
+ pass
427
+
428
+ self._create_stylesheet()
429
+
430
+ def _get_css_class(self, ttype):
431
+ """Return the css class of this token type prefixed with
432
+ the classprefix option."""
433
+ ttypeclass = _get_ttype_class(ttype)
434
+ if ttypeclass:
435
+ return self.classprefix + ttypeclass
436
+ return ''
437
+
438
+ def _get_css_classes(self, ttype):
439
+ """Return the css classes of this token type prefixed with
440
+ the classprefix option."""
441
+ cls = self._get_css_class(ttype)
442
+ while ttype not in STANDARD_TYPES:
443
+ ttype = ttype.parent
444
+ cls = self._get_css_class(ttype) + ' ' + cls
445
+ return cls
446
+
447
+ def _create_stylesheet(self):
448
+ t2c = self.ttype2class = {Token: ''}
449
+ c2s = self.class2style = {}
450
+ for ttype, ndef in self.style:
451
+ name = self._get_css_class(ttype)
452
+ style = ''
453
+ if ndef['color']:
454
+ style += 'color: #%s; ' % ndef['color']
455
+ if ndef['bold']:
456
+ style += 'font-weight: bold; '
457
+ if ndef['italic']:
458
+ style += 'font-style: italic; '
459
+ if ndef['underline']:
460
+ style += 'text-decoration: underline; '
461
+ if ndef['bgcolor']:
462
+ style += 'background-color: #%s; ' % ndef['bgcolor']
463
+ if ndef['border']:
464
+ style += 'border: 1px solid #%s; ' % ndef['border']
465
+ if style:
466
+ t2c[ttype] = name
467
+ # save len(ttype) to enable ordering the styles by
468
+ # hierarchy (necessary for CSS cascading rules!)
469
+ c2s[name] = (style[:-2], ttype, len(ttype))
470
+
471
+ def get_style_defs(self, arg=None):
472
+ """
473
+ Return CSS style definitions for the classes produced by the current
474
+ highlighting style. ``arg`` can be a string or list of selectors to
475
+ insert before the token type classes.
476
+ """
477
+ if arg is None:
478
+ arg = ('cssclass' in self.options and '.'+self.cssclass or '')
479
+ if isinstance(arg, string_types):
480
+ args = [arg]
481
+ else:
482
+ args = list(arg)
483
+
484
+ def prefix(cls):
485
+ if cls:
486
+ cls = '.' + cls
487
+ tmp = []
488
+ for arg in args:
489
+ tmp.append((arg and arg + ' ' or '') + cls)
490
+ return ', '.join(tmp)
491
+
492
+ styles = [(level, ttype, cls, style)
493
+ for cls, (style, ttype, level) in iteritems(self.class2style)
494
+ if cls and style]
495
+ styles.sort()
496
+ lines = ['%s { %s } /* %s */' % (prefix(cls), style, repr(ttype)[6:])
497
+ for (level, ttype, cls, style) in styles]
498
+ if arg and not self.nobackground and \
499
+ self.style.background_color is not None:
500
+ text_style = ''
501
+ if Text in self.ttype2class:
502
+ text_style = ' ' + self.class2style[self.ttype2class[Text]][0]
503
+ lines.insert(0, '%s { background: %s;%s }' %
504
+ (prefix(''), self.style.background_color, text_style))
505
+ if self.style.highlight_color is not None:
506
+ lines.insert(0, '%s.hll { background-color: %s }' %
507
+ (prefix(''), self.style.highlight_color))
508
+ return '\n'.join(lines)
509
+
510
+ def _decodeifneeded(self, value):
511
+ if isinstance(value, bytes):
512
+ if self.encoding:
513
+ return value.decode(self.encoding)
514
+ return value.decode()
515
+ return value
516
+
517
+ def _wrap_full(self, inner, outfile):
518
+ if self.cssfile:
519
+ if os.path.isabs(self.cssfile):
520
+ # it's an absolute filename
521
+ cssfilename = self.cssfile
522
+ else:
523
+ try:
524
+ filename = outfile.name
525
+ if not filename or filename[0] == '<':
526
+ # pseudo files, e.g. name == '<fdopen>'
527
+ raise AttributeError
528
+ cssfilename = os.path.join(os.path.dirname(filename),
529
+ self.cssfile)
530
+ except AttributeError:
531
+ print('Note: Cannot determine output file name, '
532
+ 'using current directory as base for the CSS file name',
533
+ file=sys.stderr)
534
+ cssfilename = self.cssfile
535
+ # write CSS file only if noclobber_cssfile isn't given as an option.
536
+ try:
537
+ if not os.path.exists(cssfilename) or not self.noclobber_cssfile:
538
+ cf = open(cssfilename, "w")
539
+ cf.write(CSSFILE_TEMPLATE %
540
+ {'styledefs': self.get_style_defs('body')})
541
+ cf.close()
542
+ except IOError as err:
543
+ err.strerror = 'Error writing CSS file: ' + err.strerror
544
+ raise
545
+
546
+ yield 0, (DOC_HEADER_EXTERNALCSS %
547
+ dict(title=self.title,
548
+ cssfile=self.cssfile,
549
+ encoding=self.encoding))
550
+ else:
551
+ yield 0, (DOC_HEADER %
552
+ dict(title=self.title,
553
+ styledefs=self.get_style_defs('body'),
554
+ encoding=self.encoding))
555
+
556
+ for t, line in inner:
557
+ yield t, line
558
+ yield 0, DOC_FOOTER
559
+
560
+ def _wrap_tablelinenos(self, inner):
561
+ dummyoutfile = StringIO()
562
+ lncount = 0
563
+ for t, line in inner:
564
+ if t:
565
+ lncount += 1
566
+ dummyoutfile.write(line)
567
+
568
+ fl = self.linenostart
569
+ mw = len(str(lncount + fl - 1))
570
+ sp = self.linenospecial
571
+ st = self.linenostep
572
+ la = self.lineanchors
573
+ aln = self.anchorlinenos
574
+ nocls = self.noclasses
575
+ if sp:
576
+ lines = []
577
+
578
+ for i in range(fl, fl+lncount):
579
+ if i % st == 0:
580
+ if i % sp == 0:
581
+ if aln:
582
+ lines.append('<a href="#%s-%d" class="special">%*d</a>' %
583
+ (la, i, mw, i))
584
+ else:
585
+ lines.append('<span class="special">%*d</span>' % (mw, i))
586
+ else:
587
+ if aln:
588
+ lines.append('<a href="#%s-%d">%*d</a>' % (la, i, mw, i))
589
+ else:
590
+ lines.append('%*d' % (mw, i))
591
+ else:
592
+ lines.append('')
593
+ ls = '\n'.join(lines)
594
+ else:
595
+ lines = []
596
+ for i in range(fl, fl+lncount):
597
+ if i % st == 0:
598
+ if aln:
599
+ lines.append('<a href="#%s-%d">%*d</a>' % (la, i, mw, i))
600
+ else:
601
+ lines.append('%*d' % (mw, i))
602
+ else:
603
+ lines.append('')
604
+ ls = '\n'.join(lines)
605
+
606
+ # in case you wonder about the seemingly redundant <div> here: since the
607
+ # content in the other cell also is wrapped in a div, some browsers in
608
+ # some configurations seem to mess up the formatting...
609
+ if nocls:
610
+ yield 0, ('<table class="%stable">' % self.cssclass +
611
+ '<tr><td><div class="linenodiv" '
612
+ 'style="background-color: #f0f0f0; padding-right: 10px">'
613
+ '<pre style="line-height: 125%">' +
614
+ ls + '</pre></div></td><td class="code">')
615
+ else:
616
+ yield 0, ('<table class="%stable">' % self.cssclass +
617
+ '<tr><td class="linenos"><div class="linenodiv"><pre>' +
618
+ ls + '</pre></div></td><td class="code">')
619
+ yield 0, dummyoutfile.getvalue()
620
+ yield 0, '</td></tr></table>'
621
+
622
+ def _wrap_inlinelinenos(self, inner):
623
+ # need a list of lines since we need the width of a single number :(
624
+ lines = list(inner)
625
+ sp = self.linenospecial
626
+ st = self.linenostep
627
+ num = self.linenostart
628
+ mw = len(str(len(lines) + num - 1))
629
+
630
+ if self.noclasses:
631
+ if sp:
632
+ for t, line in lines:
633
+ if num % sp == 0:
634
+ style = 'background-color: #ffffc0; padding: 0 5px 0 5px'
635
+ else:
636
+ style = 'background-color: #f0f0f0; padding: 0 5px 0 5px'
637
+ yield 1, '<span style="%s">%*s </span>' % (
638
+ style, mw, (num % st and ' ' or num)) + line
639
+ num += 1
640
+ else:
641
+ for t, line in lines:
642
+ yield 1, ('<span style="background-color: #f0f0f0; '
643
+ 'padding: 0 5px 0 5px">%*s </span>' % (
644
+ mw, (num % st and ' ' or num)) + line)
645
+ num += 1
646
+ elif sp:
647
+ for t, line in lines:
648
+ yield 1, '<span class="lineno%s">%*s </span>' % (
649
+ num % sp == 0 and ' special' or '', mw,
650
+ (num % st and ' ' or num)) + line
651
+ num += 1
652
+ else:
653
+ for t, line in lines:
654
+ yield 1, '<span class="lineno">%*s </span>' % (
655
+ mw, (num % st and ' ' or num)) + line
656
+ num += 1
657
+
658
+ def _wrap_lineanchors(self, inner):
659
+ s = self.lineanchors
660
+ # subtract 1 since we have to increment i *before* yielding
661
+ i = self.linenostart - 1
662
+ for t, line in inner:
663
+ if t:
664
+ i += 1
665
+ yield 1, '<a name="%s-%d"></a>' % (s, i) + line
666
+ else:
667
+ yield 0, line
668
+
669
+ def _wrap_linespans(self, inner):
670
+ s = self.linespans
671
+ i = self.linenostart - 1
672
+ for t, line in inner:
673
+ if t:
674
+ i += 1
675
+ yield 1, '<span id="%s-%d">%s</span>' % (s, i, line)
676
+ else:
677
+ yield 0, line
678
+
679
+ def _wrap_div(self, inner):
680
+ style = []
681
+ if (self.noclasses and not self.nobackground and
682
+ self.style.background_color is not None):
683
+ style.append('background: %s' % (self.style.background_color,))
684
+ if self.cssstyles:
685
+ style.append(self.cssstyles)
686
+ style = '; '.join(style)
687
+
688
+ yield 0, ('<div' + (self.cssclass and ' class="%s"' % self.cssclass) +
689
+ (style and (' style="%s"' % style)) + '>')
690
+ for tup in inner:
691
+ yield tup
692
+ yield 0, '</div>\n'
693
+
694
+ def _wrap_pre(self, inner):
695
+ style = []
696
+ if self.prestyles:
697
+ style.append(self.prestyles)
698
+ if self.noclasses:
699
+ style.append('line-height: 125%')
700
+ style = '; '.join(style)
701
+
702
+ if self.filename:
703
+ yield 0, ('<span class="filename">' + self.filename + '</span>')
704
+
705
+ # the empty span here is to keep leading empty lines from being
706
+ # ignored by HTML parsers
707
+ yield 0, ('<pre' + (style and ' style="%s"' % style) + '><span></span>')
708
+ for tup in inner:
709
+ yield tup
710
+ yield 0, '</pre>'
711
+
712
+ def _format_lines(self, tokensource):
713
+ """
714
+ Just format the tokens, without any wrapping tags.
715
+ Yield individual lines.
716
+ """
717
+ nocls = self.noclasses
718
+ lsep = self.lineseparator
719
+ # for <span style=""> lookup only
720
+ getcls = self.ttype2class.get
721
+ c2s = self.class2style
722
+ escape_table = _escape_html_table
723
+ tagsfile = self.tagsfile
724
+
725
+ lspan = ''
726
+ line = []
727
+ for ttype, value in tokensource:
728
+ if nocls:
729
+ cclass = getcls(ttype)
730
+ while cclass is None:
731
+ ttype = ttype.parent
732
+ cclass = getcls(ttype)
733
+ cspan = cclass and '<span style="%s">' % c2s[cclass][0] or ''
734
+ else:
735
+ cls = self._get_css_classes(ttype)
736
+ cspan = cls and '<span class="%s">' % cls or ''
737
+
738
+ parts = value.translate(escape_table).split('\n')
739
+
740
+ if tagsfile and ttype in Token.Name:
741
+ filename, linenumber = self._lookup_ctag(value)
742
+ if linenumber:
743
+ base, filename = os.path.split(filename)
744
+ if base:
745
+ base += '/'
746
+ filename, extension = os.path.splitext(filename)
747
+ url = self.tagurlformat % {'path': base, 'fname': filename,
748
+ 'fext': extension}
749
+ parts[0] = "<a href=\"%s#%s-%d\">%s" % \
750
+ (url, self.lineanchors, linenumber, parts[0])
751
+ parts[-1] = parts[-1] + "</a>"
752
+
753
+ # for all but the last line
754
+ for part in parts[:-1]:
755
+ if line:
756
+ if lspan != cspan:
757
+ line.extend(((lspan and '</span>'), cspan, part,
758
+ (cspan and '</span>'), lsep))
759
+ else: # both are the same
760
+ line.extend((part, (lspan and '</span>'), lsep))
761
+ yield 1, ''.join(line)
762
+ line = []
763
+ elif part:
764
+ yield 1, ''.join((cspan, part, (cspan and '</span>'), lsep))
765
+ else:
766
+ yield 1, lsep
767
+ # for the last line
768
+ if line and parts[-1]:
769
+ if lspan != cspan:
770
+ line.extend(((lspan and '</span>'), cspan, parts[-1]))
771
+ lspan = cspan
772
+ else:
773
+ line.append(parts[-1])
774
+ elif parts[-1]:
775
+ line = [cspan, parts[-1]]
776
+ lspan = cspan
777
+ # else we neither have to open a new span nor set lspan
778
+
779
+ if line:
780
+ line.extend(((lspan and '</span>'), lsep))
781
+ yield 1, ''.join(line)
782
+
783
+ def _lookup_ctag(self, token):
784
+ entry = ctags.TagEntry()
785
+ if self._ctags.find(entry, token, 0):
786
+ return entry['file'], entry['lineNumber']
787
+ else:
788
+ return None, None
789
+
790
+ def _highlight_lines(self, tokensource):
791
+ """
792
+ Highlighted the lines specified in the `hl_lines` option by
793
+ post-processing the token stream coming from `_format_lines`.
794
+ """
795
+ hls = self.hl_lines
796
+
797
+ for i, (t, value) in enumerate(tokensource):
798
+ if t != 1:
799
+ yield t, value
800
+ if i + 1 in hls: # i + 1 because Python indexes start at 0
801
+ if self.noclasses:
802
+ style = ''
803
+ if self.style.highlight_color is not None:
804
+ style = (' style="background-color: %s"' %
805
+ (self.style.highlight_color,))
806
+ yield 1, '<span%s>%s</span>' % (style, value)
807
+ else:
808
+ yield 1, '<span class="hll">%s</span>' % value
809
+ else:
810
+ yield 1, value
811
+
812
+ def wrap(self, source, outfile):
813
+ """
814
+ Wrap the ``source``, which is a generator yielding
815
+ individual lines, in custom generators. See docstring
816
+ for `format`. Can be overridden.
817
+ """
818
+ return self._wrap_div(self._wrap_pre(source))
819
+
820
+ def format_unencoded(self, tokensource, outfile):
821
+ """
822
+ The formatting process uses several nested generators; which of
823
+ them are used is determined by the user's options.
824
+
825
+ Each generator should take at least one argument, ``inner``,
826
+ and wrap the pieces of text generated by this.
827
+
828
+ Always yield 2-tuples: (code, text). If "code" is 1, the text
829
+ is part of the original tokensource being highlighted, if it's
830
+ 0, the text is some piece of wrapping. This makes it possible to
831
+ use several different wrappers that process the original source
832
+ linewise, e.g. line number generators.
833
+ """
834
+ source = self._format_lines(tokensource)
835
+ if self.hl_lines:
836
+ source = self._highlight_lines(source)
837
+ if not self.nowrap:
838
+ if self.linenos == 2:
839
+ source = self._wrap_inlinelinenos(source)
840
+ if self.lineanchors:
841
+ source = self._wrap_lineanchors(source)
842
+ if self.linespans:
843
+ source = self._wrap_linespans(source)
844
+ source = self.wrap(source, outfile)
845
+ if self.linenos == 1:
846
+ source = self._wrap_tablelinenos(source)
847
+ if self.full:
848
+ source = self._wrap_full(source, outfile)
849
+
850
+ for t, piece in source:
851
+ outfile.write(piece)