daniel-sources 1.2.0__tar.gz

daniel_sources-1.2.0/.env.example

@@ -0,0 +1,10 @@
+# Rename to .env and add your OWN credentials. Never commit real .env files.
+STRIPE_SECRET_KEY=sk_test_replace_me
+STRIPE_WEBHOOK_SECRET=whsec_replace_me
+SMTP_HOST=
+SMTP_FROM=
+SMTP_USERNAME=
+SMTP_PASSWORD=
+
+# Optional: set to 0 in your OS shell before import to disable automatic .env loading
+# DANIEL_SOURCES_AUTO_DOTENV=0

daniel_sources-1.2.0/FUNCTION_INDEX.md

@@ -0,0 +1,89 @@
+# Complete public API index
+
+**60 exported names** in `daniel_sources.py`. Import with `import daniel_sources as ds`.
+
+| Name | Signature | What it does |
+|---|---|---|
+| `hash` | `(hashType: str, content: str \| bytes)` | Return a hexadecimal digest, e.g. hash('SHA256', 'hello'). |
+| `compare_hash` | `(hashType: str, content: str \| bytes, expected_hex: str)` | Constant-time comparison of a computed digest and expected hex digest. |
+| `password_hash` | `(password: str, method: str='scrypt')` | Werkzeug-compatible password hash, as used for KleeQuiz user accounts. |
+| `password_verify` | `(password: str, stored_hash: str)` | Validate a Werkzeug-style stored password hash. |
+| `random_token` | `(nbytes: int=32)` | Generate a cryptographically secure URL-safe token. |
+| `generate_code` | `(length: int=6)` | Generate a cryptographically secure, zero-padded numeric code. |
+| `hash_code` | `(code: str, secret: str \| None=None)` | KleeQuiz-compatible SHA256(secret + '\|' + code) hash. |
+| `verify_code` | `(code: str, saved_digest: str, *, secret: str \| None=None)` | Check a code against a KleeQuiz-style secret-bound digest. |
+| `create_api_key` | `(prefix: str='kq_live_')` | Generate a raw API key (store its SHA256 hash, not the raw string). |
+| `hash_api_key` | `(key: str)` | SHA256 hash of an API key, compatible with APIStore/hash_key. |
+| `hash_key` | `(raw: str)` | (see code) |
+| `safe_prefix` | `(raw: str)` | (see code) |
+| `APIStore` | `(class)` | SQLite-backed API keys, credit ledger, usage, and developer portal sessions. |
+| `KeyRecord` | `(class)` | (see code) |
+| `utc_now` | `()` | (see code) |
+| `utc_iso` | `()` | (see code) |
+| `generate_encryption_key` | `()` | Generate a Fernet key suitable for encrypt/decrypt; keep it secret. |
+| `derive_fernet_key` | `(secret: str)` | Derive the legacy KleeQuiz quiz-file Fernet key from its configured secret. |
+| `encrypt` | `(data: str \| bytes, key: str \| bytes)` | Encrypt text or bytes into a Fernet token string (key must be stable). |
+| `decrypt` | `(token: str \| bytes, key: str \| bytes, *, as_bytes: bool=False)` | Decrypt a Fernet token; fails for invalid tokens or wrong keys. |
+| `jwt_create` | `(payload: dict, secret: str, *, expires_in: int=3600)` | Sign an HS256 JWT, expiring in expires_in seconds by default. |
+| `jwt_read` | `(token: str, secret: str)` | Verify an HS256 JWT signature and expiration (raises on failure). |
+| `getenv_bool` | `(name: str, default: bool=False)` | Parse a Boolean environment variable as in production _bool_env(). |
+| `required_env` | `(name: str)` | Read a nonempty environment variable or raise a clear error. |
+| `normalize_phone` | `(value: str)` | Normalize international E.164-ish phone numbers, or return None. |
+| `normalize_promo_code` | `(value: str)` | Uppercase and keep only alphanumeric, hyphen, underscore (max 64). |
+| `slugify` | `(name: str, max_length: int=60)` | Build a URL slug. Doesn't check a database for collisions. |
+| `generate_invite_code` | `(name: str='KleeQuiz')` | Random educator-style invitation code; caller must check uniqueness in DB. |
+| `browser_label` | `(user_agent: str)` | Identify the browser category using KleeQuiz's User-Agent rules. |
+| `safe_filename` | `(name: str)` | Reduce a path to a safe ASCII filename; no traversal or separators. |
+| `allowed_file` | `(name: str, extensions=('.pdf', '.docx'))` | Check an extension; does NOT inspect the file's contents. |
+| `extract_document` | `(path: str \| Path)` | Extract text from PDF or DOCX files like KleeQuiz production does. |
+| `split_chunks` | `(text_value: str, size: int=18000)` | Split long text near paragraph boundaries, extracted from KleeQuiz. |
+| `image_data_url` | `(path: str \| Path)` | Convert an image on disk to an inline data: URL. |
+| `load_json` | `(path: str \| Path, default=None)` | Read a JSON file or return default if it doesn't exist. |
+| `save_json` | `(path: str \| Path, data, *, indent: int=2)` | Atomically write UTF-8 JSON, replacing any existing file. |
+| `question_id` | `(source: str, question: str)` | KleeQuiz legacy ID: SHA1 of source + '\|' + question (not for security). |
+| `question_key` | `(question: dict)` | Stable SHA256 identifier using question ID or canonical content. |
+| `parse_question_types` | `(raw: str \| list[str])` | Normalize KleeQuiz question type aliases, reject unsupported types. |
+| `balanced_plan` | `(count: int, selected: list[str])` | Developer API round-robin plan; respects the requested type order. |
+| `build_question_type_plan` | `(count: int, selected_types: list[str])` | KleeQuiz Production's weighted mixed-question allocator. |
+| `validate_question` | `(question: dict, source: str, requested_type: str)` | Validate a question in the original KleeQuiz format; return clean copy. |
+| `question_type_prompt` | `(question_type: str)` | KleeQuiz AI instruction corresponding to a single question type. |
+| `reference_text_from_package` | `(payload: dict)` | Render existing quiz questions as reference material for the generator. |
+| `quiz_required_plan_from_questions` | `(questions: list[dict])` | Infer KleeQuiz required membership from the question features. |
+| `build_quiz_package` | `(title: str, source: str, questions: list[dict], key: str, *, source_kind: str='study_material', generation_style: str='study', required_plan: str \| None=None, assets: dict[str, bytes] \| None=None)` | Export a KleeQuiz-compatible encrypted .kleequiz container in memory. |
+| `read_quiz_package_bytes` | `(blob: bytes, key: str)` | Read and validate encrypted .kleequiz bytes using their original key. |
+| `export_quiz_file` | `(path: str \| Path, title: str, source: str, questions: list[dict], key: str, **kwargs)` | Write an encrypted KleeQuiz quiz file. |
+| `import_quiz_file` | `(path: str \| Path, key: str)` | Read an encrypted KleeQuiz quiz file. |
+| `send_email` | `(to_email: str, subject: str, body: str, *, host: str \| None=None, port: int \| None=None, sender: str \| None=None, username: str \| None=None, password: str \| None=None, use_ssl: bool \| None=None, use_tls: bool \| None=None, reply_to: str \| None=None)` | Send a plain-text SMTP email, adapted from KleeQuiz production. |
+| `credits_to_cents` | `(credits: int, credits_per_usd: int=100)` | Developer API conversion: default 100 credits = USD $1.00. |
+| `create_stripe_checkout` | `(amount_cents: int \| None=None, *, api_key: str \| None=None, currency: str='usd', product_name: str='Purchase', success_url: str, cancel_url: str, price_id: str \| None=None, mode: str='payment', quantity: int=1, metadata: dict \| None=None, customer_email: str \| None=None, client_reference_id: str \| None=None, idempotency_key: str \| None=None)` | Create a hosted Stripe Checkout Session; returns stripe Session with .url. |
+| `create_credits_checkout` | `(key_id: int, credits: int, *, api_key: str \| None=None, base_url: str, credits_per_usd: int=100, currency: str='usd')` | Create developer-API-style credit recharge Checkout Session. |
+| `verify_stripe_webhook` | `(payload: str \| bytes, signature: str, webhook_secret: str \| None=None)` | Verify Stripe-Signature before processing event. Returns parsed Stripe Event. |
+| `paid_credits_from_webhook` | `(event, *, credits_per_usd: int=100, currency: str='usd')` | Check an ALREADY VERIFIED Stripe event's amount/currency/metadata. |
+| `api_request` | `(method: str, url: str, *, bearer_token: str \| None=None, json_body: dict \| None=None, timeout: float=30, params: dict \| None=None)` | Call a JSON API with optional Bearer token; raises for HTTP errors. |
+| `generate_quiz_via_api` | `(document_path: str \| Path, question_type_plan: list[str], *, api_url: str, api_key: str, timeout_seconds: int=300, difficulty: str='normal', seed: int=2026)` | Send a document to the KleeQuiz Developer API for text-only quiz generation. |
+| `KleeQuizDeveloperAPIError` | `(class)` | KleeQuiz developer API error. |
+| `configure_rotating_logger` | `(name: str, file_path: str \| Path, *, level: int=logging.INFO, max_bytes: int=5 * 1024 * 1024, backups: int=5)` | Configure named rotating file logger without changing root loggers. |
+| `RateLimiter` | `(class)` | Thread-safe in-process sliding 60-second request limiter. |
+
+## Public methods of key classes
+
+- **`APIStore.create_key`** — See docstring/source
+- **`APIStore.authenticate`** — See docstring/source
+- **`APIStore.list_keys`** — See docstring/source
+- **`APIStore.revoke_key`** — See docstring/source
+- **`APIStore.key_info`** — See docstring/source
+- **`APIStore.credit_balance`** — See docstring/source
+- **`APIStore.reserve_credits`** — See docstring/source
+- **`APIStore.refund_credits`** — See docstring/source
+- **`APIStore.add_credits`** — See docstring/source
+- **`APIStore.recent_ledger`** — See docstring/source
+- **`APIStore.recent_usage`** — See docstring/source
+- **`APIStore.create_portal_session`** — See docstring/source
+- **`APIStore.portal_session_key`** — See docstring/source
+- **`APIStore.delete_portal_session`** — See docstring/source
+- **`APIStore.log_usage`** — See docstring/source
+- **`RateLimiter.allow`** — Return True if allowed (and record it); False if at limit.
+
+### Extra helper included in pip version
+
+- `load_env(path=".env", *, override=False)` — Load environment variables from a `.env` file using `python-dotenv` (called explicitly; never automatically on import).

daniel_sources-1.2.0/INSTALL_WINDOWS.txt

@@ -0,0 +1,22 @@
+INSTALL DANIEL SOURCES IN ANY WINDOWS VENV
+=======================================
+1. Extract this ZIP to any folder. Open PowerShell in that folder.
+2. In an existing project, create a virtual environment if needed:
+   py -m venv .venv
+3. Install from the source folder (replace C:\path\to...):
+   .\.venv\Scripts\python.exe -m pip install "C:\path\to\Daniel_Sources_Pip_Package_v1_2"
+   OR install from the prebuilt wheel:
+   .\.venv\Scripts\python.exe -m pip install "C:\path\to\daniel_sources-1.2.0-py3-none-any.whl"
+4. Verify:
+   .\.venv\Scripts\python.exe -c "import daniel_sources as ds; print(ds.hash('SHA256', 'hello'))"
+5. Add this to your app:
+   import daniel_sources as ds
+
+All eight dependencies are installed into the venv by pip, using package metadata.
+You do not need to activate the venv to use its Python executable.
+
+The short command `pip install daniel_sources` from the internet requires
+publishing the distribution to PyPI first. No upload has been performed.
+
+TIP: A `.env` file in your current project folder is auto-loaded on import,
+without overriding environment variables. This is independent of `.venv`.

daniel_sources-1.2.0/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include FUNCTION_INDEX.md
+include SOURCES.md
+include example_project.py
+include INSTALL_WINDOWS.txt
+include requirements.txt
+include .env.example
+include test_daniel_sources.py
+recursive-include docs *.md
+prune dist
+prune build
+prune .venv

daniel_sources-1.2.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: daniel_sources
+Version: 1.2.0
+Summary: Reusable Python utilities for hashing, encryption, Stripe Checkout, documents, and quiz projects
+Author: Daniel
+Keywords: utilities,hashing,stripe,quizzes,pdf,environment
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=42.0
+Requires-Dist: Werkzeug>=3.0
+Requires-Dist: PyJWT>=2.9
+Requires-Dist: requests>=2.31
+Requires-Dist: stripe>=12.0
+Requires-Dist: pypdf>=5.0
+Requires-Dist: python-docx>=1.1
+Requires-Dist: python-dotenv>=1.0
+
+# daniel_sources — pip-installable Python utility library
+
+**Python 3.10 or newer** · **Version 1.2.0** · import as `import daniel_sources as ds`
+
+This is a reusable standalone module adapted from your KleeQuiz production + developer source code. It includes hashing/password helpers, JWTs, encryption, random codes, email, Stripe Checkout/webhook utilities, PDFs and DOCX, quizzes, SQLite API-key/credits helpers, and the Developer API client.
+
+## Install from the ZIP (works now, even before PyPI publishing)
+
+1. Extract the ZIP. Open a terminal in the extracted folder containing `pyproject.toml`.
+2. Install it in your active Python environment:
+
+```powershell
+python -m pip install .
+```
+
+**Windows virtual environment (no activation required):**
+
+```powershell
+py -m venv .venv
+.\.venv\Scripts\python.exe -m pip install .
+.\.venv\Scripts\python.exe -c "import daniel_sources as ds; print(ds.hash('SHA256', 'hello'))"
+```
+
+This automatically installs all eight declared third-party dependencies, *into the selected Python environment*: `cryptography`, `Werkzeug`, `PyJWT`, `requests`, `stripe`, `pypdf`, `python-docx`, and `python-dotenv`. Dependencies may require an internet connection if pip hasn't cached them. You do **not** need to install a separate requirements file.
+
+**If you have the wheel instead** (from the included `dist` folder):
+
+```powershell
+python -m pip install .\dist\daniel_sources-1.2.0-py3-none-any.whl
+```
+
+## Code examples
+
+```python
+import daniel_sources as ds
+
+print(ds.hash("SHA256", "hello"))
+code = ds.generate_code()
+key = ds.generate_encryption_key()
+print(ds.decrypt(ds.encrypt("hello", key), key))
+```
+
+## Virtual environments and `.env` files
+
+Make a `.env` file beside your project (not inside the installed library):
+
+```dotenv
+STRIPE_SECRET_KEY=sk_test_your_own_key_here
+STRIPE_WEBHOOK_SECRET=whsec_your_own_signing_secret_here
+```
+
+`import daniel_sources` automatically loads the `.env` file in your **current working directory**, without overwriting existing environment variables. It does not look inside other projects or search parent folders. This is separate from the Python virtual environment `.venv` folder.
+
+```python
+import os
+import daniel_sources as ds  # loads .env in your project folder, if present
+
+print("Stripe configured?", bool(os.getenv("STRIPE_SECRET_KEY")))
+print(ds.hash("SHA256", "hello"))
+```
+
+If you keep configuration in a nonstandard file or need to reload it after import, use `ds.load_env("config/dev.env")`. Use `ds.load_env(".env", override=True)` only when you intentionally want the file to replace process variables.
+
+To turn import-time loading **off**, set `DANIEL_SOURCES_AUTO_DOTENV=0` *before importing* the library (e.g. in your Windows terminal: `$env:DANIEL_SOURCES_AUTO_DOTENV="0"`). No network access or payment occurs on import. **Never commit real secrets to GitHub.**
+
+## Use `pip install daniel_sources` from anywhere
+
+The exact command `pip install daniel_sources` works **only after** the package name has been claimed and this distribution has been uploaded to the public Python Package Index (PyPI), or an equivalent configured private index. This ZIP is **not yet published**. The included wheel and source distribution are ready to publish.
+
+To publish on PyPI yourself:
+
+1. Create a PyPI account at https://pypi.org/ and configure authentication (use a protected PyPI token or trusted publishing).
+2. Review the module, license/ownership and documentation: publishing makes the **source public**.
+3. From this folder, install packaging tools and build (the prebuilt archives in `dist/` can be used instead):
+
+   ```powershell
+   python -m pip install --upgrade build twine
+   python -m build
+   python -m twine check dist/*
+   python -m twine upload dist/*
+   ```
+
+4. Once your package is live on PyPI, in any new project / virtualenv:
+
+   ```powershell
+   python -m pip install daniel_sources
+   ```
+
+After every source update, increment the version in `pyproject.toml` and `__version__` before publishing again, then users can upgrade with `python -m pip install --upgrade daniel_sources`.
+
+If the name is already reserved when you publish, choose a distinct PyPI distribution name (e.g., `daniel-sources-kleequiz`); the *import* can still be `import daniel_sources as ds`.
+
+## Install/edit your local package while developing
+
+```powershell
+python -m pip install -e .
+python test_daniel_sources.py
+```
+
+Editable installs let you change `daniel_sources.py` and immediately use its changes in the same virtualenv. Publishing is not needed to develop locally.
+
+## Security and limits
+
+- Hashing with SHA256 is **not** password storage; use `ds.password_hash` and `ds.password_verify` for passwords.
+- Stripe helpers require real Stripe credentials and a server-side integration; webhook signatures must be verified before crediting purchases.
+- These helpers do not automatically handle web routes, model weights, Google OAuth, or live production deployment.
+- This distribution contains no real API tokens, private `.env` files, production database or user records.
+- Publishing the package publicly is your decision: inspect all code for any information you don't want publicly available and decide on your license before upload.
+
+Also see `FUNCTION_INDEX.md`, `SOURCES.md`, and `docs/ORIGINAL_LIBRARY_GUIDE.md`.

daniel_sources-1.2.0/README.md

@@ -0,0 +1,110 @@
+# daniel_sources — pip-installable Python utility library
+
+**Python 3.10 or newer** · **Version 1.2.0** · import as `import daniel_sources as ds`
+
+This is a reusable standalone module adapted from your KleeQuiz production + developer source code. It includes hashing/password helpers, JWTs, encryption, random codes, email, Stripe Checkout/webhook utilities, PDFs and DOCX, quizzes, SQLite API-key/credits helpers, and the Developer API client.
+
+## Install from the ZIP (works now, even before PyPI publishing)
+
+1. Extract the ZIP. Open a terminal in the extracted folder containing `pyproject.toml`.
+2. Install it in your active Python environment:
+
+```powershell
+python -m pip install .
+```
+
+**Windows virtual environment (no activation required):**
+
+```powershell
+py -m venv .venv
+.\.venv\Scripts\python.exe -m pip install .
+.\.venv\Scripts\python.exe -c "import daniel_sources as ds; print(ds.hash('SHA256', 'hello'))"
+```
+
+This automatically installs all eight declared third-party dependencies, *into the selected Python environment*: `cryptography`, `Werkzeug`, `PyJWT`, `requests`, `stripe`, `pypdf`, `python-docx`, and `python-dotenv`. Dependencies may require an internet connection if pip hasn't cached them. You do **not** need to install a separate requirements file.
+
+**If you have the wheel instead** (from the included `dist` folder):
+
+```powershell
+python -m pip install .\dist\daniel_sources-1.2.0-py3-none-any.whl
+```
+
+## Code examples
+
+```python
+import daniel_sources as ds
+
+print(ds.hash("SHA256", "hello"))
+code = ds.generate_code()
+key = ds.generate_encryption_key()
+print(ds.decrypt(ds.encrypt("hello", key), key))
+```
+
+## Virtual environments and `.env` files
+
+Make a `.env` file beside your project (not inside the installed library):
+
+```dotenv
+STRIPE_SECRET_KEY=sk_test_your_own_key_here
+STRIPE_WEBHOOK_SECRET=whsec_your_own_signing_secret_here
+```
+
+`import daniel_sources` automatically loads the `.env` file in your **current working directory**, without overwriting existing environment variables. It does not look inside other projects or search parent folders. This is separate from the Python virtual environment `.venv` folder.
+
+```python
+import os
+import daniel_sources as ds  # loads .env in your project folder, if present
+
+print("Stripe configured?", bool(os.getenv("STRIPE_SECRET_KEY")))
+print(ds.hash("SHA256", "hello"))
+```
+
+If you keep configuration in a nonstandard file or need to reload it after import, use `ds.load_env("config/dev.env")`. Use `ds.load_env(".env", override=True)` only when you intentionally want the file to replace process variables.
+
+To turn import-time loading **off**, set `DANIEL_SOURCES_AUTO_DOTENV=0` *before importing* the library (e.g. in your Windows terminal: `$env:DANIEL_SOURCES_AUTO_DOTENV="0"`). No network access or payment occurs on import. **Never commit real secrets to GitHub.**
+
+## Use `pip install daniel_sources` from anywhere
+
+The exact command `pip install daniel_sources` works **only after** the package name has been claimed and this distribution has been uploaded to the public Python Package Index (PyPI), or an equivalent configured private index. This ZIP is **not yet published**. The included wheel and source distribution are ready to publish.
+
+To publish on PyPI yourself:
+
+1. Create a PyPI account at https://pypi.org/ and configure authentication (use a protected PyPI token or trusted publishing).
+2. Review the module, license/ownership and documentation: publishing makes the **source public**.
+3. From this folder, install packaging tools and build (the prebuilt archives in `dist/` can be used instead):
+
+   ```powershell
+   python -m pip install --upgrade build twine
+   python -m build
+   python -m twine check dist/*
+   python -m twine upload dist/*
+   ```
+
+4. Once your package is live on PyPI, in any new project / virtualenv:
+
+   ```powershell
+   python -m pip install daniel_sources
+   ```
+
+After every source update, increment the version in `pyproject.toml` and `__version__` before publishing again, then users can upgrade with `python -m pip install --upgrade daniel_sources`.
+
+If the name is already reserved when you publish, choose a distinct PyPI distribution name (e.g., `daniel-sources-kleequiz`); the *import* can still be `import daniel_sources as ds`.
+
+## Install/edit your local package while developing
+
+```powershell
+python -m pip install -e .
+python test_daniel_sources.py
+```
+
+Editable installs let you change `daniel_sources.py` and immediately use its changes in the same virtualenv. Publishing is not needed to develop locally.
+
+## Security and limits
+
+- Hashing with SHA256 is **not** password storage; use `ds.password_hash` and `ds.password_verify` for passwords.
+- Stripe helpers require real Stripe credentials and a server-side integration; webhook signatures must be verified before crediting purchases.
+- These helpers do not automatically handle web routes, model weights, Google OAuth, or live production deployment.
+- This distribution contains no real API tokens, private `.env` files, production database or user records.
+- Publishing the package publicly is your decision: inspect all code for any information you don't want publicly available and decide on your license before upload.
+
+Also see `FUNCTION_INDEX.md`, `SOURCES.md`, and `docs/ORIGINAL_LIBRARY_GUIDE.md`.

daniel_sources-1.2.0/SOURCES.md

@@ -0,0 +1,34 @@
+# Source map: where each reusable function originated
+
+This library was built from **the supplied user-owned ZIP**, containing these original snapshots:
+
+- `KleeQuiz_Production_v15_Developer_API_FLAT.zip`
+- `KleeQuiz_Developers_v3_Beta_FLAT.zip`
+
+The original source was inspected. Some functions were moved nearly as-is, while others had Flask/FastAPI application state removed and parameters added so they can run in unrelated projects. The public library is not a byte-for-byte copy of all source files.
+
+| New API | Original code / inspiration | Port notes |
+|---|---|---|
+| `APIStore`, `KeyRecord`, `hash_key`, `safe_prefix`, `utc_now`, `utc_iso` | Developers `api_store.py` | Ported full local SQLite API-key, credit ledger, usage, and session store; connection context management improved. |
+| `hash`, `hash_api_key`, `create_api_key` | Developers `api_store.py` and Production `app.py` hash operations | Generic SHA family API with named algorithm, full token generator. |
+| `generate_code`, `hash_code`, `verify_code` | Production `app.py`: `generate_code`, `hash_code` | Flask SECRET_KEY changed to explicit `secret=` or environment variable; separate verification helper. |
+| `password_hash`, `password_verify` | Production `app.py`: `werkzeug.security.generate_password_hash/check_password_hash` | Thin lazy-import compatibility wrappers. |
+| `normalize_phone`, `normalize_promo_code`, `slugify`, `generate_invite_code`, `browser_label` | Production `app.py`: phone, promo and educator naming helpers, browser labeling | Removed DB/request dependencies. |
+| `safe_filename`, `allowed_file`, `extract_document`, `split_chunks`, `image_data_url` | Production `app.py`: upload, PDF/DOCX, source extraction | Made file paths explicit; optional dependencies lazy-loaded. |
+| `question_id`, `question_key`, `validate_question`, `build_question_type_plan`, `question_type_prompt` | Production `app.py`: IDs, validation, weighted format allocator, question prompts | Retains original quiz field conventions; type selection and validation available without the website. |
+| `parse_question_types`, `balanced_plan` | Developers `app.py`: `_parse_types`, `_balanced_plan` | Uses normal `ValueError` instead of HTTPException. |
+| `build_quiz_package`, `read_quiz_package_bytes`, `reference_text_from_package`, `quiz_required_plan_from_questions` | Production `app.py`: proprietary encrypted KleeQuiz Quiz V1 export/import | Explicit key required; compatible header/format/legacy key derivation. No DB attachment required. |
+| `send_email` | Production `app.py`: `send_email_message` | Configurable SMTP inputs or environment values, no global Flask dependency. |
+| `credits_to_cents`, `create_credits_checkout`, `paid_credits_from_webhook` | Developers `app.py`: `_money_for_credits`, `portal_recharge`, `stripe_webhook` | Extracted checkout and already-verified event metadata checks; database fulfillment remains caller's job. |
+| `create_stripe_checkout`, `verify_stripe_webhook` | Production/Developers `app.py`: Stripe Checkout Session + `stripe.Webhook.construct_event` | Generalized self-contained checkout, with server-side API key and signed webhooks. |
+| `generate_quiz_via_api` | Production `kleequiz_ai_api_client.py` | API endpoint, multipart upload, timeouts, and text-only response validation maintained. |
+| `configure_rotating_logger` | Production `app.py`: `configure_file_logging` | Logs to a named logger rather than resetting every process-wide logger. |
+| `RateLimiter` | Developers `app.py`: `_enforce_rate_limit` | Reusable instance-based thread-safe limiter. |
+| `encrypt/decrypt`, `generate_encryption_key`, `derive_fernet_key` | Production `app.py`: `quiz_file_fernet` and `cryptography.fernet` usage | General encryption helpers; no keys automatically stored. |
+| `jwt_create/jwt_read`, `api_request`, `save_json/load_json`, `getenv_bool` | Existing imports/configuration practices plus general adaptations | Additional reusable glue utilities. |
+
+## Why the original web routes are not in this module
+
+The login endpoints, Flask database models, educator membership subscriptions, local concept-miner implementation, and many other site routes cannot be lifted as independent `def` functions: they depend on `app`, database sessions, template directories, external infrastructure and sometimes production configuration. Importing a production `app.py` would itself initialize the server, database, and logging, violating the goal of a reusable helper module.
+
+This module deliberately offers the **portable underlying operations**, rather than promising that calling one function reproduces the entire KleeQuiz website infrastructure. To use the local AI generator rather than its HTTP API, keep the separate original runtime/pipeline files in a project configured for them.

daniel_sources-1.2.0/daniel_sources.egg-info/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: daniel_sources
+Version: 1.2.0
+Summary: Reusable Python utilities for hashing, encryption, Stripe Checkout, documents, and quiz projects
+Author: Daniel
+Keywords: utilities,hashing,stripe,quizzes,pdf,environment
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=42.0
+Requires-Dist: Werkzeug>=3.0
+Requires-Dist: PyJWT>=2.9
+Requires-Dist: requests>=2.31
+Requires-Dist: stripe>=12.0
+Requires-Dist: pypdf>=5.0
+Requires-Dist: python-docx>=1.1
+Requires-Dist: python-dotenv>=1.0
+
+# daniel_sources — pip-installable Python utility library
+
+**Python 3.10 or newer** · **Version 1.2.0** · import as `import daniel_sources as ds`
+
+This is a reusable standalone module adapted from your KleeQuiz production + developer source code. It includes hashing/password helpers, JWTs, encryption, random codes, email, Stripe Checkout/webhook utilities, PDFs and DOCX, quizzes, SQLite API-key/credits helpers, and the Developer API client.
+
+## Install from the ZIP (works now, even before PyPI publishing)
+
+1. Extract the ZIP. Open a terminal in the extracted folder containing `pyproject.toml`.
+2. Install it in your active Python environment:
+
+```powershell
+python -m pip install .
+```
+
+**Windows virtual environment (no activation required):**
+
+```powershell
+py -m venv .venv
+.\.venv\Scripts\python.exe -m pip install .
+.\.venv\Scripts\python.exe -c "import daniel_sources as ds; print(ds.hash('SHA256', 'hello'))"
+```
+
+This automatically installs all eight declared third-party dependencies, *into the selected Python environment*: `cryptography`, `Werkzeug`, `PyJWT`, `requests`, `stripe`, `pypdf`, `python-docx`, and `python-dotenv`. Dependencies may require an internet connection if pip hasn't cached them. You do **not** need to install a separate requirements file.
+
+**If you have the wheel instead** (from the included `dist` folder):
+
+```powershell
+python -m pip install .\dist\daniel_sources-1.2.0-py3-none-any.whl
+```
+
+## Code examples
+
+```python
+import daniel_sources as ds
+
+print(ds.hash("SHA256", "hello"))
+code = ds.generate_code()
+key = ds.generate_encryption_key()
+print(ds.decrypt(ds.encrypt("hello", key), key))
+```
+
+## Virtual environments and `.env` files
+
+Make a `.env` file beside your project (not inside the installed library):
+
+```dotenv
+STRIPE_SECRET_KEY=sk_test_your_own_key_here
+STRIPE_WEBHOOK_SECRET=whsec_your_own_signing_secret_here
+```
+
+`import daniel_sources` automatically loads the `.env` file in your **current working directory**, without overwriting existing environment variables. It does not look inside other projects or search parent folders. This is separate from the Python virtual environment `.venv` folder.
+
+```python
+import os
+import daniel_sources as ds  # loads .env in your project folder, if present
+
+print("Stripe configured?", bool(os.getenv("STRIPE_SECRET_KEY")))
+print(ds.hash("SHA256", "hello"))
+```
+
+If you keep configuration in a nonstandard file or need to reload it after import, use `ds.load_env("config/dev.env")`. Use `ds.load_env(".env", override=True)` only when you intentionally want the file to replace process variables.
+
+To turn import-time loading **off**, set `DANIEL_SOURCES_AUTO_DOTENV=0` *before importing* the library (e.g. in your Windows terminal: `$env:DANIEL_SOURCES_AUTO_DOTENV="0"`). No network access or payment occurs on import. **Never commit real secrets to GitHub.**
+
+## Use `pip install daniel_sources` from anywhere
+
+The exact command `pip install daniel_sources` works **only after** the package name has been claimed and this distribution has been uploaded to the public Python Package Index (PyPI), or an equivalent configured private index. This ZIP is **not yet published**. The included wheel and source distribution are ready to publish.
+
+To publish on PyPI yourself:
+
+1. Create a PyPI account at https://pypi.org/ and configure authentication (use a protected PyPI token or trusted publishing).
+2. Review the module, license/ownership and documentation: publishing makes the **source public**.
+3. From this folder, install packaging tools and build (the prebuilt archives in `dist/` can be used instead):
+
+   ```powershell
+   python -m pip install --upgrade build twine
+   python -m build
+   python -m twine check dist/*
+   python -m twine upload dist/*
+   ```
+
+4. Once your package is live on PyPI, in any new project / virtualenv:
+
+   ```powershell
+   python -m pip install daniel_sources
+   ```
+
+After every source update, increment the version in `pyproject.toml` and `__version__` before publishing again, then users can upgrade with `python -m pip install --upgrade daniel_sources`.
+
+If the name is already reserved when you publish, choose a distinct PyPI distribution name (e.g., `daniel-sources-kleequiz`); the *import* can still be `import daniel_sources as ds`.
+
+## Install/edit your local package while developing
+
+```powershell
+python -m pip install -e .
+python test_daniel_sources.py
+```
+
+Editable installs let you change `daniel_sources.py` and immediately use its changes in the same virtualenv. Publishing is not needed to develop locally.
+
+## Security and limits
+
+- Hashing with SHA256 is **not** password storage; use `ds.password_hash` and `ds.password_verify` for passwords.
+- Stripe helpers require real Stripe credentials and a server-side integration; webhook signatures must be verified before crediting purchases.
+- These helpers do not automatically handle web routes, model weights, Google OAuth, or live production deployment.
+- This distribution contains no real API tokens, private `.env` files, production database or user records.
+- Publishing the package publicly is your decision: inspect all code for any information you don't want publicly available and decide on your license before upload.
+
+Also see `FUNCTION_INDEX.md`, `SOURCES.md`, and `docs/ORIGINAL_LIBRARY_GUIDE.md`.

daniel_sources-1.2.0/daniel_sources.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+.env.example
+FUNCTION_INDEX.md
+INSTALL_WINDOWS.txt
+MANIFEST.in
+README.md
+SOURCES.md
+daniel_sources.py
+example_project.py
+pyproject.toml
+requirements.txt
+test_daniel_sources.py
+daniel_sources.egg-info/PKG-INFO
+daniel_sources.egg-info/SOURCES.txt
+daniel_sources.egg-info/dependency_links.txt
+daniel_sources.egg-info/requires.txt
+daniel_sources.egg-info/top_level.txt
+docs/ORIGINAL_LIBRARY_GUIDE.md

daniel_sources-1.2.0/daniel_sources.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

daniel_sources-1.2.0/daniel_sources.egg-info/requires.txt

@@ -0,0 +1,8 @@
+cryptography>=42.0
+Werkzeug>=3.0
+PyJWT>=2.9
+requests>=2.31
+stripe>=12.0
+pypdf>=5.0
+python-docx>=1.1
+python-dotenv>=1.0

daniel_sources-1.2.0/daniel_sources.egg-info/top_level.txt

@@ -0,0 +1 @@
+daniel_sources