Add CI, release workflow, docs, and badges

Author: Kubenew

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install ruff black
+      - run: ruff check .
+      - run: black --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]" || pip install -e .
+      - run: pytest tests/ -v
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build

.github/workflows/deploy-docs.yml

@@ -0,0 +1,35 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/configure-pages@v4
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version'
+        required: true
+        default: '0.1.0'
+      changelog:
+        description: 'Changelog'
+        required: true
+        default: '- Initial release'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: softprops/action-gh-release@v1
+        with:
+          tag_name: v${{ github.event.inputs.version }}
+          release_name: fastapi-authz-lite v${{ github.event.inputs.version }}
+          body: |
+            ## Changelog
+            ${{ github.event.inputs.changelog }}
+
+            ```bash
+            pip install fastapi-authz-lite
+            ```
+          draft: false

README.md

@@ -1,6 +1,11 @@
-# fastapi-auth-kit
+# fastapi-authz-lite
 
-`fastapi-auth-kit` provides plug-and-play authentication for FastAPI.
+[![PyPI Version](https://img.shields.io/pypi/v/fastapi-authz-lite)](https://pypi.org/project/fastapi-authz-lite/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/fastapi-authz-lite)](https://pypi.org/project/fastapi-authz-lite/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://github.com/Kubenew/fastapi-auth-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/Kubenew/fastapi-auth-kit/actions/workflows/ci.yml)
+
+`fastapi-authz-lite` provides plug-and-play authentication for FastAPI.
 
 ## Features (v0.1.0)
 

docs/api.md

@@ -0,0 +1,21 @@
+# API Reference
+
+## auth.create_token
+
+Create a JWT token.
+
+```python
+token = auth.create_token({"sub": "user@example.com"})
+```
+
+## require_user
+
+FastAPI dependency for protected routes.
+
+```python
+from fastapi_auth_kit import require_user
+
+@app.get("/protected")
+def protected(user = require_user):
+    return {"user": user}
+```

docs/index.md

@@ -0,0 +1,23 @@
+# fastapi-authz-lite
+
+Plug-and-play authentication for FastAPI.
+
+## Features
+
+- JWT access token creation + verification
+- Password hashing (bcrypt)
+- FastAPI dependency: `require_user()`
+
+## Quick Start
+
+```bash
+pip install fastapi-authz-lite
+```
+
+```python
+from fastapi_auth_kit import auth, require_user
+
+@app.get("/protected")
+def protected(user = require_user):
+    return {"user": user}
+```

docs/installation.md

@@ -0,0 +1,5 @@
+# Installation
+
+```bash
+pip install fastapi-authz-lite
+```

docs/usage.md

@@ -0,0 +1,13 @@
+# Usage
+
+```python
+from fastapi import FastAPI
+from fastapi_auth_kit import auth
+
+app = FastAPI()
+
+@app.post("/login")
+def login():
+    token = auth.create_token({"sub": "user@example.com"})
+    return {"access_token": token}
+```

mkdocs.yml

@@ -0,0 +1,20 @@
+site_name: fastapi-authz-lite
+site_description: Plug-and-play authentication for FastAPI
+site_url: https://Kubenew.github.io/fastapi-auth-kit
+repo_name: Kubenew/fastapi-auth-kit
+repo_url: https://github.com/Kubenew/fastapi-auth-kit
+
+theme:
+  name: material
+  palette:
+    primary: purple
+    accent: light purple
+
+nav:
+  - Home: index.md
+  - Installation: installation.md
+  - Usage: usage.md
+  - API: api.md
+
+plugins:
+  - search