Coverage for tsfpga/generics.py: 96%

1# -------------------------------------------------------------------------------------------------- 

2# Copyright (c) Lukas Vik. All rights reserved. 

3# 

4# This file is part of the tsfpga project, a project platform for modern FPGA development. 

5# https://tsfpga.com 

6# https://github.com/tsfpga/tsfpga 

7# -------------------------------------------------------------------------------------------------- 

8 

9from __future__ import annotations 

10 

11 

12class StringGenericValue: 

13 """ 

14 Use this type for generic values of type ``string``. 

15 """ 

16 

17 def __init__(self, value: str) -> None: 

18 """ 

19 Arguments: 

20 value: A string of variable length with any content. 

21 """ 

22 if not isinstance(value, str): 

23 raise TypeError( 

24 f"Expected {self.__class__.__name__} value to be of type str." 

25 f' Got type="{type(value)}", value="{value}".' 

26 ) 

27 

28 if " " in value: 

29 raise ValueError( 

30 f'Expected {self.__class__.__name__} value to not contain spaces. Got "{value}".' 

31 ) 

32 

33 self.value = value 

34 

35 def __str__(self) -> str: 

36 return self.value 

37 

38 

39class BitVectorGenericValue: 

40 """ 

41 Use this type for generic values of type ``std_logic_vector``. 

42 """ 

43 

44 def __init__(self, value: str) -> None: 

45 """ 

46 Arguments: 

47 value: A string of variable length containing only "1" or "0". 

48 """ 

49 if not isinstance(value, str): 

50 raise TypeError( 

51 f"Expected {self.__class__.__name__} value to be of type str." 

52 f' Got type="{type(value)}", value="{value}".' 

53 ) 

54 

55 for bit_value in value: 

56 if bit_value not in ["1", "0"]: 

57 raise ValueError( 

58 f'Expected {self.__class__.__name__} value to contain only "1" or "0".' 

59 f' Got "{value}".' 

60 ) 

61 

62 self.value = value 

63 

64 @property 

65 def length(self) -> int: 

66 """ 

67 The number of bits in the vector. 

68 """ 

69 return len(self.value) 

70 

71 def __str__(self) -> str: 

72 return self.value 

73 

74 

75#: A generic value of a native Python type, or one of the tsfpga wrapper classes above. 

76GenericValue = bool | int | float | StringGenericValue | BitVectorGenericValue 

77 

78#: A mapping of generic name to :data:`.GenericValue`, as accepted by the build project classes. 

79GenericValues = dict[str, GenericValue]