# Copyright The PyTorch Lightning team. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. from unittest import mock from unittest.mock import call, Mock import pytest import torch from tests_fabric.helpers.runif import RunIf from torch.utils.data import DistributedSampler from torch.utils.data.dataloader import DataLoader from lightning.fabric.fabric import Fabric from lightning.fabric.utilities.device_dtype_mixin import _DeviceDtypeModuleMixin from lightning.fabric.wrappers import _FabricDataLoader, _FabricModule, _FabricOptimizer class EmptyFabric(Fabric): def run(self): pass def test_fabric_module_wraps(): """Test that the wrapped module is accessible via the property.""" module = Mock() assert _FabricModule(module, Mock()).module is module wrapped_module = Mock() original_module = Mock() assert _FabricModule(wrapped_module, Mock(), original_module=original_module).module is original_module def test_fabric_module_attribute_lookup(): """Test that attribute lookup passes through to the original module when possible.""" class OriginalModule(torch.nn.Module): def __init__(self): super().__init__() self.layer = torch.nn.Linear(2, 3) self.attribute = 1 def method(self): return 2 original_module = OriginalModule() class ModuleWrapper(torch.nn.Module): def __init__(self): super().__init__() self.wrapped = original_module wrapped_module = ModuleWrapper() fabric_module = _FabricModule(wrapped_module, Mock(), original_module=original_module) assert fabric_module.attribute == 1 assert fabric_module.layer is original_module.layer assert fabric_module.method() == 2 assert fabric_module.forward.__self__.__class__ == _FabricModule with pytest.raises(AttributeError): _ = fabric_module.not_exists def test_fabric_module_state_dict_access(): """Test that state_dict access passes through to the original module.""" class OriginalModule(torch.nn.Module): def __init__(self): super().__init__() self.layer = torch.nn.Linear(2, 3) original_module = OriginalModule() class ModuleWrapper(torch.nn.Module): def __init__(self): super().__init__() self.wrapped = original_module wrapped_module = ModuleWrapper() fabric_module = _FabricModule(wrapped_module, Mock(), original_module=original_module) state_dict = fabric_module.state_dict() assert set(state_dict.keys()) == {"layer.weight", "layer.bias"} weight, bias = torch.rand(3, 2), torch.rand(3) fabric_module.load_state_dict({"layer.weight": weight, "layer.bias": bias}) assert torch.equal(fabric_module.layer.weight, weight) assert torch.equal(fabric_module.layer.bias, bias) @pytest.mark.parametrize( "precision, input_type, expected_type, accelerator, device_str", [ pytest.param(32, torch.float16, torch.float32, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param(32, torch.float32, torch.float32, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param(32, torch.float64, torch.float32, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param(32, torch.int, torch.int, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param(16, torch.float32, torch.float16, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param(16, torch.float64, torch.float16, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param(16, torch.long, torch.long, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param( "bf16", torch.float32, torch.bfloat16, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1, bf16_cuda=True), ), pytest.param( "bf16", torch.float64, torch.bfloat16, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1, bf16_cuda=True), ), pytest.param( "bf16", torch.bool, torch.bool, "gpu", "cuda:0", marks=RunIf(min_cuda_gpus=1, bf16_cuda=True), ), pytest.param(32, torch.float32, torch.float32, "mps", "mps:0", marks=RunIf(mps=True)), ], ) def test_fabric_module_forward_conversion(precision, input_type, expected_type, accelerator, device_str): """Test that the FabricModule performs autocasting on the input tensors and during forward().""" fabric = EmptyFabric(precision=precision, accelerator=accelerator, devices=1) device = torch.device(device_str) def check_autocast(forward_input): assert precision != 16 or torch.is_autocast_enabled() return forward_input module = Mock(wraps=torch.nn.Identity(), side_effect=check_autocast) fabric_module = _FabricModule(module, fabric._precision).to(device) out = fabric_module(torch.tensor([1, 2, 3], dtype=input_type, device=device)) assert module.call_args[0][0].dtype == expected_type assert out.dtype == input_type or out.dtype == torch.get_default_dtype() @pytest.mark.parametrize( "device_str", [ "cpu", pytest.param("cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param("mps", marks=RunIf(mps=True)), ], ) @pytest.mark.parametrize("dtype", [torch.float32, torch.float16]) def test_fabric_module_device_dtype_propagation(device_str, dtype): """Test that the FabricModule propagates device and dtype properties to its submodules (e.g. torchmetrics).""" device = torch.device(device_str) class DeviceModule(_DeviceDtypeModuleMixin): pass device_module = DeviceModule() fabric_module = _FabricModule(device_module, Mock()) fabric_module.to(device) assert device_module.device == device assert fabric_module.device == device fabric_module.to(dtype) assert device_module.dtype == dtype assert fabric_module.dtype == dtype def test_fabric_dataloader_iterator(): """Test that the iteration over a FabricDataLoader wraps the iterator of the underlying dataloader (no automatic device placement).""" dataloader = DataLoader(range(5), batch_size=2) fabric_dataloader = _FabricDataLoader(dataloader) assert len(fabric_dataloader) == len(dataloader) == 3 iterator = iter(dataloader) fabric_iterator = iter(fabric_dataloader) assert torch.equal(next(iterator), next(fabric_iterator)) assert torch.equal(next(iterator), next(fabric_iterator)) assert torch.equal(next(iterator), next(fabric_iterator)) with pytest.raises(StopIteration): next(iterator) with pytest.raises(StopIteration): next(fabric_iterator) @pytest.mark.parametrize( "src_device_str, dest_device_str", [ ("cpu", "cpu"), pytest.param("cpu", "cuda:0", marks=RunIf(min_cuda_gpus=1)), pytest.param("cuda:0", "cpu", marks=RunIf(min_cuda_gpus=1)), # pytest.param("cpu", "mps", marks=RunIf(mps=True)), # TODO: Add once torch.equal is supported pytest.param("mps", "cpu", marks=RunIf(mps=True)), ], ) def test_fabric_dataloader_device_placement(src_device_str, dest_device_str): """Test that the FabricDataLoader moves data to the device in its iterator.""" src_device = torch.device(src_device_str) dest_device = torch.device(dest_device_str) sample0 = torch.tensor(0, device=src_device) sample1 = torch.tensor(1, device=src_device) sample2 = {"data": torch.tensor(2, device=src_device)} sample3 = {"data": torch.tensor(3, device=src_device)} dataloader = DataLoader([sample0, sample1, sample2, sample3], batch_size=2) fabric_dataloader = _FabricDataLoader(dataloader=dataloader, device=dest_device) iterator = iter(fabric_dataloader) batch0 = next(iterator) # TODO: torch.equal is not supported on MPS at this time (torch 1.12) assert torch.equal(batch0, torch.tensor([0, 1], device=dest_device)) batch1 = next(iterator) # TODO: torch.equal is not supported on MPS at this time (torch 1.12) assert torch.equal(batch1["data"], torch.tensor([2, 3], device=dest_device)) def test_fabric_dataloader_distributed_sampler_set_epoch(): """Test that the FabricDataLoader calls `set_epoch()` on the wrapped sampler if applicable.""" sampler = DistributedSampler(range(3), num_replicas=2, rank=0) sampler.set_epoch = Mock() dataloader = DataLoader(range(3), sampler=sampler) fabric_dataloader = _FabricDataLoader(dataloader) iterator_epoch_0 = iter(fabric_dataloader) dataloader.sampler.set_epoch.assert_not_called() next(iterator_epoch_0) # .set_epoch() gets called before the first sample gets fetched from the wrapped dataloader assert dataloader.sampler.set_epoch.call_args_list == [call(0)] next(iterator_epoch_0) assert dataloader.sampler.set_epoch.call_args_list == [call(0)] iterator_epoch_1 = iter(fabric_dataloader) assert dataloader.sampler.set_epoch.call_args_list == [call(0)] next(iterator_epoch_1) # with every new iterator call, the epoch increases assert dataloader.sampler.set_epoch.call_args_list == [call(0), call(1)] def test_fabric_optimizer_wraps(): """Test that the FabricOptimizer fully wraps the optimizer.""" optimizer_cls = torch.optim.SGD optimizer = Mock(spec=optimizer_cls) fabric_optimizer = _FabricOptimizer(optimizer, Mock()) assert fabric_optimizer.optimizer is optimizer assert isinstance(fabric_optimizer, optimizer_cls) def test_fabric_optimizer_state_dict(): """Test that the FabricOptimizer calls into the strategy to collect the state.""" optimizer = Mock() strategy = Mock() fabric_optimizer = _FabricOptimizer(optimizer=optimizer, strategy=strategy) fabric_optimizer.state_dict() strategy.get_optimizer_state.assert_called_with(optimizer) def test_fabric_optimizer_steps(): """Test that the FabricOptimizer forwards the step() and zero_grad() calls to the wrapped optimizer.""" optimizer = Mock() strategy = Mock(spec=["optimizer_step"]) strategy.optimizer_step.return_value = 123 fabric_optimizer = _FabricOptimizer(optimizer=optimizer, strategy=strategy) step_output = fabric_optimizer.step() assert step_output == 123 strategy.optimizer_step.assert_called_once_with(optimizer) strategy.reset_mock() # with closure as input closure = Mock() fabric_optimizer.step(closure=closure) strategy.optimizer_step.assert_called_once_with(optimizer, closure=closure) # with model as optimizer strategy = Mock(spec=["optimizer_step", "model"]) fabric_optimizer = _FabricOptimizer(optimizer=optimizer, strategy=strategy) fabric_optimizer.step() strategy.optimizer_step.assert_called_once_with(strategy.model) def test_fabric_optimizer_zero_grad_kwargs(): """Test that Fabric can adapt the `.zero_grad()` arguments to the underlying optimizer.""" # Test PyTorch's standard `.zero_grad()` signature with mock.patch("torch.optim.SGD.zero_grad") as zero_grad_mock: optimizer = torch.optim.SGD(torch.nn.Linear(1, 1).parameters(), 0.1) fabric_optimizer = _FabricOptimizer(optimizer=optimizer, strategy=Mock()) fabric_optimizer.zero_grad() zero_grad_mock.assert_called_with() fabric_optimizer.zero_grad(set_to_none=False) zero_grad_mock.assert_called_with(set_to_none=False) fabric_optimizer.zero_grad(set_to_none=True) zero_grad_mock.assert_called_with(set_to_none=True) # Test weird `.zero_grad()` signatures from other libraries custom_zero_grad = Mock() class CustomSGD(torch.optim.SGD): def zero_grad(self, set_grads_to_None=False): custom_zero_grad(set_grads_to_None=set_grads_to_None) optimizer = CustomSGD(torch.nn.Linear(1, 1).parameters(), 0.1) fabric_optimizer = _FabricOptimizer(optimizer=optimizer, strategy=Mock()) fabric_optimizer.zero_grad() custom_zero_grad.assert_called_with(set_grads_to_None=False) fabric_optimizer.zero_grad(set_to_none=False) custom_zero_grad.assert_called_with(set_grads_to_None=False) fabric_optimizer.zero_grad(set_to_none=True) custom_zero_grad.assert_called_with(set_grads_to_None=True)