kinde-python-sdk 2.0.0b2__tar.gz → 2.0.0b4__tar.gz

kinde_python_sdk-2.0.0b4/MANIFEST.in

@@ -0,0 +1,14 @@
+include README.md
+include LICENSE
+recursive-include kinde_sdk *.py
+recursive-include kinde_sdk *.json
+recursive-include kinde_sdk *.yaml
+recursive-include kinde_sdk *.yml
+recursive-include kinde_fastapi *.py
+recursive-include kinde_fastapi *.json
+recursive-include kinde_fastapi *.yaml
+recursive-include kinde_fastapi *.yml
+recursive-include kinde_flask *.py
+recursive-include kinde_flask *.json
+recursive-include kinde_flask *.yaml
+recursive-include kinde_flask *.yml 

{kinde_python_sdk-2.0.0b2/kinde_python_sdk.egg-info → kinde_python_sdk-2.0.0b4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinde-python-sdk
-Version: 2.0.0b2
+Version: 2.0.0b4
 Summary: Connect your app to the Kinde platform
 Author-email: Kinde Engineering <engineering@kinde.com>
 Project-URL: Homepage, https://github.com/kinde-oss/kinde-python-sdk
@@ -166,6 +166,169 @@ data = storage_manager.get("some_key")
 # After initializing both OAuth and KindeApiClient use the following fn to get proper urls
 api_client.fetch_openid_configuration(oauth)
 
+## Framework Integrations
+
+The Kinde Python SDK provides seamless integration with popular Python web frameworks. Below are detailed guides for using Kinde with FastAPI and Flask.
+
+### FastAPI Integration
+
+The `kinde_fastapi` module provides easy integration with FastAPI applications.
+
+#### Installation
+
+```bash
+pip install fastapi uvicorn python-multipart
+```
+
+#### Basic Setup
+
+```python
+from fastapi import FastAPI
+from kinde_sdk.auth.oauth import OAuth
+
+# Initialize FastAPI app
+app = FastAPI()
+
+# Initialize Kinde OAuth with FastAPI framework
+kinde_oauth = OAuth(
+    framework="fastapi",
+    app=app
+)
+
+# Example home route
+@app.get("/")
+async def home(request: Request):
+    if kinde_oauth.is_authenticated():
+        user = kinde_oauth.get_user_info()
+        return f"Welcome, {user.get('email', 'User')}!"
+    return "Please log in"
+```
+
+#### Configuration
+
+Create a `.env` file with your Kinde credentials:
+
+```env
+KINDE_CLIENT_ID=your_client_id
+KINDE_CLIENT_SECRET=your_client_secret
+KINDE_REDIRECT_URI=http://localhost:8000/callback
+KINDE_DOMAIN=your_kinde_domain
+```
+
+#### Available Routes
+
+The FastAPI integration automatically provides these routes:
+
+- `/login` - Redirects to Kinde login
+- `/callback` - Handles OAuth callback
+- `/logout` - Logs out the user
+- `/register` - Redirects to Kinde registration
+- `/user` - Returns user information
+
+#### Protected Routes
+
+```python
+from fastapi import Depends
+from kinde_sdk.kinde_api_client import KindeApiClient
+
+@router.get("/protected")
+async def protected_route(
+    kinde_client: KindeApiClient = Depends(get_kinde_client)
+):
+    return {"message": "This is a protected route"}
+```
+
+### Flask Integration
+
+The `kinde_flask` module provides easy integration with Flask applications.
+
+#### Installation
+
+```bash
+pip install flask python-dotenv flask-session
+```
+
+#### Basic Setup
+
+```python
+from flask import Flask
+from kinde_sdk.auth.oauth import OAuth
+
+# Initialize Flask app
+app = Flask(__name__)
+
+# Configure Flask session
+app.config['SECRET_KEY'] = 'your-secret-key'
+app.config['SESSION_TYPE'] = 'filesystem'
+app.config['SESSION_PERMANENT'] = False
+
+# Initialize Kinde OAuth with Flask framework
+kinde_oauth = OAuth(
+    framework="flask",
+    app=app
+)
+
+# Example home route
+@app.route('/')
+def home():
+    if kinde_oauth.is_authenticated():
+        user = kinde_oauth.get_user_info()
+        return f"Welcome, {user.get('email', 'User')}!"
+    return "Please log in"
+```
+
+#### Configuration
+
+Create a `.env` file with your Kinde credentials:
+
+```env
+KINDE_CLIENT_ID=your_client_id
+KINDE_CLIENT_SECRET=your_client_secret
+KINDE_REDIRECT_URI=http://localhost:5000/callback
+KINDE_DOMAIN=your_kinde_domain
+```
+
+#### Available Routes
+
+The Flask integration automatically provides these routes:
+
+- `/login` - Redirects to Kinde login
+- `/callback` - Handles OAuth callback
+- `/logout` - Logs out the user
+- `/register` - Redirects to Kinde registration
+- `/user` - Returns user information
+
+#### Protected Routes
+
+```python
+from functools import wraps
+from flask import session, redirect
+
+def login_required(f):
+    @wraps(f)
+    def decorated_function(*args, **kwargs):
+        if not kinde_oauth.is_authenticated():
+            return redirect('/login')
+        return f(*args, **kwargs)
+    return decorated_function
+
+@app.route('/protected')
+@login_required
+def protected_route():
+    return {"message": "This is a protected route"}
+```
+
+#### Security Considerations
+
+For both FastAPI and Flask integrations:
+
+1. Always use HTTPS in production
+2. Use a secure session secret key
+3. Implement proper state parameter validation
+4. Handle OAuth errors appropriately
+5. Implement proper session management
+6. Consider implementing CSRF protection
+
 # Kinde Management API Module
 
 This module provides a client for the Kinde Management API, allowing you to manage users, organizations, roles, permissions, and feature flags programmatically.
@@ -542,15 +705,13 @@ def main():
 if __name__ == "__main__":
     main()
 
-```    
-
 ## Publishing
 
 The core team handles publishing.
 
 ## Contributing
 
-Please refer to Kinde’s [contributing guidelines](https://github.com/kinde-oss/.github/blob/489e2ca9c3307c2b2e098a885e22f2239116394a/CONTRIBUTING.md).
+Please refer to Kinde's [contributing guidelines](https://github.com/kinde-oss/.github/blob/489e2ca9c3307c2b2e098a885e22f2239116394a/CONTRIBUTING.md).
 
 ## License
 

{kinde_python_sdk-2.0.0b2 → kinde_python_sdk-2.0.0b4}/README.md

@@ -125,6 +125,169 @@ data = storage_manager.get("some_key")
 # After initializing both OAuth and KindeApiClient use the following fn to get proper urls
 api_client.fetch_openid_configuration(oauth)
 
+## Framework Integrations
+
+The Kinde Python SDK provides seamless integration with popular Python web frameworks. Below are detailed guides for using Kinde with FastAPI and Flask.
+
+### FastAPI Integration
+
+The `kinde_fastapi` module provides easy integration with FastAPI applications.
+
+#### Installation
+
+```bash
+pip install fastapi uvicorn python-multipart
+```
+
+#### Basic Setup
+
+```python
+from fastapi import FastAPI
+from kinde_sdk.auth.oauth import OAuth
+
+# Initialize FastAPI app
+app = FastAPI()
+
+# Initialize Kinde OAuth with FastAPI framework
+kinde_oauth = OAuth(
+    framework="fastapi",
+    app=app
+)
+
+# Example home route
+@app.get("/")
+async def home(request: Request):
+    if kinde_oauth.is_authenticated():
+        user = kinde_oauth.get_user_info()
+        return f"Welcome, {user.get('email', 'User')}!"
+    return "Please log in"
+```
+
+#### Configuration
+
+Create a `.env` file with your Kinde credentials:
+
+```env
+KINDE_CLIENT_ID=your_client_id
+KINDE_CLIENT_SECRET=your_client_secret
+KINDE_REDIRECT_URI=http://localhost:8000/callback
+KINDE_DOMAIN=your_kinde_domain
+```
+
+#### Available Routes
+
+The FastAPI integration automatically provides these routes:
+
+- `/login` - Redirects to Kinde login
+- `/callback` - Handles OAuth callback
+- `/logout` - Logs out the user
+- `/register` - Redirects to Kinde registration
+- `/user` - Returns user information
+
+#### Protected Routes
+
+```python
+from fastapi import Depends
+from kinde_sdk.kinde_api_client import KindeApiClient
+
+@router.get("/protected")
+async def protected_route(
+    kinde_client: KindeApiClient = Depends(get_kinde_client)
+):
+    return {"message": "This is a protected route"}
+```
+
+### Flask Integration
+
+The `kinde_flask` module provides easy integration with Flask applications.
+
+#### Installation
+
+```bash
+pip install flask python-dotenv flask-session
+```
+
+#### Basic Setup
+
+```python
+from flask import Flask
+from kinde_sdk.auth.oauth import OAuth
+
+# Initialize Flask app
+app = Flask(__name__)
+
+# Configure Flask session
+app.config['SECRET_KEY'] = 'your-secret-key'
+app.config['SESSION_TYPE'] = 'filesystem'
+app.config['SESSION_PERMANENT'] = False
+
+# Initialize Kinde OAuth with Flask framework
+kinde_oauth = OAuth(
+    framework="flask",
+    app=app
+)
+
+# Example home route
+@app.route('/')
+def home():
+    if kinde_oauth.is_authenticated():
+        user = kinde_oauth.get_user_info()
+        return f"Welcome, {user.get('email', 'User')}!"
+    return "Please log in"
+```
+
+#### Configuration
+
+Create a `.env` file with your Kinde credentials:
+
+```env
+KINDE_CLIENT_ID=your_client_id
+KINDE_CLIENT_SECRET=your_client_secret
+KINDE_REDIRECT_URI=http://localhost:5000/callback
+KINDE_DOMAIN=your_kinde_domain
+```
+
+#### Available Routes
+
+The Flask integration automatically provides these routes:
+
+- `/login` - Redirects to Kinde login
+- `/callback` - Handles OAuth callback
+- `/logout` - Logs out the user
+- `/register` - Redirects to Kinde registration
+- `/user` - Returns user information
+
+#### Protected Routes
+
+```python
+from functools import wraps
+from flask import session, redirect
+
+def login_required(f):
+    @wraps(f)
+    def decorated_function(*args, **kwargs):
+        if not kinde_oauth.is_authenticated():
+            return redirect('/login')
+        return f(*args, **kwargs)
+    return decorated_function
+
+@app.route('/protected')
+@login_required
+def protected_route():
+    return {"message": "This is a protected route"}
+```
+
+#### Security Considerations
+
+For both FastAPI and Flask integrations:
+
+1. Always use HTTPS in production
+2. Use a secure session secret key
+3. Implement proper state parameter validation
+4. Handle OAuth errors appropriately
+5. Implement proper session management
+6. Consider implementing CSRF protection
+
 # Kinde Management API Module
 
 This module provides a client for the Kinde Management API, allowing you to manage users, organizations, roles, permissions, and feature flags programmatically.
@@ -501,15 +664,13 @@ def main():
 if __name__ == "__main__":
     main()
 
-```    
-
 ## Publishing
 
 The core team handles publishing.
 
 ## Contributing
 
-Please refer to Kinde’s [contributing guidelines](https://github.com/kinde-oss/.github/blob/489e2ca9c3307c2b2e098a885e22f2239116394a/CONTRIBUTING.md).
+Please refer to Kinde's [contributing guidelines](https://github.com/kinde-oss/.github/blob/489e2ca9c3307c2b2e098a885e22f2239116394a/CONTRIBUTING.md).
 
 ## License
 

kinde_python_sdk-2.0.0b4/kinde_fastapi/examples/example_app.py

@@ -0,0 +1,61 @@
+from fastapi import FastAPI, Request
+from fastapi.responses import HTMLResponse
+from starlette.middleware.sessions import SessionMiddleware
+from .session import InMemorySessionMiddleware
+from pathlib import Path
+import os
+from dotenv import load_dotenv
+import logging
+from kinde_sdk.auth.oauth import OAuth
+
+logger = logging.getLogger(__name__)
+
+# Load environment variables from .env file
+load_dotenv()
+
+# Initialize FastAPI app
+app = FastAPI(title="Kinde FastAPI Example")
+
+# Add session middleware with proper configuration
+app.add_middleware(
+    InMemorySessionMiddleware,
+    max_age=3600,  # 1 hour
+    https_only=False
+)
+
+# Initialize Kinde OAuth with FastAPI framework
+kinde_oauth = OAuth(
+    framework="fastapi",
+    app=app
+)
+
+# Example home route
+@app.get("/", response_class=HTMLResponse)
+async def home(request: Request):
+    """
+    Home page that shows different content based on authentication status.
+    """
+    if kinde_oauth.is_authenticated():
+        user = kinde_oauth.get_user_info()
+        return f"""
+        <html>
+            <body>
+                <h1>Welcome, {user.get('email', 'User')}!</h1>
+                <p>You are logged in.</p>
+                <a href="/logout">Logout</a>
+            </body>
+        </html>
+        """
+    return """
+    <html>
+        <body>
+            <h1>Welcome to the Example App</h1>
+            <p>You are not logged in.</p>
+            <a href="/login">Login</a>
+        </body>
+    </html>
+    """
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="127.0.0.1", port=5000) 

kinde_python_sdk-2.0.0b4/kinde_fastapi/examples/session.py

@@ -0,0 +1,74 @@
+from fastapi import Request, Response
+import json
+import secrets
+from datetime import datetime, timedelta
+from typing import Optional, Any, Dict, Callable, Awaitable
+from threading import Lock
+from starlette.middleware.base import BaseHTTPMiddleware
+from starlette.types import ASGIApp, Receive, Scope, Send
+
+class InMemorySessionMiddleware(BaseHTTPMiddleware):
+    def __init__(
+        self,
+        app: ASGIApp,
+        session_cookie: str = "session",
+        max_age: int = 14 * 24 * 60 * 60,  # 14 days in seconds
+        same_site: str = "lax",
+        https_only: bool = False
+    ):
+        super().__init__(app)
+        self.session_cookie = session_cookie
+        self.max_age = max_age
+        self.same_site = same_site
+        self.https_only = https_only
+        self._sessions: Dict[str, Dict[str, Any]] = {}
+        self._lock = Lock()  # Thread safety for session operations
+
+    async def dispatch(self, request: Request, call_next):
+        session_id = request.cookies.get(self.session_cookie)
+        
+        if not session_id:
+            session_id = secrets.token_urlsafe(32)
+            session_data = {}
+        else:
+            session_data = self._get_session(session_id) or {}
+
+        # Add session to request scope
+        request.scope["session"] = session_data
+
+        # Process the request
+        response = await call_next(request)
+
+        # Update session in memory
+        if "session" in request.scope:
+            self._set_session(session_id, request.scope["session"])
+            
+            # Set cookie
+            response.set_cookie(
+                key=self.session_cookie,
+                value=session_id,
+                max_age=self.max_age,
+                httponly=True,
+                samesite=self.same_site,
+                secure=self.https_only
+            )
+
+        return response
+
+    def _get_session(self, session_id: str) -> Optional[Dict[str, Any]]:
+        with self._lock:
+            return self._sessions.get(session_id)
+
+    def _set_session(self, session_id: str, data: Dict[str, Any]) -> None:
+        with self._lock:
+            self._sessions[session_id] = data
+
+    def delete_session(self, session_id: str) -> None:
+        with self._lock:
+            self._sessions.pop(session_id, None)
+
+    def cleanup_expired_sessions(self) -> None:
+        """Optional: Method to clean up expired sessions if needed"""
+        with self._lock:
+            # Implementation would depend on how you want to track session expiration
+            pass 

kinde_python_sdk-2.0.0b4/kinde_fastapi/framework/__init__.py

@@ -0,0 +1,7 @@
+from .fastapi_framework import FastAPIFramework
+from .fastapi_framework_factory import FastAPIFrameworkFactory
+
+__all__ = [
+    'FastAPIFramework',
+    'FastAPIFrameworkFactory',
+]