python-webfinger

A simple Python client implementation of WebFinger RFC 7033.

Go to file

Jeremy Carbaugh adc391d8a9 add stuff for packaging		2012-04-04 18:19:42 -04:00
.gitignore	ignore build and dist dirs	2012-04-04 17:37:36 -04:00
LICENSE	add LICENSE file and basic README	2010-02-12 23:00:25 -05:00
MANIFEST.in	add stuff for packaging	2012-04-04 18:19:42 -04:00
README.rst	update README	2012-04-04 18:03:38 -04:00
pywebfinger.py	clean up main method	2012-04-04 18:19:34 -04:00
requirements.txt	change requirement to python-xrd	2012-04-04 17:37:21 -04:00
setup.py	add stuff for packaging	2012-04-04 18:19:42 -04: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:

* activity_streams: http://activitystrea.ms/spec/1.0
* avatar: http://webfinger.net/rel/avatar
* hcard: http://microformats.org/profile/hcard
* open_id: http://specs.openid.net/auth/2.0/provider
* opensocial: http://ns.opensocial.org/2008/opensocial/activitystreams
* 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>`_

License
=======

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

See LICENSE for the full terms of the BSD license.