Coverage for sources / agentsmgr / sources / local.py: 83%

1# vim: set filetype=python fileencoding=utf-8: 

2# -*- coding: utf-8 -*- 

3 

4#============================================================================# 

5# # 

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

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

8# You may obtain a copy of the License at # 

9# # 

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

11# # 

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

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

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

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

16# limitations under the License. # 

17# # 

18#============================================================================# 

19 

20 

21''' Local filesystem source handler. 

22 

23 This module provides source resolution for local filesystem paths, 

24 maintaining the existing behavior from the original retrieve_data_location 

25 function. 

26''' 

27 

28 

29from . import __ 

30from . import base as _base 

31 

32 

33@_base.source_handler(['', 'file']) 

34class LocalSourceHandler: 

35 ''' Handles local filesystem path resolution. 

36 

37 Resolves local path specifications to absolute filesystem paths. 

38 This maintains backward compatibility with existing local path 

39 usage patterns. 

40 ''' 

41 

42 def resolve( 

43 self, 

44 source_spec: str, 

45 tag_prefix: __.typx.Annotated[ 

46 __.Absential[ str ], 

47 __.ddoc.Doc( 

48 "Tag prefix for filtering version tags; ignored for local " 

49 "sources." ), 

50 ] = __.absent, 

51 ) -> __.Path: 

52 ''' Resolves local path specification to absolute path. 

53 

54 Converts relative paths to absolute paths and validates that 

55 the path exists and is accessible. 

56 ''' 

57 return __.Path( source_spec ).resolve( )