def initialize_session(
train_func,
world_rank,
local_rank,
world_size,
trial_info,
checkpoint,
dataset_shard,
encode_data_fn,
):
try:
init_session(
training_func=train_func,
world_rank=world_rank,
local_rank=local_rank,
world_size=world_size,
trial_info=trial_info,
dataset_shard=dataset_shard,
checkpoint=checkpoint,
encode_data_fn=encode_data_fn,
detailed_autofilled_metrics=use_detailed_autofilled_metrics,
)
except ValueError:
raise TrainBackendError(
"Attempting to start training but a "
"previous training run is still ongoing. "
"You must call `finish_training` before "
"calling `start_training` again.")
def session():
def f():
return 1
init_session(training_func=f, world_rank=0, local_rank=0, world_size=1)
yield get_session()
shutdown_session()
def test_encode_data():
def train_func():
save_checkpoint(epoch=0)
report(epoch=1)
def encode_checkpoint(checkpoint):
checkpoint.update({"encoded": True})
return checkpoint
def validate_encoded(result_type: TrainingResultType):
next = session.get_next()
assert next.type is result_type
assert next.data["encoded"] is True
init_session(
training_func=train_func,
world_rank=0,
local_rank=0,
world_size=1,
encode_data_fn=encode_checkpoint,
)
session = get_session()
session.start()
# Validate checkpoint is encoded.
validate_encoded(TrainingResultType.CHECKPOINT)
# Validate report is encoded.
validate_encoded(TrainingResultType.REPORT)
session.finish()
shutdown_session()
def test_get_dataset_shard():
dataset = ray.data.from_items([1, 2, 3])
init_session(
training_func=lambda: 1,
world_rank=0,
local_rank=0,
world_size=1,
dataset_shard=dataset,
)
assert get_dataset_shard() == dataset
shutdown_session()
def test_report():
def train_func():
for i in range(2):
report(loss=i)
init_session(training_func=train_func,
world_rank=0,
local_rank=0,
world_size=1)
session = get_session()
session.start()
assert session.get_next().data["loss"] == 0
assert session.get_next().data["loss"] == 1
shutdown_session()
def test_report_fail():
def train_func():
for i in range(2):
report(i)
return 1
init_session(training_func=train_func,
world_rank=0,
local_rank=0,
world_size=1)
session = get_session()
session.start()
assert session.get_next() is None
with pytest.raises(TypeError):
session.finish()
shutdown_session()
def test_load_checkpoint_after_save():
def train_func():
for i in range(2):
save_checkpoint(epoch=i)
checkpoint = load_checkpoint()
assert checkpoint["epoch"] == i
init_session(training_func=train_func,
world_rank=0,
local_rank=0,
world_size=1)
session = get_session()
session.start()
for i in range(2):
session.get_next()
session.finish()
shutdown_session()
def test_checkpoint():
def train_func():
for i in range(2):
save_checkpoint(epoch=i)
def validate_zero(expected):
next = session.get_next()
assert next is not None
assert next.type == TrainingResultType.CHECKPOINT
assert next.data["epoch"] == expected
init_session(training_func=train_func,
world_rank=0,
local_rank=0,
world_size=1)
session = get_session()
session.start()
validate_zero(0)
validate_zero(1)
session.finish()
shutdown_session()
def validate_nonzero():
next = session.get_next()
assert next is not None
assert next.type == TrainingResultType.CHECKPOINT
assert next.data == {}
init_session(training_func=train_func,
world_rank=1,
local_rank=1,
world_size=1)
session = get_session()
session.start()
validate_nonzero()
validate_nonzero()
session.finish()
shutdown_session()
def test_locking():
"""Tests that report pauses training until fetch_next or finish."""
def train_1():
import _thread
_thread.interrupt_main()
init_session(training_func=train_1,
world_rank=0,
local_rank=0,
world_size=1)
session = get_session()
with pytest.raises(KeyboardInterrupt):
session.start()
shutdown_session()
def train_2():
for i in range(2):
report(loss=i)
train_1()
init_session(training_func=train_2,
world_rank=0,
local_rank=0,
world_size=1)
session = get_session()
session.start()
time.sleep(3)
session.pause_reporting()
# Releases session.continue_lock to resume the training thread.
session.get_next()
with pytest.raises(KeyboardInterrupt):
session.finish()
shutdown_session()
def test_init_fail(session):
with pytest.raises(ValueError):
init_session(lambda: 1, 0)