Metadata-Version: 2.1
Name: stytch
Version: 5.7.0
Summary: Stytch python client
Home-page: UNKNOWN
Author: Stytch
Author-email: hello@stytch.com
License: MIT
Download-URL: https://github.com/stytchauth/stytch-python
Description: # Stytch Python Library
        
        The Stytch Python library makes it easy to use the Stytch user infrastructure API in Python applications.
        
        It pairs well with the Stytch [Web SDK](https://www.npmjs.com/package/@stytch/stytch-js) or your own custom authentication flow.
        
        ## Requirements
        
        The Stytch Python library supports Python 3.4+
        
        ## Installation
        
        ```
        pip install stytch
        ```
        
        ## Usage
        
        You can find your API credentials in the [Stytch Dashboard](https://stytch.com/dashboard/api-keys).
        
        This client library supports all of Stytch's live products:
          - [x] [Email Magic Links](https://stytch.com/docs/api/send-by-email)
          - [x] [Embeddable Magic Links](https://stytch.com/docs/api/create-magic-link-overview)
          - [x] [OAuth logins](https://stytch.com/docs/api/oauth-overview)
          - [x] [SMS passcodes](https://stytch.com/docs/api/send-otp-by-sms)
          - [x] [WhatsApp passcodes](https://stytch.com/docs/api/whatsapp-send)
          - [x] [Email passcodes](https://stytch.com/docs/api/send-otp-by-email)
          - [x] [Session Management](https://stytch.com/docs/api/sessions-overview)
          - [x] [WebAuthn](https://stytch.com/docs/api/webauthn-overview)
          - [x] [Time-based one-time passcodes (TOTPs)](https://stytch.com/docs/api/totps-overview)
          - [x] [Crypto wallets](https://stytch.com/docs/api/crypto-wallet-overview)
          - [x] [Passwords (Beta)](https://stytch.com/docs/api/password-overview)
        
        ### Example usage
        Create an API client:
        ```python
        from stytch import Client
        
        client = Client(
            project_id="project-live-c60c0abe-c25a-4472-a9ed-320c6667d317",
            secret="secret-live-80JASucyk7z_G8Z-7dVwZVGXL5NT_qGAQ2I=",
            environment="test",
        )
        ```
        
        Send a magic link by email:
        ```python
        resp = client.magic_links.email.login_or_create(
            email="sandbox@stytch.com",
            login_magic_link_url="https://example.com/authenticate",
            signup_magic_link_url="https://example.com/authenticate",
        )
        print(resp.json())
        ```
        
        Authenticate the token from the magic link:
        ```python
        resp = client.magic_links.authenticate(
            token="DOYoip3rvIMMW5lgItikFK-Ak1CfMsgjuiCyI7uuU94=",
        )
        print(resp.json())
        ```
        
        ## Handling Errors
        
        Structured errors from the Stytch API will be raised as `StytchError` exceptions.
        ```python
        from stytch.api.error import StytchError
        
        try:
            resp = client.magic_links.authenticate(token="token")
        except StytchError as error:
            # Handle Stytch errors here
            if error.error_type == "invalid_token":
                print("Whoops! Try again?")
        except Exception as error:
            # Handle other errors here
            pass
        ```
        Learn more about errors in the [docs](https://stytch.com/docs/api/errors).
        
        ## Documentation
        
        See example requests and responses for all the endpoints in the [Stytch API Reference](https://stytch.com/docs/api).
        
        Follow one of the [integration guides](https://stytch.com/docs/guides) or start with one of our [example apps](https://stytch.com/docs/example-apps).
        
        ## Support
        
        If you've found a bug, [open an issue](https://github.com/stytchauth/stytch-python/issues/new)!
        
        If you have questions or want help troubleshooting, join us in [Slack](https://join.slack.com/t/stytch/shared_invite/zt-nil4wo92-jApJ9Cl32cJbEd9esKkvyg) or email support@stytch.com.
        
        If you've found a security vulnerability, please follow our [responsible disclosure instructions](https://stytch.com/docs/security).
        
        ## Development
        
        See DEVELOPMENT.md
        
        ## Code of Conduct
        
        Everyone interacting in the Stytch project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
        
Keywords: stytch,user,authentication
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
