the37lab-authlib 0.1.1750143654__py3-none-any.whl → 0.1.1750187527__py3-none-any.whl

the37lab_authlib/auth.py

@@ -130,7 +130,7 @@ class AuthManager:
         app.register_blueprint(self.create_blueprint())
 
     def create_blueprint(self):
-        bp = Blueprint('auth', __name__, url_prefix='/v1/users')
+        bp = Blueprint('auth', __name__, url_prefix='/api/v1/users')
 
         @bp.route('/login', methods=['POST'])
         @handle_auth_errors

the37lab_authlib-0.1.1750187527.dist-info/METADATA

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: the37lab_authlib
+Version: 0.1.1750187527
+Summary: Python SDK for the Authlib
+Author-email: the37lab <info@the37lab.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: flask
+Requires-Dist: psycopg2-binary
+Requires-Dist: pyjwt
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: authlib
+Requires-Dist: bcrypt
+
+# AuthLib
+
+A Python authentication library that provides JWT, OAuth2, and API token authentication with PostgreSQL backend. This library is designed for seamless integration with Flask applications and provides a robust set of endpoints and utilities for user management, authentication, and API token handling.
+
+## Table of Contents
+- [AuthLib](#authlib)
+  - [Table of Contents](#table-of-contents)
+  - [Installation](#installation)
+  - [Quick Start](#quick-start)
+  - [Configuration](#configuration)
+    - [Required Parameters](#required-parameters)
+    - [Optional Parameters](#optional-parameters)
+      - [Example `oauth_config`:](#example-oauth_config)
+  - [API Endpoints](#api-endpoints)
+    - [Authentication](#authentication)
+    - [User Management](#user-management)
+    - [API Tokens](#api-tokens)
+  - [Authentication Flow](#authentication-flow)
+  - [User Object](#user-object)
+  - [Token Management](#token-management)
+  - [Development](#development)
+    - [Setup](#setup)
+    - [Database Setup](#database-setup)
+    - [Running Tests](#running-tests)
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from flask import Flask
+from authlib import AuthManager
+
+app = Flask(__name__)
+
+auth = AuthManager(
+    app=app,
+    db_dsn="postgresql://user:pass@localhost/dbname",
+    jwt_secret="your-secret-key",
+    oauth_config={
+        "google": {
+            "client_id": "your-client-id",
+            "client_secret": "your-client-secret"
+        }
+    }
+)
+
+@app.route("/protected")
+@auth.require_auth(roles=["admin"])
+def protected_route():
+    return "Protected content"
+```
+
+## Configuration
+
+### Required Parameters
+- `app`: Flask application instance
+- `db_dsn`: PostgreSQL connection string
+- `jwt_secret`: Secret key for JWT signing
+
+### Optional Parameters
+- `oauth_config`: Dictionary of OAuth provider configurations (see below)
+- `token_expiry`: JWT token expiry time in seconds (default: 3600)
+- `refresh_token_expiry`: Refresh token expiry time in seconds (default: 2592000)
+
+#### Example `oauth_config`:
+```python
+{
+    "google": {
+        "client_id": "...",
+        "client_secret": "..."
+    },
+    "github": {
+        "client_id": "...",
+        "client_secret": "..."
+    }
+}
+```
+
+## API Endpoints
+
+### Authentication
+- `POST /api/v1/users/login` - Login with username/password
+  - **Request:** `{ "username": "string", "password": "string" }`
+  - **Response:** `{ "token": "jwt", "refresh_token": "jwt", "user": { ... } }`
+- `POST /api/v1/users/login/oauth` - Get OAuth redirect URL
+  - **Request:** `{ "provider": "google|github|..." }`
+  - **Response:** `{ "redirect_url": "string" }`
+- `GET /api/v1/users/login/oauth2callback` - OAuth callback
+  - **Query Params:** `code`, `state`, `provider`
+  - **Response:** `{ "token": "jwt", "refresh_token": "jwt", "user": { ... } }`
+- `POST /api/v1/users/token-refresh` - Refresh JWT token
+  - **Request:** `{ "refresh_token": "jwt" }`
+  - **Response:** `{ "token": "jwt", "refresh_token": "jwt" }`
+
+### User Management
+- `POST /api/v1/users/register` - Register new user
+  - **Request:** `{ "username": "string", "password": "string", "email": "string", ... }`
+  - **Response:** `{ "user": { ... }, "token": "jwt", "refresh_token": "jwt" }`
+- `GET /api/v1/users/login/profile` - Get user profile
+  - **Auth:** Bearer JWT
+  - **Response:** `{ "user": { ... } }`
+- `GET /api/v1/users/roles` - Get available roles
+  - **Response:** `[ "admin", "user", ... ]`
+
+### API Tokens
+- `POST /api/v1/users/{user}/api-tokens` - Create API token
+  - **Request:** `{ "name": "string", "scopes": [ ... ] }`
+  - **Response:** `{ "token": "string", "id": "uuid", ... }`
+- `GET /api/v1/users/{user}/api-tokens` - List API tokens
+  - **Response:** `[ { "id": "uuid", "name": "string", ... } ]`
+- `DELETE /api/v1/users/{user}/api-tokens/{token_id}` - Delete API token
+  - **Response:** `{ "success": true }`
+
+## Authentication Flow
+
+1. **Login:**
+   - User submits credentials to `/api/v1/users/login`.
+   - Receives JWT and refresh token.
+2. **Token Refresh:**
+   - Use `/api/v1/users/token-refresh` with refresh token to get new JWT.
+3. **OAuth:**
+   - Get redirect URL from `/api/v1/users/login/oauth`.
+   - Complete OAuth flow via `/api/v1/users/login/oauth2callback`.
+4. **Protected Routes:**
+   - Use `@auth.require_auth()` decorator to protect Flask routes.
+
+## User Object
+
+The user object returned by the API typically includes:
+```json
+{
+  "id": "uuid",
+  "username": "string",
+  "email": "string",
+  "roles": ["user", "admin"],
+  "created_at": "timestamp",
+  "last_login": "timestamp"
+}
+```
+
+## Token Management
+- **JWT:** Used for authenticating API requests. Include in `Authorization: Bearer <token>` header.
+- **Refresh Token:** Used to obtain new JWTs without re-authenticating.
+- **API Tokens:** Long-lived tokens for programmatic access, managed per user.
+
+## Development
+
+### Setup
+1. Clone the repository
+2. Create virtual environment:
+```bash
+python -m venv venv
+venv\Scripts\activate
+```
+3. Install dependencies:
+```bash
+pip install -e ".[dev]"
+```
+
+### Database Setup
+```bash
+createdb authlib
+python -m authlib.cli db init
+```
+
+### Running Tests
+```bash
+pytest
+```

{the37lab_authlib-0.1.1750143654.dist-info → the37lab_authlib-0.1.1750187527.dist-info}/RECORD

@@ -1,10 +1,10 @@
 the37lab_authlib/__init__.py,sha256=cFVTWL-0YIMqwOMVy1P8mOt_bQODJp-L9bfp2QQ8CTo,132
-the37lab_authlib/auth.py,sha256=VP1_E7_iYkt5fzm6wYCx5Jx8kQtUVQjUcLIwYN9FVyw,20656
+the37lab_authlib/auth.py,sha256=dQkE6z9GZZpnl0nfqulcveho8W5lM95XUBLmtE-5JIc,20660
 the37lab_authlib/db.py,sha256=fTXxnfju0lmbFGPVbXpTMeDmJMeBgURVZTndyxyRyCc,2734
 the37lab_authlib/decorators.py,sha256=AEQfix31fHUZvhEZd4Ud8Zh2KBGjV6O_braiPL-BU7w,1219
 the37lab_authlib/exceptions.py,sha256=mdplK5sKNtagPAzSGq5NGsrQ4r-k03DKJBKx6myWwZc,317
 the37lab_authlib/models.py,sha256=-PlvQlHGIsSdrH0H9Cdh_vTPlltGV8G1Z1mmGQvAg9Y,3422
-the37lab_authlib-0.1.1750143654.dist-info/METADATA,sha256=Gt1614KadiUN-Lb-7wXfXasFTHgsVL9YKG1msLnWxCI,2662
-the37lab_authlib-0.1.1750143654.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-the37lab_authlib-0.1.1750143654.dist-info/top_level.txt,sha256=6Jmxw4UeLrhfJXgRKbXWY4OhxRSaMs0dKKhNCGWWSwc,17
-the37lab_authlib-0.1.1750143654.dist-info/RECORD,,
+the37lab_authlib-0.1.1750187527.dist-info/METADATA,sha256=I1q0GUs96_gBGEDq4no_p0t_UXXyw5IlWsPVbaJJTnM,5641
+the37lab_authlib-0.1.1750187527.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+the37lab_authlib-0.1.1750187527.dist-info/top_level.txt,sha256=6Jmxw4UeLrhfJXgRKbXWY4OhxRSaMs0dKKhNCGWWSwc,17
+the37lab_authlib-0.1.1750187527.dist-info/RECORD,,

the37lab_authlib-0.1.1750143654.dist-info/METADATA

@@ -1,114 +0,0 @@
-Metadata-Version: 2.4
-Name: the37lab_authlib
-Version: 0.1.1750143654
-Summary: Python SDK for the Authlib
-Author-email: the37lab <info@the37lab.com>
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: flask
-Requires-Dist: psycopg2-binary
-Requires-Dist: pyjwt
-Requires-Dist: python-dotenv
-Requires-Dist: requests
-Requires-Dist: authlib
-Requires-Dist: bcrypt
-
-# AuthLib
-
-A Python authentication library that provides JWT, OAuth2, and API token authentication with PostgreSQL backend.
-
-## Table of Contents
-- [Installation](#installation)
-- [Quick Start](#quick-start)
-- [Configuration](#configuration)
-- [API Endpoints](#api-endpoints)
-- [Development](#development)
-
-## Installation
-
-```bash
-pip install -e .
-```
-
-## Quick Start
-
-```python
-from flask import Flask
-from authlib import AuthManager
-
-app = Flask(__name__)
-
-auth = AuthManager(
-    app=app,
-    db_dsn="postgresql://user:pass@localhost/dbname",
-    jwt_secret="your-secret-key",
-    oauth_config={
-        "google": {
-            "client_id": "your-client-id",
-            "client_secret": "your-client-secret"
-        }
-    }
-)
-
-@app.route("/protected")
-@auth.require_auth(roles=["admin"])
-def protected_route():
-    return "Protected content"
-```
-
-## Configuration
-
-### Required Parameters
-- `app`: Flask application instance
-- `db_dsn`: PostgreSQL connection string
-- `jwt_secret`: Secret key for JWT signing
-
-### Optional Parameters
-- `oauth_config`: Dictionary of OAuth provider configurations
-- `token_expiry`: JWT token expiry time in seconds (default: 3600)
-- `refresh_token_expiry`: Refresh token expiry time in seconds (default: 2592000)
-
-## API Endpoints
-
-### Authentication
-- `POST /v1/users/login` - Login with username/password
-- `POST /v1/users/login/oauth` - Get OAuth redirect URL
-- `GET /v1/users/login/oauth2callback` - OAuth callback
-- `POST /v1/users/token-refresh` - Refresh JWT token
-
-### User Management
-- `POST /v1/users/register` - Register new user
-- `GET /v1/users/login/profile` - Get user profile
-- `GET /v1/users/roles` - Get available roles
-
-### API Tokens
-- `POST /v1/users/{user}/api-tokens` - Create API token
-- `GET /v1/users/{user}/api-tokens` - List API tokens
-- `DELETE /v1/users/{user}/api-tokens/{token_id}` - Delete API token
-
-## Development
-
-### Setup
-1. Clone the repository
-2. Create virtual environment:
-```bash
-python -m venv venv
-venv\Scripts\activate
-```
-3. Install dependencies:
-```bash
-pip install -e ".[dev]"
-```
-
-### Database Setup
-```bash
-createdb authlib
-python -m authlib.cli db init
-```
-
-### Running Tests
-```bash
-pytest
-```