Differential D8085 Diff 25095 contrib/buildbot/python_phabricator/README.rst

Changeset View

Standalone View

				python-phabricator
				==================

				.. image:: https://travis-ci.org/disqus/python-phabricator.png?branch=master
				:target: https://travis-ci.org/disqus/python-phabricator

				Installation
				------------

				::

				$ pip install phabricator

				Usage
				-----

				Use the API by instantiating it, and then calling the method through dotted notation chaining::

				from phabricator import Phabricator
				phab = Phabricator() # This will use your ~/.arcrc file
				phab.user.whoami()

				You can also use::

				phab = Phabricator(host='https://my-phabricator.org/api/', token='api-mytoken')

				Parameters are passed as keyword arguments to the resource call::

				phab.user.find(aliases=["sugarc0de"])

				Documentation on all methods is located at https://secure.phabricator.com/conduit/

				Interface out-of-date
				---------------------

				If Phabricator modifies Conduit and the included ``interfaces.json`` is out-of-date or to make sure
				to always have the latest interfaces::

				from phabricator import Phabricator
				phab = Phabricator()
				phab.update_interfaces()
				phab.user.whoami()