KLL Compiler
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.

containers.py 11KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345
  1. #!/usr/bin/env python3
  2. # KLL Compiler Containers
  3. #
  4. # Copyright (C) 2014-2015 by Jacob Alexander
  5. #
  6. # This file is free software: you can redistribute it and/or modify
  7. # it under the terms of the GNU General Public License as published by
  8. # the Free Software Foundation, either version 3 of the License, or
  9. # (at your option) any later version.
  10. #
  11. # This file is distributed in the hope that it will be useful,
  12. # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14. # GNU General Public License for more details.
  15. #
  16. # You should have received a copy of the GNU General Public License
  17. # along with this file. If not, see <http://www.gnu.org/licenses/>.
  18. ### Imports ###
  19. import copy
  20. ### Decorators ###
  21. ## Print Decorator Variables
  22. ERROR = '\033[5;1;31mERROR\033[0m:'
  23. ### Parsing ###
  24. ## Containers
  25. class Capabilities:
  26. # Container for capabilities dictionary and convenience functions
  27. def __init__( self ):
  28. self.capabilities = dict()
  29. def __getitem__( self, name ):
  30. return self.capabilities[ name ]
  31. def __setitem__( self, name, contents ):
  32. self.capabilities[ name ] = contents
  33. def __repr__( self ):
  34. return "Capabilities => {0}\nIndexed Capabilities => {1}".format( self.capabilities, sorted( self.capabilities, key = self.capabilities.get ) )
  35. # Total bytes needed to store arguments
  36. def totalArgBytes( self, name ):
  37. totalBytes = 0
  38. # Iterate over the arguments, summing the total bytes
  39. for arg in self.capabilities[ name ][ 1 ]:
  40. totalBytes += int( arg[ 1 ] )
  41. return totalBytes
  42. # Name of the capability function
  43. def funcName( self, name ):
  44. return self.capabilities[ name ][ 0 ]
  45. # Only valid while dictionary keys are not added/removed
  46. def getIndex( self, name ):
  47. return sorted( self.capabilities, key = self.capabilities.get ).index( name )
  48. def getName( self, index ):
  49. return sorted( self.capabilities, key = self.capabilities.get )[ index ]
  50. def keys( self ):
  51. return sorted( self.capabilities, key = self.capabilities.get )
  52. class Macros:
  53. # Container for Trigger Macro : Result Macro correlation
  54. # Layer selection for generating TriggerLists
  55. #
  56. # Only convert USB Code list once all the ResultMacros have been accumulated (does a macro reduction; not reversible)
  57. # Two staged list for ResultMacros:
  58. # 1) USB Code/Non-converted (may contain capabilities)
  59. # 2) Capabilities
  60. def __init__( self ):
  61. # Default layer (0)
  62. self.layer = 0
  63. # Macro Storage
  64. self.macros = [ dict() ]
  65. # Base Layout Storage
  66. self.baseLayout = None
  67. self.layerLayoutMarkers = []
  68. # Correlated Macro Data
  69. self.resultsIndex = dict()
  70. self.triggersIndex = dict()
  71. self.resultsIndexSorted = []
  72. self.triggersIndexSorted = []
  73. self.triggerList = []
  74. self.maxScanCode = []
  75. self.firstScanCode = []
  76. # USBCode Assignment Cache
  77. self.assignmentCache = []
  78. def __repr__( self ):
  79. return "{0}".format( self.macros )
  80. def completeBaseLayout( self ):
  81. # Copy base layout for later use when creating partial layers and add marker
  82. self.baseLayout = copy.deepcopy( self.macros[ 0 ] )
  83. self.layerLayoutMarkers.append( copy.deepcopy( self.baseLayout ) ) # Not used for default layer, just simplifies coding
  84. def removeUnmarked( self ):
  85. # Remove all of the unmarked mappings from the partial layer
  86. for trigger in self.layerLayoutMarkers[ self.layer ].keys():
  87. del self.macros[ self.layer ][ trigger ]
  88. def addLayer( self ):
  89. # Increment layer count, and append another macros dictionary
  90. self.layer += 1
  91. self.macros.append( copy.deepcopy( self.baseLayout ) )
  92. # Add a layout marker for each layer
  93. self.layerLayoutMarkers.append( copy.deepcopy( self.baseLayout ) )
  94. # Use for ScanCode trigger macros
  95. def appendScanCode( self, trigger, result ):
  96. if not trigger in self.macros[ self.layer ]:
  97. self.replaceScanCode( trigger, result )
  98. else:
  99. self.macros[ self.layer ][ trigger ].append( result )
  100. # Remove the given trigger/result pair
  101. def removeScanCode( self, trigger, result ):
  102. # Remove all instances of the given trigger/result pair
  103. while result in self.macros[ self.layer ][ trigger ]:
  104. self.macros[ self.layer ][ trigger ].remove( result )
  105. # Replaces the given trigger with the given result
  106. # If multiple results for a given trigger, clear, then add
  107. def replaceScanCode( self, trigger, result ):
  108. self.macros[ self.layer ][ trigger ] = [ result ]
  109. # Mark layer scan code, so it won't be removed later
  110. # Also check to see if it hasn't already been removed before
  111. if not self.baseLayout is None and trigger in self.layerLayoutMarkers[ self.layer ]:
  112. del self.layerLayoutMarkers[ self.layer ][ trigger ]
  113. # Return a list of ScanCode triggers with the given USB Code trigger
  114. def lookupUSBCodes( self, usbCode ):
  115. scanCodeList = []
  116. # Scan current layer for USB Codes
  117. for macro in self.macros[ self.layer ].keys():
  118. if usbCode in self.macros[ self.layer ][ macro ]:
  119. scanCodeList.append( macro )
  120. return scanCodeList
  121. # Cache USBCode Assignment
  122. def cacheAssignment( self, operator, scanCode, result ):
  123. self.assignmentCache.append( [ operator, scanCode, result ] )
  124. # Assign cached USBCode Assignments
  125. def replayCachedAssignments( self ):
  126. # Iterate over each item in the assignment cache
  127. for item in self.assignmentCache:
  128. # Check operator, and choose the specified assignment action
  129. # Append Case
  130. if item[0] == ":+":
  131. self.appendScanCode( item[1], item[2] )
  132. # Remove Case
  133. elif item[0] == ":-":
  134. self.removeScanCode( item[1], item[2] )
  135. # Replace Case
  136. elif item[0] == ":":
  137. self.replaceScanCode( item[1], item[2] )
  138. # Clear assignment cache
  139. self.assignmentCache = []
  140. # Generate/Correlate Layers
  141. def generate( self ):
  142. self.generateIndices()
  143. self.sortIndexLists()
  144. self.generateTriggerLists()
  145. # Generates Index of Results and Triggers
  146. def generateIndices( self ):
  147. # Iterate over every trigger result, and add to the resultsIndex and triggersIndex
  148. for layer in range( 0, len( self.macros ) ):
  149. for trigger in self.macros[ layer ].keys():
  150. # Each trigger has a list of results
  151. for result in self.macros[ layer ][ trigger ]:
  152. # Only add, with an index, if result hasn't been added yet
  153. if not result in self.resultsIndex:
  154. self.resultsIndex[ result ] = len( self.resultsIndex )
  155. # Then add a trigger for each result, if trigger hasn't been added yet
  156. triggerItem = tuple( [ trigger, self.resultsIndex[ result ] ] )
  157. if not triggerItem in self.triggersIndex:
  158. self.triggersIndex[ triggerItem ] = len( self.triggersIndex )
  159. # Sort Index Lists using the indices rather than triggers/results
  160. def sortIndexLists( self ):
  161. self.resultsIndexSorted = [ None ] * len( self.resultsIndex )
  162. # Iterate over the resultsIndex and sort by index
  163. for result in self.resultsIndex.keys():
  164. self.resultsIndexSorted[ self.resultsIndex[ result ] ] = result
  165. self.triggersIndexSorted = [ None ] * len( self.triggersIndex )
  166. # Iterate over the triggersIndex and sort by index
  167. for trigger in self.triggersIndex.keys():
  168. self.triggersIndexSorted[ self.triggersIndex[ trigger ] ] = trigger
  169. # Generates Trigger Lists per layer using index lists
  170. def generateTriggerLists( self ):
  171. for layer in range( 0, len( self.macros ) ):
  172. # Set max scancode to 0xFF (255)
  173. # But keep track of the actual max scancode and reduce the list size
  174. self.triggerList.append( [ [] ] * 0xFF )
  175. self.maxScanCode.append( 0x00 )
  176. # Iterate through trigger macros to locate necessary ScanCodes and corresponding triggerIndex
  177. for trigger in self.macros[ layer ].keys():
  178. for variant in range( 0, len( self.macros[ layer ][ trigger ] ) ):
  179. # Identify result index
  180. resultIndex = self.resultsIndex[ self.macros[ layer ][ trigger ][ variant ] ]
  181. # Identify trigger index
  182. triggerIndex = self.triggersIndex[ tuple( [ trigger, resultIndex ] ) ]
  183. # Iterate over the trigger to locate the ScanCodes
  184. for sequence in trigger:
  185. for combo in sequence:
  186. # Append triggerIndex for each found scanCode of the Trigger List
  187. # Do not re-add if triggerIndex is already in the Trigger List
  188. if not triggerIndex in self.triggerList[ layer ][ combo ]:
  189. # Append is working strangely with list pre-initialization
  190. # Doing a 0 check replacement instead -HaaTa
  191. if len( self.triggerList[ layer ][ combo ] ) == 0:
  192. self.triggerList[ layer ][ combo ] = [ triggerIndex ]
  193. else:
  194. self.triggerList[ layer ][ combo ].append( triggerIndex )
  195. # Look for max Scan Code
  196. if combo > self.maxScanCode[ layer ]:
  197. self.maxScanCode[ layer ] = combo
  198. # Shrink triggerList to actual max size
  199. self.triggerList[ layer ] = self.triggerList[ layer ][ : self.maxScanCode[ layer ] + 1 ]
  200. # Calculate first scan code for layer, useful for uC implementations trying to save RAM
  201. firstScanCode = 0
  202. for triggerList in range( 0, len( self.triggerList[ layer ] ) ):
  203. firstScanCode = triggerList
  204. # Break if triggerList has items
  205. if len( self.triggerList[ layer ][ triggerList ] ) > 0:
  206. break;
  207. self.firstScanCode.append( firstScanCode )
  208. # Determine overall maxScanCode
  209. self.overallMaxScanCode = 0x00
  210. for maxVal in self.maxScanCode:
  211. if maxVal > self.overallMaxScanCode:
  212. self.overallMaxScanCode = maxVal
  213. class Variables:
  214. # Container for variables
  215. # Stores three sets of variables, the overall combined set, per layer, and per file
  216. def __init__( self ):
  217. # Dictionaries of variables
  218. self.baseLayout = dict()
  219. self.fileVariables = dict()
  220. self.layerVariables = [ dict() ]
  221. self.overallVariables = dict()
  222. self.defines = dict()
  223. self.currentFile = ""
  224. self.currentLayer = 0
  225. self.baseLayoutEnabled = True
  226. def baseLayoutFinished( self ):
  227. self.baseLayoutEnabled = False
  228. def setCurrentFile( self, name ):
  229. # Store using filename and current layer
  230. self.currentFile = name
  231. self.fileVariables[ name ] = dict()
  232. # If still processing BaseLayout
  233. if self.baseLayoutEnabled:
  234. if '*LayerFiles' in self.baseLayout.keys():
  235. self.baseLayout['*LayerFiles'] += [ name ]
  236. else:
  237. self.baseLayout['*LayerFiles'] = [ name ]
  238. # Set for the current layer
  239. else:
  240. if '*LayerFiles' in self.layerVariables[ self.currentLayer ].keys():
  241. self.layerVariables[ self.currentLayer ]['*LayerFiles'] += [ name ]
  242. else:
  243. self.layerVariables[ self.currentLayer ]['*LayerFiles'] = [ name ]
  244. def incrementLayer( self ):
  245. # Store using layer index
  246. self.currentLayer += 1
  247. self.layerVariables.append( dict() )
  248. def assignVariable( self, key, value ):
  249. # Overall set of variables
  250. self.overallVariables[ key ] = value
  251. # The Name variable is a special accumulation case
  252. if key == 'Name':
  253. # BaseLayout still being processed
  254. if self.baseLayoutEnabled:
  255. if '*NameStack' in self.baseLayout.keys():
  256. self.baseLayout['*NameStack'] += [ value ]
  257. else:
  258. self.baseLayout['*NameStack'] = [ value ]
  259. # Layers
  260. else:
  261. if '*NameStack' in self.layerVariables[ self.currentLayer ].keys():
  262. self.layerVariables[ self.currentLayer ]['*NameStack'] += [ value ]
  263. else:
  264. self.layerVariables[ self.currentLayer ]['*NameStack'] = [ value ]
  265. # If still processing BaseLayout
  266. if self.baseLayoutEnabled:
  267. self.baseLayout[ key ] = value
  268. # Set for the current layer
  269. else:
  270. self.layerVariables[ self.currentLayer ][ key ] = value
  271. # File context variables
  272. self.fileVariables[ self.currentFile ][ key ] = value