1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
# ==================================================================================================================== #
# __ ___ _ ____ _ __ __ _ _ #
# _ __ _ \ \ / / | | | _ \| | | \/ | ___ __| | ___| | #
# | '_ \| | | \ \ / /| |_| | | | | | | |\/| |/ _ \ / _` |/ _ \ | #
# | |_) | |_| |\ V / | _ | |_| | |___| | | | (_) | (_| | __/ | #
# | .__/ \__, | \_/ |_| |_|____/|_____|_| |_|\___/ \__,_|\___|_| #
# |_| |___/ #
# ==================================================================================================================== #
# Authors: #
# Patrick Lehmann #
# #
# License: #
# ==================================================================================================================== #
# Copyright 2017-2023 Patrick Lehmann - Boetzingen, Germany #
# Copyright 2016-2017 Patrick Lehmann - Dresden, Germany #
# #
# 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. #
# #
# SPDX-License-Identifier: Apache-2.0 #
# ==================================================================================================================== #
#
"""
This module contains parts of an abstract document language model for VHDL.
Subprograms are procedures, functions and methods.
"""
from typing import List
from pyTooling.Decorators import export
from pyTooling.MetaClasses import ExtendedType
from pyVHDLModel.Base import ModelEntity, NamedEntityMixin, DocumentedEntityMixin
from pyVHDLModel.Type import Subtype, ProtectedType
from pyVHDLModel.Sequential import SequentialStatement
@export
class Subprogram(ModelEntity, NamedEntityMixin, DocumentedEntityMixin):
_genericItems: List['GenericInterfaceItem']
_parameterItems: List['ParameterInterfaceItem']
_declaredItems: List
_statements: List['SequentialStatement']
_isPure: bool
def __init__(self, identifier: str, documentation: str = None):
super().__init__()
NamedEntityMixin.__init__(self, identifier)
DocumentedEntityMixin.__init__(self, documentation)
self._genericItems = [] # TODO: convert to dict
self._parameterItems = [] # TODO: convert to dict
self._declaredItems = [] # TODO: use mixin class
self._statements = [] # TODO: use mixin class
@property
def GenericItems(self) -> List['GenericInterfaceItem']:
return self._genericItems
@property
def ParameterItems(self) -> List['ParameterInterfaceItem']:
return self._parameterItems
@property
def DeclaredItems(self) -> List:
return self._declaredItems
@property
def Statements(self) -> List['SequentialStatement']:
return self._statements
@property
def IsPure(self) -> bool:
return self._isPure
@export
class Procedure(Subprogram):
def __init__(self, identifier: str, documentation: str = None):
super().__init__(identifier, documentation)
self._isPure = False
@export
class Function(Subprogram):
_returnType: Subtype
def __init__(self, identifier: str, isPure: bool = True, documentation: str = None):
super().__init__(identifier, documentation)
self._isPure = isPure
# FIXME: return type is missing
@property
def ReturnType(self) -> Subtype:
return self._returnType
@export
class MethodMixin(metaclass=ExtendedType, mixin=True):
"""A ``Method`` is a mixin class for all subprograms in a protected type."""
_protectedType: ProtectedType
def __init__(self, protectedType: ProtectedType):
self._protectedType = protectedType
protectedType._parent = self
@property
def ProtectedType(self) -> ProtectedType:
return self._protectedType
@export
class ProcedureMethod(Procedure, MethodMixin):
def __init__(self, identifier: str, protectedType: ProtectedType):
super().__init__(identifier)
MethodMixin.__init__(self, protectedType)
@export
class FunctionMethod(Function, MethodMixin):
def __init__(self, identifier: str, protectedType: ProtectedType):
super().__init__(identifier)
MethodMixin.__init__(self, protectedType)
|