python-webfinger

A simple Python client implementation of WebFinger RFC 7033.

Go to file

Jeremy Carbaugh 3a4e6db04d Allow legacy mimetypes in JRD response		2013-11-01 16:37:27 -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.rst	2013-05-15 11:58:36 -03:00
requirements.txt	Remove python-rd requirement and make compatible with RFC 7033	2013-11-01 12:26:47 -04:00
setup.py	Change python-xrd to python-rd	2013-05-15 11:53:16 -03:00
webfinger.py	Allow legacy mimetypes in JRD response	2013-11-01 16:37:27 -04:00

README.rst

=========
webfinger
=========

Usage
=====

Example::

	from webfinger 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-rd <http://github.com/jcarbaugh/python-rd>`_

License
=======

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

See LICENSE for the full terms of the BSD license.