Coverage for sources / ictr / inspection.py: 75%

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''' Inspection of variables as function arguments. ''' 

22 

23# TODO: Implement if deeper inspection than f-string {name=} is needed. 

24 

25 

26# import executing as _executing 

27 

28 

29from . import __ 

30 

31 

32class Inspection( __.immut.DataclassObject ): 

33 ''' Result of variable inspection. ''' 

34 

35 name: str 

36 value: __.typx.Any 

37 

38 

39Inspections: __.typx.TypeAlias = __.cabc.Sequence[ Inspection ] 

40 

41 

42def inspect_variables( *variables: __.typx.Any ) -> Inspections: 

43 ''' Returns values of variables with names and execution context. ''' 

44 inspections: list[ Inspection ] = [ ] 

45 # TODO: Implement. 

46 return tuple( inspections )