splashstand 3.0.10__tar.gz

splashstand-3.0.10/.claude/settings.local.json

@@ -0,0 +1,39 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__session-mgmt__checkpoint",
+      "Bash(uv tree:*)",
+      "Bash(time uv build:*)",
+      "Bash(timeout 30 uv build:*)",
+      "Bash(uv check:*)",
+      "Bash(uv build:*)",
+      "Bash(timeout 60 uv build:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "session-mgmt",
+    "crackerjack",
+    "jetbrains",
+    "macos_automator",
+    "penpot",
+    "peekaboo",
+    "playwright",
+    "git",
+    "github",
+    "gitlab",
+    "memory",
+    "sequential-thinking",
+    "filesystem",
+    "mermaid",
+    "qwen-code",
+    "gemini-cli",
+    "context7",
+    "excalidraw",
+    "upstash",
+    "cloud-run",
+    "sentry",
+    "logfire",
+    "turso-cloud"
+  ]
+}

splashstand-3.0.10/.envrc

@@ -0,0 +1 @@
+layout uv

splashstand-3.0.10/.gitignore

@@ -0,0 +1,18 @@
+# Created by .ignore support plugin (hsz.mobi)
+/.idea
+/.pdm-python
+/.pdm.toml
+/build/
+/__pypackages__/
+/dist/
+/.mypy_cache/
+/.ruff_cache/
+/.pdm-build/
+/tmp/
+/__pycache__/
+/*.pyc
+/.crackerjack.yaml
+/scratch/
+/old_projects/
+/projects/
+/.mcp.json

splashstand-3.0.10/.pre-commit-config.yaml

@@ -0,0 +1,109 @@
+repos:
+  - repo: local
+    hooks:
+      - id: validate-regex-patterns
+        name: validate-regex-patterns
+        entry: uv run python -m crackerjack.tools.validate_regex_patterns
+        language: system
+        files: \.py$
+        exclude: ^\.venv/|^src/
+      - id: skylos
+        name: skylos-dead-code-detection
+        entry: skylos
+        language: system
+        args: ["splashstand", "--exclude", "tests"]
+        pass_filenames: false
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]
+      - id: zuban
+        name: zuban-type-checking
+        entry: uv run zuban check
+        language: system
+        args: ["--config-file", "mypy.ini", "./splashstand"]
+        pass_filenames: false
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]
+      - id: pyright
+        name: pyright-type-checking
+        entry: uv run pyright
+        language: system
+        files: ^splashstand/.*\.py$
+        exclude: ^crackerjack/(mcp|plugins)/.*\.py$|crackerjack/code_cleaner\.py$|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+        name: trailing-whitespace
+        exclude: ^\.venv/|^src/
+      - id: end-of-file-fixer
+        name: end-of-file-fixer
+        exclude: ^\.venv/|^src/
+      - id: check-yaml
+        name: check-yaml
+        exclude: ^\.venv/|^src/
+      - id: check-toml
+        name: check-toml
+        exclude: ^\.venv/|^src/
+      - id: check-added-large-files
+        name: check-added-large-files
+        exclude: ^\.venv/|^src/
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.8.15
+    hooks:
+      - id: uv-lock
+        files: ^ pyproject\.toml$
+        exclude: ^src/
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.28.0
+    hooks:
+      - id: gitleaks
+        exclude: uv\.lock|pyproject\.toml|tests/.*|docs/.*|.*\.md|^src/
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.6
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml", "-r", "-ll"]
+        files: ^splashstand/.*\.py$
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
+        exclude: ^\.venv/|^src/
+        additional_dependencies: ["tomli"]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.12
+    hooks:
+      - id: ruff-check
+        exclude: ^\.venv/|^src/
+      - id: ruff-format
+        exclude: ^\.venv/|^src/
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.22
+    hooks:
+      - id: mdformat
+        exclude: ^\.venv/|^src/
+        additional_dependencies: ["mdformat-ruff"]
+  - repo: https://github.com/fredrikaverpil/creosote
+    rev: v4.1.0
+    hooks:
+      - id: creosote
+        exclude: ^\.venv/|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/rohaquinlop/complexipy-pre-commit
+    rev: v3.3.0
+    hooks:
+      - id: complexipy
+        args: ["-d", "low", "--max-complexity-allowed", "15"]
+        files: ^splashstand/.*\.py$
+        exclude: ^(\.venv/|tests/)|^src/
+        stages: ["pre-push", "manual"]
+  - repo: https://github.com/dosisod/refurb
+    rev: v2.1.0
+    hooks:
+      - id: refurb
+        files: ^splashstand/.*\.py$
+        exclude: ^tests/|^src/
+        stages: ["pre-push", "manual"]

splashstand-3.0.10/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.0.9] - 2025-09-21
+
+### Documentation
+
+- config: Update CHANGELOG, pyproject, uv
+
+## [3.0.8] - 2025-09-21
+
+### Internal
+
+- config: Update pyproject

splashstand-3.0.10/CLAUDE.md

@@ -0,0 +1,100 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+SplashStand is a Python 3.13+ web application framework built on top of FastBlocks and ACB (Asynchronous Component Base). It provides "simple, safe, serverless, schema" development with a focus on modern web development patterns including HTMX, Jinja templating, and cloud-native deployment.
+
+## Development Commands
+
+### Essential Commands
+- **Development server**: `uv run fastblocks dev` (from CLI integration)
+- **Production server**: `uv run fastblocks run` (from CLI integration)
+- **Install dependencies**: `uv sync`
+- **Run tests**: `uv run pytest`
+- **Type checking**: `uv run pyright` or `uv run zuban check --config-file mypy.ini ./splashstand`
+- **Linting**: `uv run ruff check` and `uv run ruff format`
+- **Security scan**: `uv run bandit -c pyproject.toml -r -ll splashstand/`
+- **Dead code detection**: `skylos splashstand --exclude tests`
+- **Dependency validation**: `uv run creosote`
+
+### Pre-commit Hooks
+The project uses comprehensive pre-commit hooks. Key stages:
+- **pre-push/manual**: Type checking (pyright, zuban), security (bandit), complexity analysis (complexipy), dead code detection (skylos), refactoring suggestions (refurb)
+- **standard**: Formatting (ruff), linting, spell checking (codespell), YAML/TOML validation
+
+### Custom CLI Commands
+SplashStand provides additional CLI commands via `splashstand/cli.py`:
+- `get_revisions` - List Cloud Run service revisions
+- `clean_revisions` - Clean up old revisions
+- `clean_builds` - Clean up build artifacts
+- `reset` - Reset application state
+- `create` - Create new deployment
+- `add_custom_domain` - Configure custom domain
+- `build_revision` - Build and deploy revision
+
+## Architecture Overview
+
+### Core Structure
+- **`splashstand/main.py`**: Application entry point using FastBlocks framework
+- **`splashstand/cli.py`**: Extended CLI commands for deployment and management
+- **`splashstand/adapters/`**: Modular adapter system for different services:
+  - `admin/` - Administrative interfaces
+  - `analytics/` - Google Analytics integration
+  - `app/` - Core application logic
+  - `auth/` - Firebase authentication
+  - `captcha/` - reCAPTCHA integration
+  - `mail/`, `messaging/`, `marketing/`, `social/` - Communication services
+  - `pwa/` - Progressive Web App features
+  - `schemas/` - Data validation schemas
+
+### Framework Dependencies
+- **FastBlocks**: Primary web framework providing admin, monitoring, and sitemap features
+- **ACB**: Asynchronous Component Base providing cache, DNS, monitoring, requests, secrets, SMTP, SQL, and storage adapters
+- **Core Libraries**: Starlette, HTMX, Jinja2, SQLModel, Pydantic, httpx
+
+### Configuration Management
+- Uses `acb.depends.depends` for dependency injection and configuration
+- Application configuration loaded via `depends.get()` pattern
+- Logging configured through ACB framework
+
+### Optional Features
+- **Analytics**: Google Analytics Admin and Data APIs (`analytics` extra)
+- **Captcha**: Google reCAPTCHA Enterprise (`captcha` extra)
+- **Auth**: Firebase Admin SDK (`auth` extra)
+
+## Development Environment
+
+### Package Management
+- Uses `uv` for dependency management and virtual environment handling
+- Lock file: `uv.lock`
+- Development dependencies in `dependency-groups.dev`
+
+### Quality Assurance
+- **Type Checking**: Strict mode with pyright and mypy (zuban)
+- **Code Quality**: Ruff for linting/formatting, refurb for refactoring suggestions
+- **Security**: Bandit for security analysis, gitleaks for secrets detection
+- **Complexity**: Maximum complexity of 15 (complexipy)
+- **Coverage**: pytest with coverage reporting
+
+### Project Structure Patterns
+- Adapter pattern for external service integrations
+- CLI extension pattern for operational commands
+- Configuration-driven dependency injection
+- Async-first architecture throughout
+
+## Testing
+
+- Test files follow pytest conventions: `test_*.py` or `*_test.py`
+- Tests located in individual project directories under `projects/`
+- Coverage configuration excludes test files and focuses on `splashstand/` source
+- Async test support enabled with `asyncio_mode = "auto"`
+
+## Deployment
+
+SplashStand is designed for serverless deployment, particularly Google Cloud Run, with built-in commands for:
+- Revision management and cleanup
+- Custom domain configuration
+- Build and deployment automation
+- Application state management

splashstand-3.0.10/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2023, Les Leslie and Wedgwood Web Works
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

splashstand-3.0.10/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: splashstand
+Version: 3.0.10
+Project-URL: Homepage, https://gitlab.com/lesleslie/splashstand
+Project-URL: Documentation, https://gitlab.com/lesleslie/splashstand
+Project-URL: Repository, https://gitlab.com/lesleslie/splashstand
+Author-email: lesleslie <les@wedgwoodwebworks.com>
+Maintainer-email: lesleslie <les@wedgwoodwebworks.com>
+License: BSD-3-Clause
+License-File: LICENSE
+Keywords: htmx,httpx,jinja,pydantic,sqladmin,sqlmodel,starlette
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: acb[cache,dns,monitoring,requests,secret,smtp,sql,storage]
+Requires-Dist: alive-progress>=3.2.0
+Requires-Dist: fastblocks[admin,monitoring,sitemap]
+Requires-Dist: jinja2-inflection>=0.4.0
+Requires-Dist: phonenumbers>=9.0.8
+Requires-Dist: pydantic[email]>=2.11.7
+Requires-Dist: uuid-utils>=0.11.0
+Requires-Dist: uv>=0.7.19
+Provides-Extra: analytics
+Requires-Dist: google-analytics-admin>=0.24.1; extra == 'analytics'
+Requires-Dist: google-analytics-data>=0.18.19; extra == 'analytics'
+Provides-Extra: auth
+Requires-Dist: firebase-admin>=6.9.0; extra == 'auth'
+Provides-Extra: captcha
+Requires-Dist: google-cloud-recaptcha-enterprise>=1.28.2; extra == 'captcha'

splashstand-3.0.10/QWEN.md

@@ -0,0 +1,137 @@
+# SplashStand Project Context
+
+## Project Overview
+
+SplashStand is a mobile-first modular micro-CMS (Content Management System) built with Python. The project uses a modern tech stack including Flask, SQLAlchemy, Redis, and various Google Cloud services. It's designed to be simple, safe, serverless, and schema-based.
+
+The project appears to have evolved over time, with both older Flask-based components (in the `whiskey` directory) and newer components using modern Python frameworks like Starlette, HTMX, Jinja, HTTPX, SQLAdmin, SQLModel, and Pydantic.
+
+## Key Technologies
+
+- **Core Framework**: Python 3.13+
+- **Web Framework**: Flask (legacy) and FastBlocks (modern)
+- **Database**: SQLAlchemy with SQLModel
+- **Frontend**: HTMX, Jinja2 templates
+- **Authentication**: Firebase Admin, Flask-Security
+- **Caching**: Redis
+- **Cloud Services**: Google Cloud Platform (Cloud Run, Cloud SQL, Cloud Storage)
+- **Deployment**: Docker, Google Cloud Build
+- **Package Management**: uv, PDM
+- **Code Quality**: Black, Ruff, Pyright, Crackerjack
+
+## Project Structure
+
+```
+splashstand/
+├── splashstand/           # Main source code
+│   ├── whiskey/          # Legacy Flask-based CMS
+│   ├── adapters/         # Component adapters (admin, analytics, app, auth, etc.)
+│   ├── actions/          # Business logic actions
+│   ├── bin/              # Command-line utilities
+│   ├── functions/        # Cloud functions
+│   ├── public/           # Static files
+│   └── cli.py           # Command-line interface
+├── tests/                # Test files
+├── docs/                 # Documentation
+└── ...
+```
+
+## Building and Running
+
+### Development Setup
+
+1. Install dependencies with `uv`:
+
+   ```bash
+   uv sync
+   ```
+
+1. Run the development server:
+
+   ```bash
+   python -m splashstand
+   ```
+
+### CLI Commands
+
+The project provides a CLI with several useful commands:
+
+- `startproject` - Create a new project
+- `upgradeproject` - Upgrade an existing project
+- `checkversions` - Check dependency versions
+
+Additional commands are available through the `cli.py` module:
+
+- `deploy` - Build and deploy the application
+- `create` - Create a new application
+- `reset` - Reset debug settings
+- `add_custom_domain` - Add a custom domain to Cloud Run
+
+### Deployment
+
+Deployment is handled through Google Cloud Run:
+
+1. Build the Docker image
+1. Deploy to Cloud Run with appropriate settings
+1. Configure domain mappings
+1. Set up Cloud Scheduler for keep-warm tasks
+
+## Development Conventions
+
+### Code Style
+
+The project follows strict code quality standards:
+
+- Formatting with Black
+- Linting with Ruff
+- Type checking with Pyright
+- Code style enforcement with Crackerjack
+
+### Testing
+
+Tests are written using pytest with the following configuration:
+
+- Async support with pytest-asyncio
+- Coverage reporting
+- Benchmark testing capabilities
+
+### Package Management
+
+The project uses uv for fast package management and PDM for project metadata management. Dependencies are specified in `pyproject.toml`.
+
+### Configuration
+
+Configuration is managed through YAML files and environment variables. The project uses a component-based architecture with adapters for different services.
+
+## Key Components
+
+1. **Whiskey** - Legacy Flask-based CMS implementation
+1. **FastBlocks** - Modern web framework based on Starlette
+1. **ACB** - Adapter Component Bus for dependency injection
+1. **Adapters** - Pluggable components for various services (mail, auth, analytics, etc.)
+
+## Important Files
+
+- `pyproject.toml` - Project metadata and dependencies
+- `splashstand/cli.py` - Main CLI interface
+- `splashstand/main.py` - Application entry point
+- `splashstand/whiskey/main.py` - Legacy Flask application
+- `splashstand/bin/startproject.py` - Project creation utility
+
+## Development Workflow
+
+1. Create a new project using `startproject`
+1. Configure settings in YAML files
+1. Develop features using the component adapter pattern
+1. Test with pytest
+1. Deploy using the built-in deployment commands
+
+## Version Information
+
+The project has multiple version indicators:
+
+- `VERSION` file: 1.1.0
+- `splashstand/whiskey/_version.py`: 1.2.1
+- `pyproject.toml`: 3.0.6
+
+This suggests the project is in active development with different components at different version levels.

splashstand-3.0.10/README.md

@@ -0,0 +1,6 @@
+# SplashStand
+
+[![Code style: crackerjack](https://img.shields.io/badge/code%20style-crackerjack-000042)](https://github.com/lesleslie/crackerjack)
+[![Python: 3.13+](https://img.shields.io/badge/python-3.13%2B-green)](https://www.python.org/downloads/)
+
+SplashStand - simple. safe. serverless. schema.

splashstand-3.0.10/mypy.ini

@@ -0,0 +1,9 @@
+[mypy]
+python_version = 3.13
+strict = true
+ignore_missing_imports = true
+show_error_codes = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+exclude = tests/.*|test_.*\.py|.*_test\.py