{ "info": { "author": "Greene Lab", "author_email": "team@greenelab.com", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "====================\nTribe-Client\n====================\n\nTribe-client is a portable Python app to connect your bioinformatics server\nor tool to the 'Tribe' web service (located at https://tribe.greenelab.com).\n\nThis package allows web servers created using\n`Django `_ to connect directly\nto Tribe and make use of its resources. Users of the client web server or tool\ncan access their Tribe resources via Tribe `OAuth2 `_\nauthentication.\n\n\nRequirements\n------------\nIf you are using tribe-client in a web server that uses Django, we recommend\nyou use Django version 1.8 or newer.\n\n\nDownload and Install\n---------------------\nTribe-client is registered as \"tribe-client\" in PyPI and is pip\ninstallable:\n\n.. code-block:: shell\n\n\tpip install tribe-client\n\n\n\nQuick Start with Django\n------------------------\n\n\n1. Add ``tribe_client`` to your ``INSTALLED_APPS`` setting:\n\n.. code-block:: python\n\n INSTALLED_APPS = (\n ...\n 'tribe_client',\n )\n\n\n2. Include the tribe-client URLconf in your project's URLconf (usually\n``urls.py``):\n\n.. code-block:: python\n\n from django.conf.urls import url, patterns, include\n\n urlpatterns = patterns('',\n ...\n (r'^tribe_client/', include('tribe_client.urls')),\n )\n\n\n3. Register your client server at\nhttps://tribe.greenelab.com/oauth2/applications/. Make sure to:\n\n a. Be logged-in using your Tribe account\n b. Select \"Confidential\" under ``Client type`` and\n c. Select \"Authorization Code\" under ``Authorization grant type``\n 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**\n\n .. note:: Currently, Tribe supports the following ``Authorization grant types``:\n\n * Authorization code\n * Resource owner password-based\n\n and does not support the following:\n\n * Implicit\n * Client credentials\n\n\n4. Write down the Client ID in the ``TRIBE_ID`` setting and the Client secret\nin the ``TRIBE_SECRET`` setting in your ``settings.py`` file like so:\n\n.. code-block:: python\n\n TRIBE_ID = '*****Tribe Client ID*****'\n TRIBE_SECRET = '*****Tribe Client Secret*****'\n\n\n5. The ``TRIBE_REDIRECT_URI`` setting should be the address of the client\nserver plus \"/tribe_client/get_token\".\n\n.. code-block:: python\n\n TRIBE_REDIRECT_URI = 'http://example.com/tribe_client/get_token'\n\n\n6. Define in your settings the scope that your client server should have\nfor Tribe resources. The two options are: 'read' and 'write'.The default\nis 'read'. **Note:** The 'write' scope includes the 'read' scope access. \n\n.. code-block:: python\n\n TRIBE_SCOPE = 'write' # Or 'read'\n\n\n7. (Optional) If you want to use tribe_client's templates, make sure you have\na base template (which gets extended by your other templates and contains\nthe ``{% block content %} {% endblock %}`` statements) that the tribe_client\ntemplates can extend, and specify its name in your settings. The name of this\nsetting is ``TRIBE_CLIENT_BASE_TEMPLATE``. By default, tribe_client will\nlook for a template called ``base.html``.\n\n.. code-block:: python\n\n TRIBE_CLIENT_BASE_TEMPLATE = 'name_of_your_main_template.html'\n\n\n8. (Optional) If you want to use tribe_client's built-in login templates and\nurls, make a link that takes the user to the ``connect_to_tribe`` url in your\nwebsite. This url will show users the built-in Tribe login page.\nBelow is an example of this type of link in the webpage's navbar:\n\n.. code-block:: html\n\n
\n \n
\n\n\n9. (Optional) If you want to redirect your users to somewhere other than\nthe ``/tribe_client/display_genesets`` url after they have logged in,\nyou can define this in the ``TRIBE_LOGIN_REDIRECT`` setting in your\n``settings.py`` file. **Note:** If you are not using the tribe-client\nbuilt-in templates (see above), you will need to define this setting so\nyour users have somewhere to go after they log in.\n\n.. code-block:: python\n\n TRIBE_LOGIN_REDIRECT = '/place-to-go-after-login'\n\n\n10. (Optional) If you want to redirect your users to somewhere other than\nthe ``/tribe_client`` url after they log out, you can define this in the\n``TRIBE_LOGOUT_REDIRECT`` setting in your ``settings.py`` file.\n**Note:** If you are not using the tribe-client built-in templates (see above),\nyou will need to define this setting so your users have somewhere to go after\nthey log out.\n\n.. code-block:: python\n\n TRIBE_LOGOUT_REDIRECT = '/place-to-go-after-logout'\n\n\n11. (Optional) If you want to download and pickle gene sets/collections from\nTribe by using the ``tribe_client_pickle_public_genesets`` management command,\nyou must customize the following setting in ``settings.py``:\n\n.. code-block:: python\n \n # Location of folder where pickled gene set files will be saved to.\n # This can be a subdirectory in your server's path (as shown here),\n # or not.\n PUBLIC_GENESET_FOLDER = os.path.join(\n , )\n\n\nand run the following management command: \n\n.. code-block:: shell\n\n python manage.py tribe_client_pickle_public_genesets\n\n\nThis will download and pickle all the public Tribe collections for every\norganism in your database. This is handy in case you want to do many gene\nset enrichment analyses across thousands of gene sets saved in Tribe, or any\nother task that would require making frequent, large, time-consuming requests\nfor gene sets.\n\n\nA Closer Look\n-----------------------------\n\nUnder the hood, tribe-client has functions that:\n\n1) Get an access token (via the `OAuth2 `_ protocol) that\nallows users to access and create resources in Tribe.\n\n2) Retrieves public and private collections (and their versions) and displays\nthem on the client server using views and templates included in the package.\n\n3) Allows users to create new collections and versions remotely, from the\nclient server.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/greenelab/tribe-client", "keywords": "", "license": "LICENSE.txt", "maintainer": "", "maintainer_email": "", "name": "tribe-client", "package_url": "https://pypi.org/project/tribe-client/", "platform": "", "project_url": "https://pypi.org/project/tribe-client/", "project_urls": { "Homepage": "https://github.com/greenelab/tribe-client" }, "release_url": "https://pypi.org/project/tribe-client/1.1.11/", "requires_dist": null, "requires_python": "", "summary": "Portable Python package to connect with the Tribe web service at the University of Pennsylvania", "version": "1.1.11" }, "last_serial": 3301368, "releases": { "1.1.10": [ { "comment_text": "", "digests": { "md5": "da942ac64c135ee275ab0a6de1dbafe3", "sha256": "56ace9825cc21069785743beeb94215c917c05af83f07a84585c026bf996ec57" }, "downloads": -1, "filename": "tribe-client-1.1.10.tar.gz", "has_sig": false, "md5_digest": "da942ac64c135ee275ab0a6de1dbafe3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17312, "upload_time": "2017-10-25T15:57:07", "url": "https://files.pythonhosted.org/packages/f5/a0/0d869763cf39e5c3b0e125731b908fc7ccba9d13d2e71a6eb12af3177a2f/tribe-client-1.1.10.tar.gz" } ], "1.1.11": [ { "comment_text": "", "digests": { "md5": "5b24b24181dbd47f475e2f6c4f4085da", "sha256": "6df42fb5d1927115064152c499f01e6e6553d5db1c967b06a566c70299904c9c" }, "downloads": -1, "filename": "tribe-client-1.1.11.tar.gz", "has_sig": false, "md5_digest": "5b24b24181dbd47f475e2f6c4f4085da", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17753, "upload_time": "2017-11-02T21:05:36", "url": "https://files.pythonhosted.org/packages/ca/00/5899e1581fb31bc55606192307b142883f9054b9d3b2c1e20637619b0145/tribe-client-1.1.11.tar.gz" } ], "1.1.3": [ { "comment_text": "", "digests": { "md5": "2775a497b26aa7dcd19662c6bad41da0", "sha256": "911b7c0e9808e49f50740f8f6e450f99bdaba23fd4458ed6ebfc4c47aa049a30" }, "downloads": -1, "filename": "tribe-client-1.1.3.tar.gz", "has_sig": false, "md5_digest": "2775a497b26aa7dcd19662c6bad41da0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10629, "upload_time": "2016-09-08T15:34:11", "url": "https://files.pythonhosted.org/packages/bd/79/3f1bfa70517f992b0117b46d4270cb286d4640932f3b68cfc89ec4e91176/tribe-client-1.1.3.tar.gz" } ], "1.1.5": [ { "comment_text": "", "digests": { "md5": "2b162b7f9cc970718dac4dc105ae57ec", "sha256": "5b6279119d6a756044e81beaba041ad897687bb27f1159e2a41db0f01690b8a4" }, "downloads": -1, "filename": "tribe-client-1.1.5.tar.gz", "has_sig": false, "md5_digest": "2b162b7f9cc970718dac4dc105ae57ec", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12141, "upload_time": "2016-10-06T13:56:18", "url": "https://files.pythonhosted.org/packages/8a/be/640a68a85c764ffc82985e945b38f2cd236d7d021093d8f04825321c603c/tribe-client-1.1.5.tar.gz" } ], "1.1.6": [ { "comment_text": "", "digests": { "md5": "6dcd9645f1ba0e20d730b0595fef9e66", "sha256": "124ab1e6ebba5ec70a68160851448520e81338ccdbd1a6f00331bad1db31ecc9" }, "downloads": -1, "filename": "tribe-client-1.1.6.tar.gz", "has_sig": false, "md5_digest": "6dcd9645f1ba0e20d730b0595fef9e66", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12320, "upload_time": "2016-12-07T18:12:17", "url": "https://files.pythonhosted.org/packages/fc/f6/f6e729731be9ddca838da8af5b0c4f21bf0c6afd13cf93a51d45c163dfa5/tribe-client-1.1.6.tar.gz" } ], "1.1.7": [ { "comment_text": "", "digests": { "md5": "e841297ae15227ab661c297f0b120a1d", "sha256": "1249954069dec12bd50b327dc5dbd6d6fe61d44cb43ab2d13c3156b1867d107d" }, "downloads": -1, "filename": "tribe-client-1.1.7.tar.gz", "has_sig": false, "md5_digest": "e841297ae15227ab661c297f0b120a1d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16577, "upload_time": "2017-02-08T20:15:32", "url": "https://files.pythonhosted.org/packages/b9/be/e7ad901902fc57c424df12ed51a539de9b70ab077e43b1865d9629af9324/tribe-client-1.1.7.tar.gz" } ], "1.1.8": [ { "comment_text": "", "digests": { "md5": "e216e239cd5fa6ad5ecd9bf919f412f3", "sha256": "ce5a1ef4888169526c4e1d2ad67ccb87c215fe89a64698ba045878e7e53f5731" }, "downloads": -1, "filename": "tribe-client-1.1.8.tar.gz", "has_sig": false, "md5_digest": "e216e239cd5fa6ad5ecd9bf919f412f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17260, "upload_time": "2017-02-24T17:01:58", "url": "https://files.pythonhosted.org/packages/bc/41/4664c9afc07f509a42bbd8242609d7f2d49cd5f6f3d729f1d28098645b8e/tribe-client-1.1.8.tar.gz" } ], "1.1.9": [ { "comment_text": "", "digests": { "md5": "8e03731d8df5a3320ff283ce2cdedd8c", "sha256": "4e99b444b9986e9232fc64fb793b4ed9e3d52574703cfc5024ae1709a0337f80" }, "downloads": -1, "filename": "tribe-client-1.1.9.tar.gz", "has_sig": false, "md5_digest": "8e03731d8df5a3320ff283ce2cdedd8c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17127, "upload_time": "2017-08-03T17:24:35", "url": "https://files.pythonhosted.org/packages/6c/0c/eb88915820e321b49e2358e8792ff3dbaa8c0d1fb7e7a89900e1f38220a2/tribe-client-1.1.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5b24b24181dbd47f475e2f6c4f4085da", "sha256": "6df42fb5d1927115064152c499f01e6e6553d5db1c967b06a566c70299904c9c" }, "downloads": -1, "filename": "tribe-client-1.1.11.tar.gz", "has_sig": false, "md5_digest": "5b24b24181dbd47f475e2f6c4f4085da", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17753, "upload_time": "2017-11-02T21:05:36", "url": "https://files.pythonhosted.org/packages/ca/00/5899e1581fb31bc55606192307b142883f9054b9d3b2c1e20637619b0145/tribe-client-1.1.11.tar.gz" } ] }