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 12KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355
  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. if len(scanCodeList) == 0:
  121. if len(usbCode) > 1 or len(usbCode[0]) > 1:
  122. for combo in usbCode:
  123. comboCodes = list()
  124. for key in combo:
  125. scanCode = self.lookupUSBCodes(((key,),))
  126. comboCodes.append(scanCode[0][0][0])
  127. scanCodeList.append(tuple(code for code in comboCodes))
  128. scanCodeList = [tuple(scanCodeList)]
  129. return scanCodeList
  130. # Cache USBCode Assignment
  131. def cacheAssignment( self, operator, scanCode, result ):
  132. self.assignmentCache.append( [ operator, scanCode, result ] )
  133. # Assign cached USBCode Assignments
  134. def replayCachedAssignments( self ):
  135. # Iterate over each item in the assignment cache
  136. for item in self.assignmentCache:
  137. # Check operator, and choose the specified assignment action
  138. # Append Case
  139. if item[0] == ":+":
  140. self.appendScanCode( item[1], item[2] )
  141. # Remove Case
  142. elif item[0] == ":-":
  143. self.removeScanCode( item[1], item[2] )
  144. # Replace Case
  145. elif item[0] == ":":
  146. self.replaceScanCode( item[1], item[2] )
  147. # Clear assignment cache
  148. self.assignmentCache = []
  149. # Generate/Correlate Layers
  150. def generate( self ):
  151. self.generateIndices()
  152. self.sortIndexLists()
  153. self.generateTriggerLists()
  154. # Generates Index of Results and Triggers
  155. def generateIndices( self ):
  156. # Iterate over every trigger result, and add to the resultsIndex and triggersIndex
  157. for layer in range( 0, len( self.macros ) ):
  158. for trigger in self.macros[ layer ].keys():
  159. # Each trigger has a list of results
  160. for result in self.macros[ layer ][ trigger ]:
  161. # Only add, with an index, if result hasn't been added yet
  162. if not result in self.resultsIndex:
  163. self.resultsIndex[ result ] = len( self.resultsIndex )
  164. # Then add a trigger for each result, if trigger hasn't been added yet
  165. triggerItem = tuple( [ trigger, self.resultsIndex[ result ] ] )
  166. if not triggerItem in self.triggersIndex:
  167. self.triggersIndex[ triggerItem ] = len( self.triggersIndex )
  168. # Sort Index Lists using the indices rather than triggers/results
  169. def sortIndexLists( self ):
  170. self.resultsIndexSorted = [ None ] * len( self.resultsIndex )
  171. # Iterate over the resultsIndex and sort by index
  172. for result in self.resultsIndex.keys():
  173. self.resultsIndexSorted[ self.resultsIndex[ result ] ] = result
  174. self.triggersIndexSorted = [ None ] * len( self.triggersIndex )
  175. # Iterate over the triggersIndex and sort by index
  176. for trigger in self.triggersIndex.keys():
  177. self.triggersIndexSorted[ self.triggersIndex[ trigger ] ] = trigger
  178. # Generates Trigger Lists per layer using index lists
  179. def generateTriggerLists( self ):
  180. for layer in range( 0, len( self.macros ) ):
  181. # Set max scancode to 0xFF (255)
  182. # But keep track of the actual max scancode and reduce the list size
  183. self.triggerList.append( [ [] ] * 0xFF )
  184. self.maxScanCode.append( 0x00 )
  185. # Iterate through trigger macros to locate necessary ScanCodes and corresponding triggerIndex
  186. for trigger in self.macros[ layer ].keys():
  187. for variant in range( 0, len( self.macros[ layer ][ trigger ] ) ):
  188. # Identify result index
  189. resultIndex = self.resultsIndex[ self.macros[ layer ][ trigger ][ variant ] ]
  190. # Identify trigger index
  191. triggerIndex = self.triggersIndex[ tuple( [ trigger, resultIndex ] ) ]
  192. # Iterate over the trigger to locate the ScanCodes
  193. for sequence in trigger:
  194. for combo in sequence:
  195. # Append triggerIndex for each found scanCode of the Trigger List
  196. # Do not re-add if triggerIndex is already in the Trigger List
  197. if not triggerIndex in self.triggerList[ layer ][ combo ]:
  198. # Append is working strangely with list pre-initialization
  199. # Doing a 0 check replacement instead -HaaTa
  200. if len( self.triggerList[ layer ][ combo ] ) == 0:
  201. self.triggerList[ layer ][ combo ] = [ triggerIndex ]
  202. else:
  203. self.triggerList[ layer ][ combo ].append( triggerIndex )
  204. # Look for max Scan Code
  205. if combo > self.maxScanCode[ layer ]:
  206. self.maxScanCode[ layer ] = combo
  207. # Shrink triggerList to actual max size
  208. self.triggerList[ layer ] = self.triggerList[ layer ][ : self.maxScanCode[ layer ] + 1 ]
  209. # Calculate first scan code for layer, useful for uC implementations trying to save RAM
  210. firstScanCode = 0
  211. for triggerList in range( 0, len( self.triggerList[ layer ] ) ):
  212. firstScanCode = triggerList
  213. # Break if triggerList has items
  214. if len( self.triggerList[ layer ][ triggerList ] ) > 0:
  215. break;
  216. self.firstScanCode.append( firstScanCode )
  217. # Determine overall maxScanCode
  218. self.overallMaxScanCode = 0x00
  219. for maxVal in self.maxScanCode:
  220. if maxVal > self.overallMaxScanCode:
  221. self.overallMaxScanCode = maxVal
  222. class Variables:
  223. # Container for variables
  224. # Stores three sets of variables, the overall combined set, per layer, and per file
  225. def __init__( self ):
  226. # Dictionaries of variables
  227. self.baseLayout = dict()
  228. self.fileVariables = dict()
  229. self.layerVariables = [ dict() ]
  230. self.overallVariables = dict()
  231. self.defines = dict()
  232. self.currentFile = ""
  233. self.currentLayer = 0
  234. self.baseLayoutEnabled = True
  235. def baseLayoutFinished( self ):
  236. self.baseLayoutEnabled = False
  237. def setCurrentFile( self, name ):
  238. # Store using filename and current layer
  239. self.currentFile = name
  240. self.fileVariables[ name ] = dict()
  241. # If still processing BaseLayout
  242. if self.baseLayoutEnabled:
  243. if '*LayerFiles' in self.baseLayout.keys():
  244. self.baseLayout['*LayerFiles'] += [ name ]
  245. else:
  246. self.baseLayout['*LayerFiles'] = [ name ]
  247. # Set for the current layer
  248. else:
  249. if '*LayerFiles' in self.layerVariables[ self.currentLayer ].keys():
  250. self.layerVariables[ self.currentLayer ]['*LayerFiles'] += [ name ]
  251. else:
  252. self.layerVariables[ self.currentLayer ]['*LayerFiles'] = [ name ]
  253. def incrementLayer( self ):
  254. # Store using layer index
  255. self.currentLayer += 1
  256. self.layerVariables.append( dict() )
  257. def assignVariable( self, key, value ):
  258. # Overall set of variables
  259. self.overallVariables[ key ] = value
  260. # The Name variable is a special accumulation case
  261. if key == 'Name':
  262. # BaseLayout still being processed
  263. if self.baseLayoutEnabled:
  264. if '*NameStack' in self.baseLayout.keys():
  265. self.baseLayout['*NameStack'] += [ value ]
  266. else:
  267. self.baseLayout['*NameStack'] = [ value ]
  268. # Layers
  269. else:
  270. if '*NameStack' in self.layerVariables[ self.currentLayer ].keys():
  271. self.layerVariables[ self.currentLayer ]['*NameStack'] += [ value ]
  272. else:
  273. self.layerVariables[ self.currentLayer ]['*NameStack'] = [ value ]
  274. # If still processing BaseLayout
  275. if self.baseLayoutEnabled:
  276. self.baseLayout[ key ] = value
  277. # Set for the current layer
  278. else:
  279. self.layerVariables[ self.currentLayer ][ key ] = value
  280. # File context variables
  281. self.fileVariables[ self.currentFile ][ key ] = value