4 Grandcentral Dialer backend code
5 Eric Warnke <ericew@gmail.com>
14 from browser_emu import MozillaEmulator
17 class GCDialer(object):
19 This class encapsulates all of the knowledge necessary to interace with the grandcentral servers
20 the functions include login, setting up a callback number, and initalting a callback
23 _gcDialingStrRe = re.compile("This may take a few seconds", re.M) # string from Grandcentral.com on successful dial
24 _validateRe = re.compile("^[0-9]{10,}$")
25 _accessTokenRe = re.compile(r"""<input type="hidden" name="a_t" [^>]*value="(.*)"/>""")
26 _isLoginPageRe = re.compile(r"""<form method="post" action="https://www.grandcentral.com/mobile/account/login">""")
27 _callbackRe = re.compile(r"""name="default_number" value="(\d+)" />\s+(.*)\s$""", re.M)
28 _accountNumRe = re.compile(r"""<img src="/images/mobile/inbox_logo.gif" alt="GrandCentral" />\s*(.{14})\s* """, re.M)
29 _inboxRe = re.compile(r"""<td>.*?(voicemail|received|missed|call return).*?</td>\s+<td>\s+<font size="2">\s+(.*?)\s+ \| \s+<a href="/mobile/contacts/.*?">(.*?)\s?</a>\s+<br/>\s+(.*?)\s?<a href=""", re.S)
31 _forwardselectURL = "http://www.grandcentral.com/mobile/settings/forwarding_select"
32 _loginURL = "https://www.grandcentral.com/mobile/account/login"
33 _setforwardURL = "http://www.grandcentral.com/mobile/settings/set_forwarding?from=settings"
34 _clicktocallURL = "http://www.grandcentral.com/mobile/calls/click_to_call?a_t=%s&destno=%s"
35 _inboxallURL = "http://www.grandcentral.com/mobile/messages/inbox?types=all"
37 def __init__(self, cookieFile = None):
38 # Important items in this function are the setup of the browser emulation and cookie file
40 if cookieFile is None:
41 cookieFile = os.path.join(os.path.expanduser("~"), ".gc_dialer_cookies.txt")
42 self._browser = MozillaEmulator(None, 0)
43 self._browser.cookies.filename = cookieFile
44 if os.path.isfile(cookieFile):
45 self._browser.cookies.load()
47 # self._browser.cookies.save()
49 self._accessToken = None
50 self._accountNum = None
52 def grabToken(self, data):
53 "Pull the magic cookie from the datastream"
54 atGroup = GCDialer._accessTokenRe.search(data)
56 self._accessToken = atGroup.group(1)
60 anGroup = GCDialer._accountNumRe.search(data)
62 self._accountNum = anGroup.group(1)
66 def getAccountNumber(self):
67 return self._accountNum
71 Attempts to detect a current session and pull the
72 auth token ( a_t ) from the page
74 self._lastData = self._browser.download(GCDialer._forwardselectURL)
75 self._browser.cookies.save()
76 if GCDialer._isLoginPageRe.search(self._lastData) is None:
77 self.grabToken(self._lastData)
81 def login(self, username, password):
83 Attempt to login to grandcentral
88 loginPostData = urllib.urlencode( {'username' : username , 'password' : password } )
89 self._lastData = self._browser.download(GCDialer._loginURL, loginPostData)
90 return self.isAuthed()
92 def setSaneCallback(self):
94 Try to set a sane default callback number on these preferences
95 1) 1747 numbers ( Gizmo )
96 2) anything with gizmo in the name
97 3) anything with computer in the name
100 numbers = self.getCallbackNumbers()
102 for number, description in numbers.iteritems():
103 if not re.compile(r"""1747""").match(number) is None:
104 self.setCallbackNumber(number)
107 for number, description in numbers.iteritems():
108 if not re.compile(r"""gizmo""", re.I).search(description) is None:
109 self.setCallbackNumber(number)
112 for number, description in numbers.iteritems():
113 if not re.compile(r"""computer""", re.I).search(description) is None:
114 self.setCallbackNumber(number)
117 for number, description in numbers.iteritems():
118 self.setCallbackNumber(number)
121 def getCallbackNumbers(self):
123 @returns a dictionary mapping call back numbers to descriptions
127 self._lastData = self._browser.download(GCDialer._forwardselectURL)
128 for match in GCDialer._callbackRe.finditer(self._lastData):
129 retval[match.group(1)] = match.group(2)
133 def setCallbackNumber(self, callbacknumber):
135 set the number that grandcental calls
136 this should be a proper 10 digit number
138 callbackPostData = urllib.urlencode({'a_t' : self._accessToken, 'default_number' : callbacknumber })
139 self._lastData = self._browser.download(GCDialer._setforwardURL, callbackPostData)
140 self._browser.cookies.save()
142 def getCallbackNumber(self):
143 for c in self._browser.cookies:
144 if c.name == "pda_forwarding_number":
149 self._browser.cookies.clear()
150 self._browser.cookies.save()
152 def validate(self, number):
154 Can this number be called ( syntax validation only )
156 return GCDialer._validateRe.match(number) is not None
158 def dial(self, number):
160 This is the main function responsible for initating the callback
162 # If the number is not valid throw exception
163 if self.validate(number) is False:
164 raise ValueError('number is not valid')
166 # No point if we don't have the magic cookie
167 if not self.isAuthed():
170 # Strip leading 1 from 11 digit dialing
171 if len(number) == 11 and number[0] == 1:
174 self._lastData = self._browser.download(
175 GCDialer._clicktocallURL % (self._accessToken, number),
176 None, {'Referer' : 'http://www.grandcentral.com/mobile/messages'}
179 if GCDialer._gcDialingStrRe.search(self._lastData) is not None:
184 def get_recent(self):
185 self._lastData = self._browser.download(GCDialer._inboxallURL)
186 for match in self._inboxRe.finditer(self._lastData):
187 #print "type: %s date: %s person: %s number: %s" % (match.group(1), match.group(2), match.group(3), match.group(4))
188 yield (match.group(4), "%s on %s from/to %s - %s" % (match.group(1).capitalize(), match.group(2), match.group(3), match.group(4)))