python-webfinger

A simple Python client implementation of WebFinger RFC 7033.

Go to file

Jeremy Carbaugh b893ca3fa8 remove unused re import		2010-02-12 23:54:47 -05:00
.gitignore	initial commit	2010-02-11 17:52:34 -05:00
LICENSE	add LICENSE file and basic README	2010-02-12 23:00:25 -05:00
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	remove unused re import	2010-02-12 23:54:47 -05: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.