Python Client Library for Supabase Auth
Project description
Auth-py
This is a Python port of the supabase js gotrue client. The current state is that there is a features parity but with small differences that are mentioned in the section Differences to the JS client. As of December 14th, we renamed to repo from gotrue-py
to auth-py
to mirror the changes in the JavaScript library.
Installation
We are still working on making the supabase_auth
python library more user-friendly. For now here are some sparse notes on how to install the module.
Poetry
poetry add supabase_auth
Pip
pip install supabase_auth
Differences to the JS client
It should be noted there are differences to the JS client. If you feel particulaly strongly about them and want to motivate a change, feel free to make a GitHub issue and we can discuss it there.
Firstly, feature pairity is not 100% with the JS client. In most cases we match the methods and attributes of the JS client and api classes, but is some places (e.g for browser specific code) it didn't make sense to port the code line for line.
There is also a divergence in terms of how errors are raised. In the JS client, the errors are returned as part of the object, which the user can choose to process in whatever way they see fit. In this Python client, we raise the errors directly where they originate, as it was felt this was more Pythonic and adhered to the idioms of the language more directly.
In JS we return the error, but in Python we just raise it.
const { data, error } = client.sign_up(...)
The other key difference is we do not use pascalCase to encode variable and method names. Instead we use the snake_case convention adopted in the Python language.
Also, the supabase_auth
library for Python parses the date-time string into datetime
Python objects. The JS client keeps the date-time as strings.
Usage (outdated)
Important: This section is outdated, you can be guided by the JS client documentation because this Python client has a lot of parity with the JS client.
To instantiate the client, you'll need the URL and any request headers at a minimum.
from supabase_auth import SyncGoTrueClient
headers = {
"apiKey": "my-mega-awesome-api-key",
# ... any other headers you might need.
}
client: SyncGoTrueClient = SyncGoTrueClient(url="www.genericauthwebsite.com", headers=headers)
To send a magic email link to the user, just provide the email kwarg to the sign_in
method:
user: Dict[str, Any] = client.sign_up(email="example@gmail.com")
To login with email and password, provide both to the sign_in
method:
user: Dict[str, Any] = client.sign_up(email="example@gmail.com", password="*********")
To sign out of the logged in user, call the sign_out
method. We can then assert that the session and user are null values.
client.sign_out()
assert client.user() is None
assert client.session() is None
We can refesh a users session.
# The user should already be signed in at this stage.
user = client.refresh_session()
assert client.user() is not None
assert client.session() is not None
Contributions
We would be immensely grateful for any contributions to this project.
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
Built Distribution
Hashes for supabase_auth-2.5.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d0b86b5bdcf38cf8d288b38a6ed11866e48d2e69b6493d6c921bfff1773acb8a |
|
MD5 | 47caa2ceba710f915cf2fdb4a5cc553a |
|
BLAKE2b-256 | 2639a01f77dc5c4c61efeabf476bdab415a21006b0fdd9f0e9a3b7c08db9aaa8 |