https://github.com/miklevin/ohawf
The easiest Google OAuth2 you ever did see.
https://github.com/miklevin/ohawf
nbdev oauth oauth2 oauth2-authentication
Last synced: 6 months ago
JSON representation
The easiest Google OAuth2 you ever did see.
- Host: GitHub
- URL: https://github.com/miklevin/ohawf
- Owner: miklevin
- License: apache-2.0
- Created: 2021-03-08T18:25:42.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-04T22:24:05.000Z (almost 3 years ago)
- Last Synced: 2025-04-17T12:48:24.502Z (6 months ago)
- Topics: nbdev, oauth, oauth2, oauth2-authentication
- Language: JavaScript
- Homepage: http://miklevin.github.io/ohawf/
- Size: 461 KB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ohawf
================
## Install
``` sh
pip install -U ohawf
```
Are you trying to log into Google Analytics, Search Console, or even
Google Photos from a Jupyter Notebook? Does all the advice telling you
to register as a
developer and the
mangled [Google
examples](https://developers.google.com/webmaster-tools/search-console-api-original/v3/quickstart/quickstart-python)
have you frustrated? Well then, ***ohawf*** is for you.
## How to use
``` python
import ohawf
creds = ohawf.get()
```
### Why So Easy?
Google OAuth2 woes go away once you can use the authentication scheme
that pops up the same **“login as Google”** web-prompt that all Mobile
and Web apps seem to be using these days. It doesn’t seem possible, but
this authentication scheme actually works from a Jupyter Notebook in
JupyterLab.
Ohawf makes JupyterLab behave like an installed app, so that when you
first run **creds= ohawf.get()**, you’ll be presented with the “Login
with Google” prompt. Just just wait a moment, it will pop up a window
separate from JupyterLab’s own, and let you log in then prompt you to
close the window. If not, Drink Me.
### A Tale of 2 Installed App Flows
What makes ohawf work is this line:
``` python
from google_auth_oauthlib.flow import InstalledAppFlow
```
#### The Old Way: Copy/Paste Token
InstalledAppFlow’s ***run_console()*** prompts you to copy/paste a token
from a browser tab to Jupyter and used to work well, but that approach
has been deprecated. It can still be forced to work, but it’s not so
easy.
#### The New Way: Gotta Have a Webserver
The new way which is now the ohawf default is ***run_local_server()***.
This is what you encounter all the time with mobile apps when you see
“Login with Google”. An embedded browser pops up, goes through login,
then returns you to the mobile app. This works in Jupyter too. If you
have problems, run Jupyter this
way. And if you need to force ohawf to use run_console() for a
server installation, you can do this:
``` python
import ohawf
creds = ohawf.get(cli=True)
```
But then you’ll have to whitelist your email address, and you can only
do that through the [Google Cloud
Console](https://console.cloud.google.com/) so chicken-and-egg. If you
have to go that route, consider just registering as a Google developer
and downloading a OAuth Client secret json file like this:
- Go to
- Make sure you’re in the correct Google account.
- Create a new Project.
- Go to API & Services.
- Enable the APIs & Services you want to use.
- Go to Credentials.
- Create a new OAuth 2.0 Client IDs of the Desktop App type.
- Go to OAuth consent screen and set it up.
- Go to +Add users, under test users (gets around tight security)
- Add the users for the test (your gmail, necessary even though already
the app owner)
- Go back to Credentials and download OAuth Client.
- Typically,
***client_secret\_\[secret\].apps.googleusercontent.com.json***
- Use that file with ohawf
Once you have the Client Secret JSON file, you can call ohawf like this:
``` python
import ohawf
creds = ohawf.get(file="client_secret.json")
```
### Adding Scopes
The ohawf package uses the following default scopes if you don’t set
any:
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/youtube.readonly
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/webmasters.readonly
https://www.googleapis.com/auth/yt-analytics.readonly
https://www.googleapis.com/auth/photoslibrary.readonly
If you want to set your own scopes, create a Python list of scopes and
feed it to ohawf:
``` python
scopes = ["https://www.googleapis.com/auth/spreadsheets"]
creds = ohawf(scopes=scopes)
```
## Google Services
from apiclient.discovery import build
Connect to Google services by giving ***build*** any (activated) API
name, version and credentials such listing your GSC sites:
gsc_service = build('searchconsole', 'v1', credentials=cred)
gsc_sites = gsc_service.sites().list().execute()
[print(x['siteUrl']) for x in gsc_sites['siteEntry']];
…or this go list your GA accounts:
ga_service = build('analytics', 'v3', credentials=cred)
ga_accounts = ga_service.management().accounts().list().execute()
[print((x['id'], x['name'])) for x in ga_accounts['items']];
## Copyright (c) 2023 Mike Levin
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
“Software”), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
# Privacy Policy
## Last updated: December 31, 2022
This app does not collect nor use any of Your Personal data.