description='Python client library for Freebase API service',
maintainer_email='developers@freebase.com',
url='http://www.freebase.com/',

INSTALL:
 
	/usr/bin/python setup.py install

    When using freebase-python with Google AppEngine you will also need to
    include the files in appengine_stubs with you AppEngine app.

SYNOPSIS:

	#!/usr/bin/python 

	import freebase

	query = {    'type':'/music/artist',
	             'name':'Sting',
	             'album':[],
	         }
	freebase.mqlread(query)
	
	for album in result.album:
		print album

   ----- OR -----
	
	#!/usr/bin/python
	
	from freebase import HTTPMetawebSession, MetawebError

	mss = HTTPMetawebSession('api.freebase.com')

	query = {    'type':'/music/artist',
	             'name':'Sting',
	             'album':[],
	         }

	result = mss.mqlread(query)

	for album in result.album:
	    print album

TESTING:
	
	cd test
	/usr/bin/python test_all.py -v

	test_login (__main__.TestFreebase) ... ok
	test_read (__main__.TestFreebase) ... ok
	test_write (__main__.TestFreebase) ... ok
	....
	
	----------------------------------------------------------------------
	Ran 12 tests in 0.691s

	OK

freebase-api is now the standard python api for accessing freebase.
metaweb-py has now been deprecated and can only be found in older
releases of freebase-api.

freebase-api is available under a simple 2-clause BSD-style license that
should allow you to reuse this code in both open-source and
commercial projects.

If you have suggestions, bug fixes, or feature requests for either
of these, please let one of the maintainers know or you can
discuss it on the Freebase developers list.