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

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294
  1. #!/usr/bin/env python3
  2. # KLL Compiler Containers
  3. #
  4. # Copyright (C) 2014 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. if not self.baseLayout is None:
  111. del self.layerLayoutMarkers[ self.layer ][ trigger ]
  112. # Return a list of ScanCode triggers with the given USB Code trigger
  113. def lookupUSBCodes( self, usbCode ):
  114. scanCodeList = []
  115. # Scan current layer for USB Codes
  116. for macro in self.macros[ self.layer ].keys():
  117. if usbCode in self.macros[ self.layer ][ macro ]:
  118. scanCodeList.append( macro )
  119. return scanCodeList
  120. # Cache USBCode Assignment
  121. def cacheAssignment( self, operator, scanCode, result ):
  122. self.assignmentCache.append( [ operator, scanCode, result ] )
  123. # Assign cached USBCode Assignments
  124. def replayCachedAssignments( self ):
  125. # Iterate over each item in the assignment cache
  126. for item in self.assignmentCache:
  127. # Check operator, and choose the specified assignment action
  128. # Append Case
  129. if item[0] == ":+":
  130. self.appendScanCode( item[1], item[2] )
  131. # Remove Case
  132. elif item[0] == ":-":
  133. self.removeScanCode( item[1], item[2] )
  134. # Replace Case
  135. elif item[0] == ":":
  136. self.replaceScanCode( item[1], item[2] )
  137. # Clear assignment cache
  138. self.assignmentCache = []
  139. # Generate/Correlate Layers
  140. def generate( self ):
  141. self.generateIndices()
  142. self.sortIndexLists()
  143. self.generateTriggerLists()
  144. # Generates Index of Results and Triggers
  145. def generateIndices( self ):
  146. # Iterate over every trigger result, and add to the resultsIndex and triggersIndex
  147. for layer in range( 0, len( self.macros ) ):
  148. for trigger in self.macros[ layer ].keys():
  149. # Each trigger has a list of results
  150. for result in self.macros[ layer ][ trigger ]:
  151. # Only add, with an index, if result hasn't been added yet
  152. if not result in self.resultsIndex:
  153. self.resultsIndex[ result ] = len( self.resultsIndex )
  154. # Then add a trigger for each result, if trigger hasn't been added yet
  155. triggerItem = tuple( [ trigger, self.resultsIndex[ result ] ] )
  156. if not triggerItem in self.triggersIndex:
  157. self.triggersIndex[ triggerItem ] = len( self.triggersIndex )
  158. # Sort Index Lists using the indices rather than triggers/results
  159. def sortIndexLists( self ):
  160. self.resultsIndexSorted = [ None ] * len( self.resultsIndex )
  161. # Iterate over the resultsIndex and sort by index
  162. for result in self.resultsIndex.keys():
  163. self.resultsIndexSorted[ self.resultsIndex[ result ] ] = result
  164. self.triggersIndexSorted = [ None ] * len( self.triggersIndex )
  165. # Iterate over the triggersIndex and sort by index
  166. for trigger in self.triggersIndex.keys():
  167. self.triggersIndexSorted[ self.triggersIndex[ trigger ] ] = trigger
  168. # Generates Trigger Lists per layer using index lists
  169. def generateTriggerLists( self ):
  170. for layer in range( 0, len( self.macros ) ):
  171. # Set max scancode to 0xFF (255)
  172. # But keep track of the actual max scancode and reduce the list size
  173. self.triggerList.append( [ [] ] * 0xFF )
  174. self.maxScanCode.append( 0x00 )
  175. # Iterate through trigger macros to locate necessary ScanCodes and corresponding triggerIndex
  176. for trigger in self.macros[ layer ].keys():
  177. for variant in range( 0, len( self.macros[ layer ][ trigger ] ) ):
  178. # Identify result index
  179. resultIndex = self.resultsIndex[ self.macros[ layer ][ trigger ][ variant ] ]
  180. # Identify trigger index
  181. triggerIndex = self.triggersIndex[ tuple( [ trigger, resultIndex ] ) ]
  182. # Iterate over the trigger to locate the ScanCodes
  183. for sequence in trigger:
  184. for combo in sequence:
  185. # Append triggerIndex for each found scanCode of the Trigger List
  186. # Do not re-add if triggerIndex is already in the Trigger List
  187. if not triggerIndex in self.triggerList[ layer ][ combo ]:
  188. # Append is working strangely with list pre-initialization
  189. # Doing a 0 check replacement instead -HaaTa
  190. if len( self.triggerList[ layer ][ combo ] ) == 0:
  191. self.triggerList[ layer ][ combo ] = [ triggerIndex ]
  192. else:
  193. self.triggerList[ layer ][ combo ].append( triggerIndex )
  194. # Look for max Scan Code
  195. if combo > self.maxScanCode[ layer ]:
  196. self.maxScanCode[ layer ] = combo
  197. # Shrink triggerList to actual max size
  198. self.triggerList[ layer ] = self.triggerList[ layer ][ : self.maxScanCode[ layer ] + 1 ]
  199. # Calculate first scan code for layer, useful for uC implementations trying to save RAM
  200. firstScanCode = 0
  201. for triggerList in range( 0, len( self.triggerList[ layer ] ) ):
  202. firstScanCode = triggerList
  203. # Break if triggerList has items
  204. if len( self.triggerList[ layer ][ triggerList ] ) > 0:
  205. break;
  206. self.firstScanCode.append( firstScanCode )
  207. # Determine overall maxScanCode
  208. self.overallMaxScanCode = 0x00
  209. for maxVal in self.maxScanCode:
  210. if maxVal > self.overallMaxScanCode:
  211. self.overallMaxScanCode = maxVal
  212. class Variables:
  213. # Container for variables
  214. # Stores three sets of variables, the overall combined set, per layer, and per file
  215. def __init__( self ):
  216. pass
  217. def baseLayerFinished( self ):
  218. pass
  219. def setCurrentFile( self, name ):
  220. # Store using filename and current layer
  221. pass
  222. def setCurrentLayer( self, layer ):
  223. # Store using layer index
  224. pass
  225. def assignVariable( self, key, value ):
  226. pass