python-webfinger

A simple Python client implementation of WebFinger RFC 7033.

Go to file

Jeremy Carbaugh 0cfbc04cf9 leave scheme up to the user		2012-11-02 17:15:24 -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	Change package name to webfinger. Closes #4 .	2012-07-30 17:49:50 -04:00
requirements.txt	new requirements	2012-11-02 16:03:49 -04:00
setup.py	change repo name and user agent string back to python-webfinger	2012-07-30 18:01:36 -04:00
webfinger.py	leave scheme up to the user	2012-11-02 17:15:24 -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-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.