Skip to main content

A generalized library for storing native auth tokens

Project description

https://travis-ci.org/fair-research/native-login.svg?branch=master https://coveralls.io/repos/github/fair-research/native-login/badge.svg?branch=master https://img.shields.io/pypi/v/fair-research-login.svg https://img.shields.io/pypi/wheel/fair-research-login.svg License

Fair Research Login

This package makes writing Globus scripts and clients a breeze! Easily setup token management and local server login with a few lines of code. Easily extend components as your app grows and requires its own config.

Installation

The only requirements are the Globus SDK. Nothing else is required.

Install with pip:

pip install fair-research-login

Getting Started

You’ll need a Client ID from Globus. Follow these instructions from the Globus Auth Developer Guide. Be sure to check the Native App box in the registration form. Note the Client ID assigned by Globus. You’ll need it in your code, as shown in the example below.

Usage looks like this:

from fair_research_login.client import NativeClient

cli = NativeClient(client_id='<client_id>', app_name='My App')
cli.login()

The following example uses the Auth API to fetch the logged-in user’s identity data and print it:

from globus_sdk import AuthClient

auth_client = AuthClient(authorizer=cli.get_authorizers()['auth.globus.org'])
print(auth_client.oauth2_userinfo())

See the ‘examples’ directory for extended usage.

Refresh Tokens

By default, regular tokens will expire in a couple days. You can request refresh tokens to make user logins last forever. This is handy if you need to do long running tasks or small tasks every day, but you need to be absolutely certain these tokens are in a secure location.

Request refresh tokens with one extra argument to login:

cli.login(refresh_tokens=True)

Testing

Install the test requirements:

pip install -r test-requirements.txt

Run pytest:

pytest

See coverage with a couple more arguments:

pytest –cov=fair_research_login tests/

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

fair-research-login-0.1.1.tar.gz (25.7 kB view details)

Uploaded Source

File details

Details for the file fair-research-login-0.1.1.tar.gz.

File metadata

  • Download URL: fair-research-login-0.1.1.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.2

File hashes

Hashes for fair-research-login-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b5de66a41d94285e9c707fe65a3cf416cf9260b9af71ce4c392aae28e088e4b5
MD5 70180197605c4550bae10ddd4514195b
BLAKE2b-256 4c9f18ac8f12782e431e94482002a78a8f49295632eaa987dc869341bb309a0d

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page