chore: import upstream snapshot with attribution

python/ray/train/v2/_internal/migration_utils.py

@@ -0,0 +1,70 @@
+from ray.train.constants import V2_MIGRATION_GUIDE_MESSAGE
+
+FAIL_FAST_DEPRECATION_MESSAGE = (
+    "`ray.train.FailureConfig(fail_fast)` is deprecated since it is "
+    "only relevant in the context of multiple trials running in Ray Tune. "
+    "This parameter is still available in `ray.tune.FailureConfig` "
+    "for passing into a `ray.tune.Tuner`. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+TRAINER_RESOURCES_DEPRECATION_MESSAGE = (
+    "`ray.train.ScalingConfig(trainer_resources)` is deprecated. "
+    "This parameter was an advanced configuration that specified "
+    "resources for the Ray Train driver actor, which doesn't "
+    "need to reserve logical resources because it doesn't perform "
+    "any heavy computation. "
+    "Only the `resources_per_worker` parameter should be used "
+    "to specify resources for the training workers. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+VERBOSE_DEPRECATION_MESSAGE = (
+    "`ray.train.RunConfig(verbose)` is deprecated. "
+    "This parameter controls Ray Tune logging verbosity, "
+    "and is only relevant when using Ray Tune. "
+    "This parameter is still available in `ray.tune.RunConfig` "
+    "for passing into a `ray.tune.Tuner`. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+LOG_TO_FILE_DEPRECATION_MESSAGE = (
+    "`ray.train.RunConfig(log_to_file)` is deprecated. "
+    "The Ray Train driver actor and the training worker actors "
+    "already log stdout/stderr as part of Ray's logging system. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+STOP_DEPRECATION_MESSAGE = (
+    "`ray.train.RunConfig(stop)` is deprecated. "
+    "This parameter is only relevant when using Ray Tune "
+    "and is still available in `ray.tune.RunConfig` "
+    "for passing into a `ray.tune.Tuner`. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+CALLBACKS_DEPRECATION_MESSAGE = (
+    "`ray.train.RunConfig(callbacks: List[ray.tune.Callback])` is deprecated. "
+    "Ray Train no longer accepts Ray Tune callbacks, since the Ray Train "
+    "execution backend is being separated from Ray Tune. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+PROGRESS_REPORTER_DEPRECATION_MESSAGE = (
+    "`ray.train.RunConfig(progress_reporter)` is deprecated. "
+    "This parameter controls the Ray Tune console output reporter, "
+    "and is only relevant when using Ray Tune. "
+    "This parameter is still available in `ray.tune.RunConfig` "
+    "for passing into a `ray.tune.Tuner`. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)
+
+SYNC_CONFIG_DEPRECATION_MESSAGE = (
+    "`ray.train.RunConfig(sync_config)` is deprecated. "
+    "This configuration controls advanced syncing behavior, "
+    "which is either not supported or not relevant in the reworked Ray Train. "
+    "This parameter is still available in `ray.tune.RunConfig` "
+    "for passing into a `ray.tune.Tuner`. "
+    "The `SyncConfig` class has been moved to `ray.tune.SyncConfig`. "
+    f"{V2_MIGRATION_GUIDE_MESSAGE}"
+)