Initial commit of working .1dev version

Author: GraylinKim

README.rst

@@ -1,4 +1,60 @@
-SCII Replay
+sc2reader
 ============
 
+Parses replays from build version 16561 and up. After parsing, replays will have
+the following structure::
 
+    replay: {
+        'attributes': dict([player number,list( Attribute )]),
+        'build': int,
+        'date': string,
+        'events': list( Event ),
+        'eventsByType': dict([string,list( Event )]),
+        'length': (int,int),
+        'map': string,
+        'messages': list( Message ),
+        'players': list( Player ),
+        'recorder': Player,
+        'releaseString': string,
+        'results': dict([int,list( Player )]),
+        'speed': string,
+        'teams': dict([int, list( Player )]),
+        'type': string
+    }
+    
+And will contain the following objects::
+
+    player: {
+        'color': string,
+        'difficulty': string,
+        'handicap': int,
+        'name': string,
+        'pid': int (player number),
+        'race': string,
+        'recorder': boolean,
+        'result': string("Won/Lost/Unknown"),
+        'rgba': (int,int,int,int),
+        'team': int,
+        'type': string ("Human/Computer"),
+        'url': string (us.battle.net/sc2 url)
+    }
+    
+    event: {
+        'name': string,
+        'player': int (player number),
+        'time': int (in frames),
+        'timestr': "MM:SS",
+    }
+    
+    message: {
+        'player': int,
+        'target': int,
+        'text': string
+        'time': (minutes,seconds),
+    }
+    
+    attribute: {
+        'name': string,
+        'player': int,
+        'value': varies by attribute,
+    }

objects/__init__.py

@@ -0,0 +1,92 @@
+class Attribute(object):
+    
+    def __init__(self,data):
+        #Unpack the data values and add a default name of unknown to be
+        #overridden by known attributes; acts as a flag for exclusion
+        self.header,self.id,self.player,self.value,self.name = tuple(data+["Unknown"])
+        
+        #Clean the value of leading null bytes and decode it for easier and more
+        #readable comparisons in the decoding logic to follow
+        while(self.value[:2] == "00"):
+            self.value = self.value[2:]
+        self.value = self.value.decode("hex")
+        
+        
+        if self.id == 0x01F4:
+            self.name = "Player Type"
+            if   self.value == "Humn": self.value = "Human"
+            elif self.value == "Comp": self.value = "Computer"
+            
+        elif self.id == 0x07D1:
+            self.name = "Game Type"
+            
+        elif self.id == 0x0BB8:
+            self.name = "Game Speed"
+            if   self.value == "Slor": self.value = "Slower"
+            elif self.value == "Norm": self.value = "Normal"
+            elif self.value == "Fasr": self.value = "Faster"
+            
+        elif self.id == 0x0BB9:
+            self.name = "Race"
+            if   self.value == "Prot": self.value = "Protoss"
+            elif self.value == "Terr": self.value = "Terran"
+            elif self.value == "Rand": self.value = "Random"
+            
+        elif self.id == 0x0BBA:
+            self.name = "Color"
+            if   self.value == "tc01": self.value = "Red"
+            elif self.value == "tc02": self.value = "Blue"
+            elif self.value == "tc03": self.value = "Teal"
+            elif self.value == "tc04": self.value = "Purple"
+            elif self.value == "tc05": self.value = "Yellow"
+            elif self.value == "tc06": self.value = "Orange"
+            elif self.value == "tc07": self.value = "Green"
+            elif self.value == "tc08": self.value = "Pink"
+            
+        elif self.id == 0x0BBB:
+            self.name = "Handicap"
+            
+        elif self.id == 0x0BBC:
+            self.name = "Difficulty"
+            if   self.value == "VyEy": self.value = "Very Easy"
+            elif self.value == "Medi": self.value = "Medium"
+            elif self.value == "VyHd": self.value = "Very Hard"
+            elif self.value == "Insa": self.value = "Insane"
+            
+        elif self.id == 0x0BC1:
+            self.name = "Category"
+            if   self.value == "Priv": self.value = "Private"
+            elif self.value == "Amm": self.value = "Ladder"
+            
+        elif self.id == 0x07D2:
+            self.name = "Teams1v1"
+            #Get the raw team number
+            self.value = int(self.value[1:])
+            
+        elif self.id == 0x07D3:
+            self.name = "Teams2v2"
+            #Get the raw team number
+            self.value = int(self.value[1:],16)
+            
+        elif self.id == 0x07D4:
+            self.name = "Teams3v3"
+            #Get the raw team number
+            self.value = int(self.value[1:])
+            
+        elif self.id == 0x07D5:
+            self.name = "Teams4v4"
+            #Get the raw team number
+            self.value = int(self.value[1:])
+            
+        elif self.id == 0x07D6:
+            self.name = "TeamsFFA"
+            #Get the raw team number
+            self.value = int(self.value[1:])
+            
+        #print "%s (%s) - %s - %s" % (self.name,self.id,self.player,self.value)
+    
+    def __repr__(self):
+        return str(self)
+        
+    def __str__(self):
+        return str(self.value)