Coverage for hyper_parallel / core / checkpoint / loader.py: 91%

1# Copyright 2025 Huawei Technologies Co., Ltd 

2# 

3# Licensed under the Apache License, Version 2.0 (the "License"); 

4# you may not use this file except in compliance with the License. 

5# You may obtain a copy of the License at 

6# 

7# http://www.apache.org/licenses/LICENSE-2.0 

8# 

9# Unless required by applicable law or agreed to in writing, software 

10# distributed under the License is distributed on an "AS IS" BASIS, 

11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 

12# See the License for the specific language governing permissions and 

13# limitations under the License. 

14# ============================================================================ 

15"""Load model parameters from checkpoint file.""" 

16from pathlib import Path 

17from typing import Union 

18 

19from hyper_parallel.core.checkpoint.util import has_valid_filename 

20from hyper_parallel.platform import get_platform 

21 

22platform = get_platform() 

23 

24 

25def load_checkpoint(file_path: Union[Path, str]) -> dict: 

26 """ 

27 Load model parameters from checkpoint file. 

28 

29 Args: 

30 file_path (Union[Path, str]): Path to the checkpoint file. Path must contain file name with extension. 

31 

32 Returns: 

33 dict: A dictionary containing the loaded parameters. 

34 """ 

35 file_path_obj = Path(file_path) if isinstance(file_path, str) else file_path 

36 if not has_valid_filename(file_path_obj): 

37 raise ValueError(f"Loader file_path should contains valid filename but get: {file_path}") 

38 

39 param_dict = platform.load_checkpoint(str(file_path_obj)) 

40 return param_dict