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 <https://docs.djangoproject.com/en/dev/>`_ app
to connect your server to the 'Tribe' web service (located at
https://tribe.greenelab.com).
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 <http://oauth.net/2/>`_
authentication.
Download and Install
---------------------
Tribe-client is registered as "django-tribe-client" in PyPI and is pip
installable:
.. code-block:: shell
pip install django-tribe-client
Quick Start
---------------------
1. Add ``tribe_client`` to your ``INSTALLED_APPS`` setting:
.. code-block:: python
INSTALLED_APPS = (
...
'tribe_client',
)
2. Include the tribe-client URLconf in your project's URLconf (usually
``urls.py``):
.. 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
https://tribe.greenelab.com/oauth2/applications/. 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 http://example.com, enter **http://example.com/tribe_client/get_token**
.. 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 ``settings.py`` 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
TRIBE_REDIRECT_URI = 'http://example.com/tribe_client/get_token'
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 <http://oauth.net/2/>`_ 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.
Django Tribe Client
=====
Tribe client is a simple `Django <https://docs.djangoproject.com/en/dev/>`_ app
to connect your server to the 'Tribe' web service (located at
https://tribe.greenelab.com).
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 <http://oauth.net/2/>`_
authentication.
Download and Install
---------------------
Tribe-client is registered as "django-tribe-client" in PyPI and is pip
installable:
.. code-block:: shell
pip install django-tribe-client
Quick Start
---------------------
1. Add ``tribe_client`` to your ``INSTALLED_APPS`` setting:
.. code-block:: python
INSTALLED_APPS = (
...
'tribe_client',
)
2. Include the tribe-client URLconf in your project's URLconf (usually
``urls.py``):
.. 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
https://tribe.greenelab.com/oauth2/applications/. 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 http://example.com, enter **http://example.com/tribe_client/get_token**
.. 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 ``settings.py`` 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
TRIBE_REDIRECT_URI = 'http://example.com/tribe_client/get_token'
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 <http://oauth.net/2/>`_ 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
Release history Release notifications | RSS feed
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)
Close
Hashes for django-tribe-client-1.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e7985b944ca00a990a28e0293ea5f92db894a7237b216e5b3aa8453a47b9796 |
|
MD5 | c3278ce8c68ae76f1a54d473f4346e2c |
|
BLAKE2b-256 | 1ce4eb22412d5208e62a2e117c0e2640eed554e9a1116c63a0872f61555f5aa8 |