skrift 0.1.0a1__py3-none-any.whl

skrift/templates/setup/site.html

@@ -0,0 +1,39 @@
+{% extends "setup/base.html" %}
+
+{% block title %}Site Settings - Skrift{% endblock %}
+
+{% block content %}
+<h2>Site Settings</h2>
+<p class="description">Configure your site's basic information.</p>
+
+<form method="post" action="/setup/site">
+    <div class="form-group">
+        <label for="site_name">Site Name *</label>
+        <input type="text" id="site_name" name="site_name" value="{{ settings.site_name }}" required>
+        <small>The name displayed in the header and browser title</small>
+    </div>
+
+    <div class="form-group">
+        <label for="site_tagline">Site Tagline</label>
+        <input type="text" id="site_tagline" name="site_tagline" value="{{ settings.site_tagline }}">
+        <small>A short description or slogan for your site</small>
+    </div>
+
+    <div class="form-group">
+        <label for="site_copyright_holder">Copyright Holder</label>
+        <input type="text" id="site_copyright_holder" name="site_copyright_holder" value="{{ settings.site_copyright_holder }}">
+        <small>Name displayed in the copyright notice (defaults to site name if empty)</small>
+    </div>
+
+    <div class="form-group">
+        <label for="site_copyright_start_year">Copyright Start Year</label>
+        <input type="number" id="site_copyright_start_year" name="site_copyright_start_year" value="{{ settings.site_copyright_start_year }}" min="1900" max="2100">
+        <small>If different from current year, will show a range (e.g., 2020-2026)</small>
+    </div>
+
+    <div class="form-actions">
+        <a href="/setup/auth" class="btn-secondary" role="button">Back</a>
+        <button type="submit">Save &amp; Continue</button>
+    </div>
+</form>
+{% endblock %}

skrift-0.1.0a1.dist-info/METADATA

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: skrift
+Version: 0.1.0a1
+Summary: A lightweight async Python CMS for crafting modern websites
+Requires-Python: >=3.13
+Requires-Dist: advanced-alchemy>=0.26.0
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: alembic>=1.14.0
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: litestar[cryptography,jinja,standard]>=2.14.0
+Requires-Dist: pydantic-settings>=2.7.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: ruamel-yaml>=0.18.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.36
+Requires-Dist: uvicorn>=0.34.0
+Description-Content-Type: text/markdown
+
+# Skrift
+
+A modern Litestar-powered content management framework with multi-provider OAuth authentication, role-based access control, and WordPress-like template resolution.
+
+## Features
+
+- **Multi-Provider OAuth**: Authenticate with Google, GitHub, Microsoft, Discord, Facebook, or Twitter/X
+- **Role-Based Access Control**: Flexible permission system with Admin, Editor, Author, and Moderator roles
+- **Setup Wizard**: Guided first-time configuration without manual file editing
+- **Admin Interface**: Web-based management for users, pages, and site settings
+- **WordPress-like Templates**: Hierarchical template resolution for content pages
+- **Dynamic Controllers**: Load controllers from `app.yaml` configuration
+- **SQLAlchemy Integration**: Async database support with SQLite/PostgreSQL
+- **Client-Side Sessions**: Encrypted cookie sessions for horizontal scalability
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.13+
+
+### Installation
+
+```bash
+# Install Skrift
+pip install skrift
+
+# Or install from git
+pip install git+https://github.com/ZechCodes/skrift.git
+```
+
+### Getting Started
+
+Create a project directory and set up your environment:
+
+```bash
+mkdir mysite && cd mysite
+
+# Create minimal environment file
+echo "SECRET_KEY=$(python -c 'import secrets; print(secrets.token_urlsafe(32))')" > .env
+
+# Start Skrift
+skrift
+```
+
+Open http://localhost:8080 to launch the setup wizard.
+
+### Setup Wizard
+
+The setup wizard guides you through initial configuration:
+
+1. **Database Configuration**: Choose SQLite (dev) or PostgreSQL (production)
+2. **Authentication Providers**: Configure OAuth credentials
+3. **Site Settings**: Set site name, tagline, and copyright info
+4. **Admin Account**: Create your first admin user via OAuth login
+
+After completing the wizard, an `app.yaml` configuration file is created in your project directory.
+
+### Manual Configuration
+
+Alternatively, create `app.yaml` manually:
+
+```yaml
+controllers:
+  - skrift.controllers.auth:AuthController
+  - skrift.admin.controller:AdminController
+  - skrift.controllers.web:WebController
+
+db:
+  url: sqlite+aiosqlite:///./app.db
+
+auth:
+  redirect_base_url: http://localhost:8080
+  providers:
+    google:
+      client_id: $GOOGLE_CLIENT_ID
+      client_secret: $GOOGLE_CLIENT_SECRET
+      scopes: [openid, email, profile]
+```
+
+Then run migrations and start the server:
+
+```bash
+skrift-db upgrade head
+skrift
+```
+
+## Documentation
+
+- **[Full Documentation](docs/README.md)**: Comprehensive guide covering all features
+- **[Deployment Guide](docs/deployment.md)**: VPS, Docker, and Kubernetes deployment
+- **[CSS Framework](docs/css-framework.md)**: Styling documentation
+
+## Project Structure
+
+```
+skrift/
+├── skrift/              # Main Python package
+│   ├── asgi.py          # Application factory
+│   ├── config.py        # Settings management
+│   ├── controllers/     # Route handlers
+│   ├── admin/           # Admin panel
+│   ├── auth/            # RBAC and guards
+│   ├── db/              # Models and services
+│   ├── lib/             # Template resolver
+│   └── setup/           # Setup wizard
+├── templates/           # Jinja2 templates
+├── static/              # Static assets
+├── alembic/             # Database migrations
+├── docs/                # Documentation
+├── app.yaml             # Application config (generated)
+└── main.py              # Development entry point
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SECRET_KEY` | Yes | Session encryption key |
+| `DEBUG` | No | Enable debug mode (default: false) |
+| `DATABASE_URL` | No | Database connection string |
+| `OAUTH_REDIRECT_BASE_URL` | No | OAuth callback base URL |
+
+OAuth credentials are configured per-provider (e.g., `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`).
+
+### app.yaml
+
+Application configuration is stored in `app.yaml` (generated by setup wizard):
+
+```yaml
+controllers:
+  - skrift.controllers.auth:AuthController
+  - skrift.admin.controller:AdminController
+  - skrift.controllers.web:WebController
+
+db:
+  url: $DATABASE_URL
+  pool_size: 5
+
+auth:
+  redirect_base_url: $OAUTH_REDIRECT_BASE_URL
+  providers:
+    google:
+      client_id: $GOOGLE_CLIENT_ID
+      client_secret: $GOOGLE_CLIENT_SECRET
+```
+
+Environment variables (prefixed with `$`) are interpolated at runtime.
+
+## Deployment
+
+### Minimal VPS Deployment
+
+```bash
+# Install Skrift
+pip install skrift
+
+# Create project directory
+mkdir -p /opt/skrift && cd /opt/skrift
+
+# Configure environment
+cat > .env << EOF
+SECRET_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")
+DATABASE_URL=sqlite+aiosqlite:///./app.db
+OAUTH_REDIRECT_BASE_URL=https://yourdomain.com
+EOF
+
+# Start server (use setup wizard or create app.yaml manually)
+skrift
+```
+
+### Production with Gunicorn
+
+```bash
+pip install gunicorn
+gunicorn skrift.asgi:app -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8080
+```
+
+See the [Deployment Guide](docs/deployment.md) for detailed instructions including Docker, Docker Compose, and Kubernetes deployments.
+
+## Database Migrations
+
+```bash
+# Apply migrations
+skrift-db upgrade head
+
+# Create new migration
+skrift-db revision --autogenerate -m "description"
+
+# Rollback
+skrift-db downgrade -1
+```
+
+## Template Resolution
+
+Templates follow WordPress-like hierarchical resolution:
+
+| URL Path | Templates Tried |
+|----------|-----------------|
+| `/about` | `page-about.html` -> `page.html` |
+| `/services/web` | `page-services-web.html` -> `page-services.html` -> `page.html` |
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+## License
+
+MIT

skrift-0.1.0a1.dist-info/RECORD

@@ -0,0 +1,68 @@
+skrift/__init__.py,sha256=eXE5PFVkJpH5XsV_ZlrTIeFPUPrmcHYAj4GpRS3R5PY,29
+skrift/__main__.py,sha256=Fs17xxkqTjZpJn9MMC6pzkW4sOzNhV5RGLsA2ONPFww,271
+skrift/alembic.ini,sha256=aq1sNDUgKvdON-N28lN9fncRcYtg430HE2DsuEMIDtk,1782
+skrift/asgi.py,sha256=62fWbHMwAqUBveboWK-bwmplREvXXBlBna8-0kAcKOI,18836
+skrift/cli.py,sha256=rrm0cSc2LhQ1FA5-ucDN1sDTwFwKnDk1DCYf746SYyo,1522
+skrift/config.py,sha256=fwB8oGKFmSkGEHqjM5Z9dJvcztjx8WSUqyCkvQXfIBo,5640
+skrift/admin/__init__.py,sha256=x81Cj_ilVmv6slaMl16HHyT_AgrnLxKEWkS0RPa4V9s,289
+skrift/admin/controller.py,sha256=5ZDypvKHXLNDESsKNsdsH2E3Si5OqlpzttFl7Ot8aF0,15651
+skrift/admin/navigation.py,sha256=VwttFoIUIJy5rONKIkJd5w4CNkUpeK22_OfLGHecN34,3382
+skrift/alembic/env.py,sha256=vYy8dBm7zW8F5izsQdVgQyJ6yGmRbqUfGoWgefD49vQ,2609
+skrift/alembic/script.py.mako,sha256=MEqL-2qATlST9TAOeYgscMn1uy6HUS9NFvDgl93dMj8,635
+skrift/alembic/versions/20260120_210154_09b0364dbb7b_initial_schema.py,sha256=X6w1vbVKFurhEcblTLGO4Nd_IKkMVtb8TsptV4gpAJ4,2750
+skrift/alembic/versions/20260122_152744_0b7c927d2591_add_roles_and_permissions.py,sha256=yCGjnMTpfSMHVYQCsPTD6wdDI8pJSUtGRESO6bz0KfU,2672
+skrift/alembic/versions/20260122_172836_cdf734a5b847_add_sa_orm_sentinel_column.py,sha256=96TCvvQbYk3RGpZdEQ0x4bIDXxBLc3Gv7VTItTq9T54,850
+skrift/alembic/versions/20260122_175637_a9c55348eae7_remove_page_type_column.py,sha256=XJ55LhwzgN07MAREk6w4Bx2Vu3KvMe_bDkIjgE6EfqM,1223
+skrift/alembic/versions/20260122_200000_add_settings_table.py,sha256=aG4pxp18fwonGAWt7EoT0XaiIEmu7zltSrj8e2a8QZU,1310
+skrift/auth/__init__.py,sha256=uHMqty3dgDSYlReVT96WhygzH6qNAWSVDWoxumzxmsA,1155
+skrift/auth/guards.py,sha256=QePajHsGnJ4R_hlhzblr5IoAgZcY5jzeZ64bJwDL9hM,4451
+skrift/auth/roles.py,sha256=jpqK4qaavqAhJRxhptm2x5mUb6KkwEALaml8sEH4Sug,2267
+skrift/auth/services.py,sha256=h6GTXdN5UMRYglnaFz4asMoutVkSSAyL3_Vt56N26pA,5441
+skrift/controllers/__init__.py,sha256=bVr0tsSGz7jBi002Lqd1AA1FQd7ZA_IagsqTKpiHiK0,147
+skrift/controllers/auth.py,sha256=fqn-E2YCiMKJU1lh2fzUwVdx9cHfrFiBIi-cdBkjwN0,13282
+skrift/controllers/web.py,sha256=vmoBS1u5G9gCBu65S49yqZn_WBKlmsqlcvX5tYXTKnE,2348
+skrift/db/__init__.py,sha256=uSghyDFT2K4SFiEqUzdjCGzWpS-Oy6Sd1FUappau-v0,52
+skrift/db/base.py,sha256=QJplFj9235kZdScASEpvyNHln6YW2hqbHwJEYZ3OSsc,173
+skrift/db/models/__init__.py,sha256=8ivPDjVMDZPvl06ZWBjp4YmSfC4qhbq76PDJ8MWqzv4,269
+skrift/db/models/page.py,sha256=CI5W2sWq0zbKHxfwH5TpmGdJ4zlTicckzpdZtaqjJVE,1019
+skrift/db/models/role.py,sha256=VkwkF3XWemmFtkUpQRk6RTIBfcukrU-0PUPCeo8x834,1768
+skrift/db/models/setting.py,sha256=Am4HTyq2LFR408R6BZb--slys1xM8YLYq9HTq_gybD0,392
+skrift/db/models/user.py,sha256=zqZ-sYcYa0StFsSGsPcovy7EpswFo_PtrObBJ8TyHiA,1310
+skrift/db/services/__init__.py,sha256=qAC24IPOYg6AampUWonmLeajljQRMwUw0lgXksQG6Nk,69
+skrift/db/services/page_service.py,sha256=cXJ-urV7LjUDoVsT1P52f6wcOsur3T-pvqKkGG4xlvI,5246
+skrift/db/services/setting_service.py,sha256=eqFxukn8QFrDHQbaBILOLjP1nr34JPIPFT_NnhmeaTY,5613
+skrift/lib/__init__.py,sha256=PL66bS4_-90zJDMsQSnzqkkxwkO_3aLcYl9l9cDrE2Y,65
+skrift/lib/exceptions.py,sha256=p8ceLIQCc7agCwW6-mhBDAuMAMxZDcf9TDLC6PfztU4,5803
+skrift/lib/template.py,sha256=4_urkRfvth75yNeQ5TyGTHvkvs3vVef7TcwZx0k285k,4226
+skrift/setup/__init__.py,sha256=3VjFPMES5y0M5cQ9R4C1xazqiEPEDqTPjX9-3rBMXnA,478
+skrift/setup/config_writer.py,sha256=FkAfS4xa_R0tmgdp2Ac-0QlVXte2xUo1TWpxWBGBkUA,6260
+skrift/setup/controller.py,sha256=HZs6Q2lNdvNh-JakmznMVL-1sj_6wD9axr3ESL1iIaA,29202
+skrift/setup/middleware.py,sha256=Nai8ZG2vHldngmAhq7kWzAwKRNcP5tHKhJHa5dCh404,2941
+skrift/setup/providers.py,sha256=XQQ7q_4axkTkspHyN66wn-zVaCzGZCf4BClEhNbEnWU,6171
+skrift/setup/state.py,sha256=JRFh6ZSbznLtTwyPBATR75heHdG4uuk8JcCFHawTrPI,3711
+skrift/static/css/style.css,sha256=4874DhxJD9oD81PjvJGwiQwdVjUDKWAZ2V8Gq62Igew,20755
+skrift/templates/base.html,sha256=4bg4s4VdES0dSvhJYLgrfrN26ynqeq1-3jyKPkWWVWk,2065
+skrift/templates/error-404.html,sha256=sJrDaF3Or3Nyki8mxo3wBxLLzgy4wkB9p9wdS8pRA6k,409
+skrift/templates/error-500.html,sha256=MR0wJ1JKLqdmdvsoJbQnZxLkxDPE59LrlbtVPKLM8-A,401
+skrift/templates/error.html,sha256=tg45Hj0wNc9QiZKBVVQ2WsqDiAkByXZnuehTdJPclXc,415
+skrift/templates/index.html,sha256=lzZlnoZ2luY__OtRVa61mpQIgcopAbkKa2rS9XRfRlI,172
+skrift/templates/page.html,sha256=kY1j7TH6dFnvWnYwBEGCIEvardjLhnFMnM3NbAnKszQ,759
+skrift/templates/admin/admin.html,sha256=8sErpGKedl7Hf_CMeu53bUEHptH1FqdBX9LT3z-1HcU,454
+skrift/templates/admin/base.html,sha256=JX1MPw9XTY8jCT2M6iHUwEj8NPNOdZPca2cDUEs9kfQ,659
+skrift/templates/admin/pages/edit.html,sha256=s-uZ4BYG7BdnWYTBSS1mr5aFL8XfT8h-KNiSIraWmHw,1322
+skrift/templates/admin/pages/list.html,sha256=LYh1vEwSHkyXihjcy5PIo33iA7UeIxprw4Gsn1WZMm4,2185
+skrift/templates/admin/settings/site.html,sha256=xHZCZGj9XqyLKCe2eoBlpI3oFIx5VoG_5FP-VAF2mz4,1516
+skrift/templates/admin/users/list.html,sha256=9GWql1la5Srm-OOgooHR9Eouk7ZL66K_FXY6HAAB5lA,1732
+skrift/templates/admin/users/roles.html,sha256=pos-ZM-gXYCN_D8DZpzwEBEm_WvmOKMMPz-3xJqs7nY,1473
+skrift/templates/auth/login.html,sha256=hafLcmmRgiLhFjTDzGvEla31JoKl6dfw7sLdzQyzGmA,6195
+skrift/templates/setup/admin.html,sha256=BSIztZT2iqxVSW23Tfg7ZM51SdGrKL422CR05DPjNic,804
+skrift/templates/setup/auth.html,sha256=0DVL0kU6DlJ2pWe4zwc3DsIVfBAdqpMJxPYvS4zm4OM,4953
+skrift/templates/setup/base.html,sha256=LTXqbnHMvx1wDsxFvo4BSieBPD9pcLMj6NM4ZGzErFM,10372
+skrift/templates/setup/complete.html,sha256=oyT-rYPl0uuyOjPXgNeLr8YoptW9QjHTlScZSViDvTk,630
+skrift/templates/setup/database.html,sha256=gU4-315-QraHa2Eq4Fh3b55QpOM2CkJzh27_Yz13frA,5495
+skrift/templates/setup/restart.html,sha256=GHg31F_e2uLFhWUzJoalk0Y0oYLqsFWyZXWKX3mblbY,1355
+skrift/templates/setup/site.html,sha256=PSOH-q1-ZBl47iSW9-Ad6lEfJn_fzdGD3Pk4vb3xgK4,1680
+skrift-0.1.0a1.dist-info/METADATA,sha256=lrfb40qZ-KZ5o5U7j1A9ablJG4cbqXexdcOTkMMuD54,6365
+skrift-0.1.0a1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+skrift-0.1.0a1.dist-info/entry_points.txt,sha256=4AIrmbeWKOdZnvTsKT3US6N3X9rrgk9jEDsYOPEZ1AE,74
+skrift-0.1.0a1.dist-info/RECORD,,

skrift-0.1.0a1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

skrift-0.1.0a1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+skrift = skrift.__main__:main
+skrift-db = skrift.cli:db