Skip to main content

Reusable Django app to connect servers with the Tribe web service at the University of Pennsylvania

Project description

Django Tribe Client

Tribe client is a simple `Django <>`_ app
to connect your server to the 'Tribe' web service (located at

This python package allows web servers created using django to connect directly
to Tribe and make use of its resources. Users of the client web server can
login to access their Tribe resources via Tribe `OAuth2 <>`_

Download and Install
Tribe-client is registered as "django-tribe-client" in PyPI and is pip

.. code-block:: shell

pip install django-tribe-client

Quick Start

1. Add ``tribe_client`` to your ``INSTALLED_APPS`` setting:

.. code-block:: python


2. Include the tribe-client URLconf in your project's URLconf (usually

.. code-block:: python

from django.conf.urls import url, patterns, include

urlpatterns = patterns('',
(r'^tribe_client/', include('tribe_client.urls')),

3. Register your client server at Make sure to:

a. Be logged-in using your Tribe account
b. Select "Confidential" under ``Client type`` and
c. Select "Authorization Code" under ``Authorization grant type``
d. Enter your client server's address plus "/tribe_client/get_token" in the ``Redirect uris`` box. If your client server's current address is, enter ****

.. note:: Currently, Tribe supports the following ``Authorization grant types``:

* Authorization code
* Resource owner password-based

and does not support the following:

* Implicit
* Client credentials

4. Write down the Client ID in the ``TRIBE_ID`` setting and the Client secret
in the ``TRIBE_SECRET`` setting in your ```` file like so:

.. code-block:: python

TRIBE_ID = '*****Tribe Client ID*****'
TRIBE_SECRET = '*****Tribe Client Secret*****'

5. The ``TRIBE_REDIRECT_URI`` setting should be the address of the client
server plus "/tribe_client/get_token".

.. code-block:: python


6. Make sure that you have a ``base.html`` template that the tribe_client
templates can extend

7. Make a link that takes the user to the ``/tribe_client`` url of your website
for them to log in using Tribe

A Closer Look

Under the hood, tribe-client has functions that:

1) Get an access token (via the `OAuth2 <>`_ protocol) that
allows users to access and create resources in Tribe.

2) Retrieves public and private collections (and their versions) and displays
them on the client server using views and templates included in the package.

3) Allows users to create new collections and versions remotely, from the
client server.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-tribe-client-1.1.2.tar.gz (10.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page