Add canonical_email to user.User

[amstan]

I was looking for something immutable for each user (for https://github.com/tulir/mautrix-hangouts/issues/43). I was hoping i could get the user's proper email address.

Looks like user.User.emails is not really very reliable, it's simply a collection of email addresses it found in Google Contacts. I tried this experimentally: changing google contacts to something bogus yielded weird results to this array. I changed this

By doing a print(repr(entity)) in User.from_entity I noticed the entity had another cool property: canonical_email So I added is as another attribute of the User class.

[Terrance]

I was looking for something immutable

For what it's worth, that email field won't be immutable if you have a Google account without Gmail activated, as you can change your account's primary email address and that field would update to match. It's also not guaranteed to be filled in.

[tdryer]

Thanks!