refactor(templates,project): restructure project templates and add async/sync variants

- Split project templates into async and sync versions
- Reorganize app templates structure
- Update example projects with new template structure
- Improve project generation workflow
- Add comprehensive development documentation

Author: ForceFledgling

DEVELOPMENT.md

@@ -0,0 +1,88 @@
+# Raystack Development
+
+## Running without installation
+
+Raystack can be used without installing the library, just by cloning the repository.
+
+### CLI Usage
+
+To run management commands, use the `raystack.py` script in the project root:
+
+```bash
+# Create synchronous project
+python3 raystack.py startproject myproject
+
+# Create asynchronous project
+python3 raystack.py startproject myproject --async
+
+# Create project without home app
+python3 raystack.py startproject myproject --no-home
+
+# Create application
+python3 raystack.py startapp myapp
+
+# View available commands
+python3 raystack.py help
+```
+
+### Using created projects
+
+Created projects can also work without installing the library. Their `manage.py` will automatically find raystack in the `src` folder:
+
+```bash
+cd myproject
+python3 manage.py help
+python3 manage.py runserver
+```
+
+## Library installation
+
+For production use, it's recommended to install the library:
+
+```bash
+pip install raystack
+```
+
+After installation, you can use standard commands:
+
+```bash
+raystack startproject myproject
+raystack startapp myapp
+```
+
+## Project structure
+
+```
+raystack/
+├── raystack.py          # CLI script for development
+├── src/
+│   └── raystack/        # Main library code
+├── example/             # Synchronous project example
+├── example_async/       # Asynchronous project example
+└── test_projects/       # Test projects
+```
+
+## Compatibility
+
+- CLI script `raystack.py` works only for development
+- Created projects work both with installed library and without it
+- `manage.py` templates automatically determine the raystack installation method
+
+## Fixed issues
+
+### Database import errors
+
+When running commands, Python 3.6 warnings may appear, but this is not critical:
+
+```
+/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/jwt/utils.py:7: CryptographyDeprecationWarning: Python 3.6 is no longer supported by the Python core team. Therefore, support for it is deprecated in cryptography.
+```
+
+These warnings do not affect command operation and will disappear when using a newer Python version.
+
+### Lazy imports
+
+All database module imports are now performed lazily (lazy imports), which allows:
+- Running commands without prior database configuration
+- Avoiding circular dependencies
+- Working both with installed library and without it

example/config/settings.py

@@ -7,13 +7,13 @@
 DATABASES = {
     'default': {
         'ENGINE': 'raystack.core.database.sqlalchemy',
-        # Синхронный режим (по умолчанию)
+        # Synchronous mode (default)
         'URL': 'sqlite:///' + str(BASE_DIR / 'db.sqlite3'),
 
-        # Асинхронный режим (раскомментируйте для использования)
+        # Asynchronous mode (uncomment to use)
         # 'URL': 'sqlite+aiosqlite:///' + str(BASE_DIR / 'db.sqlite3'),
 
-        # Другие примеры асинхронных URL:
+        # Other examples of asynchronous URLs:
         # PostgreSQL: 'postgresql+asyncpg://user:pass@localhost/dbname'
         # MySQL: 'mysql+aiomysql://user:pass@localhost/dbname'
     }
@@ -45,7 +45,7 @@
 
 STATIC_URL = "static/"
 
-# Настройки статических файлов
+# Static files settings
 STATICFILES_DIRS = [
     str(BASE_DIR.parent / "src" / "raystack" / "contrib" / "static"),
     str(BASE_DIR / "static"),

example/core/__init__.py

@@ -20,17 +20,17 @@ class Settings(BaseSettings):
     database_url: str
     secret_key: str
     debug: bool
-    youmoney_client_id: str | None = None  # Добавьте эти поля, если они нужны
+    youmoney_client_id: str | None = None  # Add these fields if needed
     youmoney_redirect_url: str | None = None
     youmoney_client_secret: str | None = None
     youmoney_access_token: str | None = None
     youmoney_wallet_number: str | None = None
 
     class Config:
-        env_file = ".env"   # Указывает путь к .env файлу
-        extra = 'ignore'    # Игнорировать лишние поля
+        env_file = ".env"   # Specifies path to .env file
+        extra = 'ignore'    # Ignore extra fields
 
-# Инициализация объекта
+# Initialize object
 settings = Settings(
     database_url="postgresql://user:password@localhost/dbname",
     secret_key="your-secret-key",
@@ -53,7 +53,7 @@ async def not_found(request, exc):
     return RedirectResponse("/auth/accounts/login", status_code=303)
     # return render_template(request=request, template_name="401.html", context={"request": request})
 
-# Класс для аутентификации
+# Authentication class
 class userAuthentication(AuthenticationBackend):
     async def authenticate(self, request):
         jwt_cookie = request.cookies.get('jwt')
@@ -66,7 +66,7 @@ async def authenticate(self, request):
         else:
             return  # unauthenticated
 
-# Middleware для отслеживания истории
+# Middleware for tracking history
 @app.middleware("http")
 async def update_session_history(request, call_next):
     response = await call_next(request)
@@ -75,25 +75,25 @@ async def update_session_history(request, call_next):
     return response
 
 
-# Middleware для работы с сессиями
+# Middleware for session management
 app.add_middleware(SessionMiddleware, secret_key=SECRET_KEY)
 
-# Middleware для аутентификации
+# Middleware for authentication
 app.add_middleware(AuthenticationMiddleware, backend=userAuthentication())
 
 
 from apscheduler.schedulers.background import BackgroundScheduler
 from datetime import datetime
 
-# # Функция, которая будет выполняться периодически
+# # Function that will be executed periodically
 # def periodic_task():
-#     print(f"Периодическая задача выполнена: {datetime.now()}")
+#     print(f"Periodic task completed: {datetime.now()}")
 
-# # Инициализация планировщика
+# # Initialize scheduler
 # scheduler = BackgroundScheduler()
 
-# # Добавление задачи для выполнения каждые 10 секунд
+# # Add task to execute every 10 seconds
 # scheduler.add_job(periodic_task, 'interval', seconds=10)
 
-# # Запуск планировщика
+# # Start scheduler
 # scheduler.start()

example/templates/home/home.html

@@ -1,6 +1,6 @@
 {% extends "base.html" %}
 
 {% block content %}
-    <h1>Добро пожаловать в {{ framework }}!</h1>
-    <p>Это простая домашняя страница.</p>
+    <h1>Welcome to {{ framework }}!</h1>
+    <p>This is a simple home page.</p>
 {% endblock %}

example_async/apps/home/deps.py

@@ -1,11 +1,11 @@
 from fastapi import Depends
 from sqlalchemy.ext.asyncio import AsyncSession
 
-# Используем функционал фреймворка для работы с базой данных
+# Use framework functionality for database operations
 from raystack.core.database.base import get_async_db
 
-# Простая функция для получения текущего пользователя (заглушка)
+# Simple function for getting current user (placeholder)
 async def get_current_user(session: AsyncSession = Depends(get_async_db)):
-    # Здесь можно добавить логику аутентификации
+    # Authentication logic can be added here
     return None
 

example_async/apps/home/views.py

@@ -3,18 +3,18 @@
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlmodel import select
 
-# Используем функционал фреймворка
+# Use framework functionality
 from raystack.core.database.base import get_async_db
 from .models import User
 
 async def home_view(request: Request, session: AsyncSession = Depends(get_async_db)):
     try:
-        # Используем асинхронный синтаксис для SQLModel
+        # Use asynchronous syntax for SQLModel
         result = await session.execute(select(User))
         users = result.scalars().all()
         user_count = len(users)
     except Exception as e:
-        # Если база данных недоступна, показываем заглушку
+        # If database is unavailable, show placeholder
         user_count = 0
         users = []
 

example_async/config/settings.py

@@ -10,13 +10,13 @@
 DATABASES = {
     'default': {
         'ENGINE': 'raystack.core.database.sqlalchemy',
-        # Синхронный режим (для команд управления)
+        # Synchronous mode (for management commands)
         # 'URL': 'sqlite:///' + str(BASE_DIR / 'db.sqlite3'),
 
-        # Асинхронный режим (для веб-сервера)
+        # Asynchronous mode (for web server)
         'URL': 'sqlite+aiosqlite:///' + str(BASE_DIR / 'db.sqlite3'),
 
-        # Другие примеры асинхронных URL:
+        # Other examples of asynchronous URLs:
         # PostgreSQL: 'postgresql+asyncpg://user:pass@localhost/dbname'
         # MySQL: 'mysql+aiomysql://user:pass@localhost/dbname'
     }
@@ -50,7 +50,7 @@
 
 STATIC_URL = "static/"
 
-# Настройки статических файлов
+# Static files settings
 STATICFILES_DIRS = [
     str(BASE_DIR.parent / "raystack" / "src" / "raystack" / "contrib" / "static"),
     str(BASE_DIR / "static"),

example_async/core/__init__.py

@@ -1,4 +1,4 @@
 from raystack import Raystack
 
-# Инициализация объекта
+# Initialize object
 app = Raystack()

example_async/core/security.py

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
 
-    <!-- Favicon для всех браузеров -->
+    <!-- Favicon for all browsers -->
     <link rel="icon" href="/static/favicon.ico" type="image/png">
     <link rel="icon" href="/static/favicon.ico" type="image/x-icon">