4 from oauth import oauth
5 from xml.dom.minidom import parseString
6 from org.maemo.hermes.engine.phonenumber import PhoneNumber
7 from org.maemo.hermes.engine.friend import Friend
10 """LinkedIn API for Hermes.
12 Copyright (c) Fredrik Wendt <fredrik@wendt.se> 2010.
13 Copyright (c) Andrew Flegg <andrew@bleb.org> 2010.
14 Released under the Artistic Licence."""
16 LI_API_URL = "https://api.linkedin.com"
17 LI_CONN_API_URL = LI_API_URL + "/v1/people/~/connections:(id,first-name,last-name,picture-url,site-standard-profile-request:(url),date-of-birth,main-address,location:(country:(code)),phone-numbers,member-url-resources)"
18 LI_PROFILE_API_URL = LI_API_URL + "/v1/people/~"
21 # -----------------------------------------------------------------------
22 def __init__(self, consumer, api_request):
23 """Instantiate with an OAuth consumer"""
24 self.consumer = consumer
25 self._make_api_request = api_request
28 # -----------------------------------------------------------------------
29 def verify_verifier(self, access_token):
31 xml = self._make_api_request(self.LI_PROFILE_API_URL)
32 dom = parseString(xml)
33 friends = self._parse_dom(dom)
34 return friends[0].get_name()
38 raise Exception("LinkedIn authorization failed, try again")
42 # -----------------------------------------------------------------------
43 def get_friends(self):
44 """ Returns a Friend object for each LinkedIn connection."""
46 xml = self._make_api_request(self.LI_CONN_API_URL)
47 dom = parseString(xml)
48 friends = self._parse_dom(dom)
53 # -----------------------------------------------------------------------
54 def get_friend_details(self, url, header_value):
55 oauth_request = oauth.OAuthRequest.from_consumer_and_token(self.consumer, token=self.access_token, http_url=url)
56 oauth_request.sign_request(self.sig_method, self.consumer, self.access_token)
58 headers = oauth_request.to_header()
59 headers[u'x-li-auth-token'] = header_value
60 connection = httplib.HTTPConnection("api.linkedin.com")
61 connection.request(oauth_request.http_method, url, headers=headers)
62 data = connection.getresponse().read()
66 # -----------------------------------------------------------------------
67 def _parse_dom(self, dom):
68 def get_first_tag(node, tagName):
70 tags = node.getElementsByTagName(tagName)
71 if tags and len(tags) > 0:
74 def extract(node, tagName):
75 tag = get_first_tag(node, tagName)
77 return tag.firstChild.nodeValue
79 def extract_public_url(node):
80 tag = get_first_tag(node, 'site-standard-profile-request')
82 url = extract(tag, 'url').replace("&", "&")
83 return re.sub('[?&](auth|trk)\w*=[^&]*', '', url)
85 def extract_phone_numbers(node):
86 country = extract(get_first_tag(node, 'country'), 'code')
87 tag = get_first_tag(node, 'phone-numbers')
90 for element in tag.childNodes:
91 if element.nodeName != 'phone-number':
94 phone_type = extract(element, 'phone-type')
95 device = phone_type == 'mobile' and phone_type or None
96 type = phone_type in set(['home', 'work']) and phone_type or None
98 number = PhoneNumber(extract(element, 'phone-number'), device = device, type = type, country = country)
99 numbers.append(number)
102 def extract_urls(node):
103 tag = get_first_tag(node, 'member-url-resources')
106 for element in tag.getElementsByTagName('url'):
107 urls.append(element.firstChild.nodeValue.replace("&", "&"))
110 def extract_birthday(node):
111 tag = get_first_tag(node, 'date-of-birth')
114 month = extract(tag, 'month')
115 day = extract(tag, 'day')
116 year = extract(tag, 'year')
118 bday = '%s/%s' % (extract(tag, 'month'), extract(tag, 'day'))
120 bday = '%s/%s' % (bday, year)
125 errors = dom.getElementsByTagName('error')
126 if (errors and len(errors) > 0):
129 details = " (" + extract(errors[0], "message") + ")"
132 raise Exception("LinkedIn communication errors detected" + details)
135 people = dom.getElementsByTagName('person')
137 fn = extract(p, 'first-name')
138 ln = extract(p, 'last-name')
139 photo_url = extract(p, 'picture-url')
140 id = extract(p, 'id')
141 public_url = extract_public_url(p)
142 bday = extract_birthday(p)
145 friend = Friend(name)
146 friend.add_url(public_url)
148 friend.set_photo_url(photo_url)
151 friend.set_birthday_date(bday)
153 for number in extract_phone_numbers(p):
154 friend.add_phone(number)
156 for url in extract_urls(p):
159 friends.append(friend)