pyxpo-web-browser

An in-app browser and OAuth sign-in sessions for pyxpo apps. The API follows expo-web-browser. iOS uses SFSafariViewController and ASWebAuthenticationSession; Android uses Custom Tabs (androidx.browser).

pip install pyxpo-web-browser

[tool.pyxpo]
scheme = "myapp"
modules = ["web-browser"]

import pyxpo_web_browser as WebBrowser

result = await WebBrowser.open_browser_async("https://pyxpo.dev", toolbar_color="#202020")

result = await WebBrowser.open_auth_session_async(
    "https://auth.example.com/authorize?client_id=abc&redirect_uri=myapp%3A%2F%2Fcallback", "myapp://callback")
if result["type"] == "success":
    query = parse_qs(urlparse(result["url"]).query)

Functions

camelCase names work too (openBrowserAsync, toolbarColor=...).

Options

Sign-in on Android

Custom Tabs have no sign-in session. The package opens the page and waits for the redirect to come back as a deep link, so redirect_url must use the app's scheme. The tab opens in the app's task, and the redirect closes it. When the user returns to the app without the redirect, the call returns {"type": "dismiss"}.

Android 15 and later

While a tab is on top, the app is in the background. Android 15+ blocks activity starts from background apps and freezes their processes a few seconds later. So dismiss_browser() and dismiss_auth_session() called while a tab is showing may not close it: the calls still return, and the app resumes when the user leaves the tab. Sign-in redirects are not affected, because the system delivers the deep link.

Platforms

iOS and Android. On desktop, open_browser_async opens the system browser and open_auth_session_async raises NotSupportedError.