A simple Python client implementation of WebFinger RFC 7033.
Go to file
Jeremy Carbaugh c22c5fd3d4 Update LICENSE 2013-11-02 02:48:47 -04:00
.gitignore
LICENSE Update LICENSE 2013-11-02 02:48:47 -04: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.