python-webfinger

A simple Python client implementation of WebFinger RFC 7033.

Go to file

buttoj3 142bba7a6d Work towards the security stuff described at http://code.google.com/p/webfinger/wiki/WebFingerProtocol The code now looks for the host-meta file via https. If it doesn't find it it falls back to http, but causes the response's 'insecure' attribute to be set to True. The 'insecure' attribute also gets set to True if the user's XRD URL is not an https:// url. This doesn't do any checking of certificate validity, or check whether the XML is signed.		2011-04-11 12:12:16 +01:00
.gitignore	…
LICENSE	…
README.rst	big ol' refactor. add web finger relation shortcuts. add class-based webfinger client.	2010-02-12 23:53:49 -05:00
pywebfinger.py	Work towards the security stuff described at	2011-04-11 12:12:16 +01:00
requirements.txt	add updated requirements file	2010-02-12 23:00:39 -05:00

README.rst

================
python-webfinger
================

Usage
=====

Example::

	from pywebfinger import finger
	
	wf = finger('user@host.com')
	print wf.profile
	print wf.hcard

The following relation types are supported:

* avatar: http://webfinger.net/rel/avatar
* hcard: http://microformats.org/profile/hcard
* open_id: http://specs.openid.net/auth/2.0/provider
* portable_contacts: http://portablecontacts.net/spec/1.0
* profile: http://webfinger.net/rel/profile-page
* xfn: http://gmpg.org/xfn/11

Other relation types can be accessed directly from the XRD document.::

	print wf.find_link('http://example.com/example/spec', attr='href')

Dependencies
============

* `python-xrd <http://github.com/jcarbaugh/python-xrd>`_
* iso8601 (required by python-xrd)

License
=======

python-webfinger is distributed under the `BSD license <http://creativecommons.org/licenses/BSD/>`_.

See LICENSE for the full terms of the BSD license.