refactor(framework, example_async): rename framework to raystack and update example_async project

Author: ForceFledgling

.docs/commands.md

@@ -1,46 +1,46 @@
-# Cotlette Management Commands
+# Raystack Management Commands
 
 ## Overview
 
-Cotlette provides a set of command-line tools for project management, similar to Django's `manage.py` or Flask CLI. These commands help you create projects, apps, run the development server, and more.
+Raystack provides a set of command-line tools for project management, similar to Django's `manage.py` or Flask CLI. These commands help you create projects, apps, run the development server, and more.
 
 ---
 
 ## Available Commands
 
 ### `startproject <project_name>`
-Creates a new Cotlette project with the recommended structure.
+Creates a new Raystack project with the recommended structure.
 
 ```
-cotlette startproject myproject
+raystack startproject myproject
 ```
 
 ### `startapp <app_name>`
 Creates a new app inside your project.
 
 ```
-cotlette startapp blog
+raystack startapp blog
 ```
 
 ### `runserver`
 Starts the development server (default: http://127.0.0.1:8000).
 
 ```
-cotlette runserver
+raystack runserver
 ```
 
 ### `shell`
 Launches an interactive Python shell with project context loaded.
 
 ```
-cotlette shell
+raystack shell
 ```
 
 ### `createsuperuser`
 Creates a superuser account with all permissions.
 
 ```
-cotlette createsuperuser
+raystack createsuperuser
 ```
 
 Options:
@@ -51,10 +51,10 @@ Options:
 Examples:
 ```bash
 # Interactive creation
-cotlette createsuperuser
+raystack createsuperuser
 
 # Non-interactive creation
-cotlette createsuperuser --username admin --email [email protected] --noinput
+raystack createsuperuser --username admin --email [email protected] --noinput
 ```
 
 ### `makemigrations` *(planned)*
@@ -67,12 +67,12 @@ Applies migrations to the database.
 
 ## Custom Commands
 
-You can add your own management commands by creating a Python module in `cotlette/core/management/commands/`.
+You can add your own management commands by creating a Python module in `raystack/core/management/commands/`.
 
 Example:
 ```python
 # myproject/core/management/commands/hello.py
-from cotlette.core.management.base import BaseCommand
+from raystack.core.management.base import BaseCommand
 
 class Command(BaseCommand):
     help = "Prints Hello, World!"
@@ -83,7 +83,7 @@ class Command(BaseCommand):
 
 Run with:
 ```
-cotlette hello
+raystack hello
 ```
 
 ---
@@ -93,7 +93,7 @@ cotlette hello
 - All commands support `--help` for usage info:
 
 ```
-cotlette runserver --help
+raystack runserver --help
 ```
 
 ---

.docs/extending.md

@@ -1,8 +1,8 @@
-# Extending Cotlette
+# Extending Raystack
 
 ## Overview
 
-Cotlette is designed to be extensible. You can add your own apps, commands, middleware, and even swap out core components. This guide covers the main extension points.
+Raystack is designed to be extensible. You can add your own apps, commands, middleware, and even swap out core components. This guide covers the main extension points.
 
 ---
 
@@ -35,7 +35,7 @@ INSTALLED_APPS = [
 Add Python modules to `core/management/commands/`:
 ```python
 # core/management/commands/hello.py
-from cotlette.core.management.base import BaseCommand
+from raystack.core.management.base import BaseCommand
 
 class Command(BaseCommand):
     help = "Prints Hello, World!"
@@ -49,7 +49,7 @@ class Command(BaseCommand):
 
 Write your own middleware and add it to the app:
 ```python
-from cotlette.core.middlewares import BaseMiddleware
+from raystack.core.middlewares import BaseMiddleware
 
 class MyMiddleware(BaseMiddleware):
     async def __call__(self, request, call_next):
@@ -92,4 +92,4 @@ You can override or extend core components (ORM, template engine, etc.) by subcl
 
 ## More
 
-See the [Cotlette source code](../src/cotlette/) for more extension examples. 
+See the [Raystack source code](../src/raystack/) for more extension examples. 

.docs/faq.md

@@ -1,9 +1,9 @@
-# Cotlette FAQ
+# Raystack FAQ
 
 ## General
 
-**Q: What is Cotlette?**  
-A: Cotlette is a modern web framework inspired by Django and built on top of FastAPI. It provides a familiar project structure, its own ORM, template rendering, and management commands.
+**Q: What is Raystack?**  
+A: Raystack is a modern web framework inspired by Django and built on top of FastAPI. It provides a familiar project structure, its own ORM, template rendering, and management commands.
 
 **Q: What Python versions are supported?**  
 A: Python 3.6 and higher.
@@ -15,31 +15,31 @@ A: SQLite is fully supported. PostgreSQL support is planned.
 
 ## Installation
 
-**Q: How do I install Cotlette?**  
-A: Run `pip install cotlette`.
+**Q: How do I install Raystack?**  
+A: Run `pip install raystack`.
 
 **Q: How do I create a new project?**  
-A: Run `cotlette startproject myproject`.
+A: Run `raystack startproject myproject`.
 
 ---
 
 ## Development
 
 **Q: How do I run the development server?**  
-A: Run `cotlette runserver` in your project directory.
+A: Run `raystack runserver` in your project directory.
 
 **Q: How do I create a new app?**  
-A: Run `cotlette startapp myapp`.
+A: Run `raystack startapp myapp`.
 
 **Q: How do I use the shell?**  
-A: Run `cotlette shell` for an interactive Python shell with project context.
+A: Run `raystack shell` for an interactive Python shell with project context.
 
 ---
 
 ## ORM
 
 **Q: How do I define a model?**  
-A: Inherit from `cotlette.db.Model` and use field types from `cotlette.db.fields`.
+A: Inherit from `raystack.db.Model` and use field types from `raystack.db.fields`.
 
 **Q: How do I create tables?**  
 A: Call `Model.create_table()` for each model.
@@ -61,8 +61,8 @@ A: Use `render_template("template.html", context)` in your view.
 
 ## Troubleshooting
 
-**Q: I get `ModuleNotFoundError: No module named 'cotlette'`**  
-A: Make sure your `PYTHONPATH` includes the `src/` directory, or install Cotlette in your environment.
+**Q: I get `ModuleNotFoundError: No module named 'raystack'`**  
+A: Make sure your `PYTHONPATH` includes the `src/` directory, or install Raystack in your environment.
 
 **Q: The server runs but I see a 404 page**  
 A: Make sure you have defined routes in your app and included them in your project URLs.
@@ -74,5 +74,5 @@ A: Ensure you have a `static/` directory and your settings are correct.
 
 ## More Help
 
-- [GitHub Issues](https://github.com/ForceFledgling/cotlette/issues)
-- [Cotlette Documentation](../.docs/index.md) 
+- [GitHub Issues](https://github.com/ForceFledgling/raystack/issues)
+- [Raystack Documentation](../.docs/index.md) 

…nf/project_template/apps/__init__.py-tpl .docs/img/.!23807!login_page.jpgsrc/cotlette/conf/project_template/apps/__init__.py-tpl renamed to .docs/img/.!23807!login_page.jpg src/cotlette/conf/project_template/apps/__init__.py-tpl renamed to .docs/img/.!23807!login_page.jpg

@@ -1,8 +1,8 @@
-# Cotlette Technical Documentation
+# Raystack Technical Documentation
 
 ## Overview
 
-Cotlette is a modern, Django-inspired web framework built on top of FastAPI. It provides a familiar project structure, its own ORM, template rendering, and a set of management commands for rapid web development. Cotlette is designed for both beginners and advanced users who want the power of FastAPI with the convenience of Django-like tools.
+Raystack is a modern, Django-inspired web framework built on top of FastAPI. It provides a familiar project structure, its own ORM, template rendering, and a set of management commands for rapid web development. Raystack is designed for both beginners and advanced users who want the power of FastAPI with the convenience of Django-like tools.
 
 ---
 
@@ -15,14 +15,14 @@ Cotlette is a modern, Django-inspired web framework built on top of FastAPI. It
 - [Templates](#templates)
 - [Middleware](#middleware)
 - [Management Commands](#management-commands)
-- [Extending Cotlette](#extending-cotlette)
+- [Extending Raystack](#extending-raystack)
 - [FAQ](#faq)
 
 ---
 
 ## Project Structure
 
-A typical Cotlette project looks like this:
+A typical Raystack project looks like this:
 
 ```
 myproject/
@@ -51,9 +51,9 @@ myproject/
 
 ## Architecture
 
-Cotlette is built on FastAPI and leverages its async capabilities. Key components:
+Raystack is built on FastAPI and leverages its async capabilities. Key components:
 
-- **ASGI app**: FastAPI-based, with Cotlette-specific extensions
+- **ASGI app**: FastAPI-based, with Raystack-specific extensions
 - **ORM**: Synchronous, inspired by Django ORM, supports SQLite (PostgreSQL in roadmap)
 - **Template Engine**: Jinja2 integration
 - **Management Commands**: CLI for project/app creation, server, shell, migrations (planned)
@@ -111,7 +111,7 @@ See [.docs/commands.md](./commands.md).
 
 ---
 
-## Extending Cotlette
+## Extending Raystack
 
 - **Custom apps**: Add your own Django-style apps
 - **Custom commands**: Add CLI commands
@@ -133,5 +133,5 @@ See [.docs/faq.md](./faq.md) for common questions and troubleshooting.
 - [Template Reference](./templates.md)
 - [Command Reference](./commands.md)
 - [Middleware Reference](./middleware.md)
-- [Extending Cotlette](./extending.md)
+- [Extending Raystack](./extending.md)
 - [FAQ](./faq.md) 

.docs/index.md

@@ -1,14 +1,14 @@
-# Cotlette Middleware
+# Raystack Middleware
 
 ## Overview
 
-Middleware in Cotlette allows you to process requests and responses globally, similar to Django or FastAPI middleware. You can use built-in middleware or write your own for cross-cutting concerns like authentication, logging, or CORS.
+Middleware in Raystack allows you to process requests and responses globally, similar to Django or FastAPI middleware. You can use built-in middleware or write your own for cross-cutting concerns like authentication, logging, or CORS.
 
 ---
 
 ## Built-in Middleware
 
-Cotlette includes (or plans to include):
+Raystack includes (or plans to include):
 - Authentication middleware
 - Session middleware
 - CSRF protection (planned)
@@ -22,12 +22,12 @@ A middleware is a callable that takes a request and a handler, and returns a res
 
 Example:
 ```python
-from cotlette.core.middlewares import BaseMiddleware
+from raystack.core.middlewares import BaseMiddleware
 
 class CustomHeaderMiddleware(BaseMiddleware):
     async def __call__(self, request, call_next):
         response = await call_next(request)
-        response.headers['X-Custom-Header'] = 'Cotlette'
+        response.headers['X-Custom-Header'] = 'Raystack'
         return response
 ```
 
@@ -64,4 +64,4 @@ Middleware are executed in the order they are added. The order matters for thing
 
 ## More
 
-See [FastAPI Middleware](https://fastapi.tiangolo.com/tutorial/middleware/) for advanced patterns (Cotlette is compatible with FastAPI middleware API). 
+See [FastAPI Middleware](https://fastapi.tiangolo.com/tutorial/middleware/) for advanced patterns (Raystack is compatible with FastAPI middleware API). 

.docs/middleware.md

@@ -1,17 +1,17 @@
-# Cotlette ORM Documentation
+# Raystack ORM Documentation
 
 ## Overview
 
-Cotlette includes a lightweight, Django-inspired ORM for working with relational databases (currently SQLite, PostgreSQL in roadmap). It provides a familiar API for defining models, querying data, and managing relationships.
+Raystack includes a lightweight, Django-inspired ORM for working with relational databases (currently SQLite, PostgreSQL in roadmap). It provides a familiar API for defining models, querying data, and managing relationships.
 
 ---
 
 ## Defining Models
 
-Models are Python classes that inherit from `cotlette.db.Model` and use field types from `cotlette.db.fields`:
+Models are Python classes that inherit from `raystack.db.Model` and use field types from `raystack.db.fields`:
 
 ```python
-from cotlette.db import Model, fields
+from raystack.db import Model, fields
 
 class Article(Model):
     title = fields.CharField(max_length=200)

.docs/orm.md

@@ -1,8 +1,8 @@
-# Cotlette Templates Documentation
+# Raystack Templates Documentation
 
 ## Overview
 
-Cotlette uses Jinja2 as its template engine, providing a familiar and powerful way to render HTML pages with dynamic content.
+Raystack uses Jinja2 as its template engine, providing a familiar and powerful way to render HTML pages with dynamic content.
 
 ---
 
@@ -29,7 +29,7 @@ myproject/
 Use the `render_template` shortcut in your views:
 
 ```python
-from cotlette.shortcuts import render_template
+from raystack.shortcuts import render_template
 
 @router.get("/")
 async def home():
@@ -94,7 +94,7 @@ app.jinja_env.filters['reverse'] = reverse_string
 
 Usage in template:
 ```jinja2
-{{ 'cotlette'|reverse }}
+{{ 'raystack'|reverse }}
 ```
 
 ---
@@ -116,7 +116,7 @@ Configure template directories and options in `config/settings.py`:
 ```python
 TEMPLATES = [
     {
-        "BACKEND": "cotlette.template.backends.jinja2.Jinja2",
+        "BACKEND": "raystack.template.backends.jinja2.Jinja2",
         "DIRS": ["templates"],
         "APP_DIRS": True,
     },

.docs/templates.md

@@ -25,8 +25,8 @@ jobs:
 
     - name: Update __init__.py version
       run: |
-        sed -i "s/^__version__ = .*/__version__ = \"${{ env.RELEASE_VERSION }}\"/" src/cotlette/__init__.py
-        cat src/cotlette/__init__.py
+        sed -i "s/^__version__ = .*/__version__ = \"${{ env.RELEASE_VERSION }}\"/" src/raystack/__init__.py
+        cat src/raystack/__init__.py
     
     - name: Set up Python
       uses: actions/setup-python@v4

.github/workflows/pypi.yaml

@@ -64,7 +64,7 @@ cover/
 *.mo
 *.pot
 
-# cotlette stuff:
+# raystack stuff:
 *.log
 local_settings.py
 db.sqlite3