Metadata-Version: 2.1
Name: fasttower
Version: 0.1.6
Summary: A Django-like framework built on FastAPI
Home-page: https://github.com/pysashapy/fasttower
License: MIT
Keywords: python,api,framework,web,rest,async,swagger,python3,asyncio,easy-web,starlette,fastapi,fasttower
Author: Alexander Ibragmov
Author-email: sasha.2000ibr@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Framework :: FastTower
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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
Provides-Extra: tortoise
Requires-Dist: Jinja2 (>=3.1.4,<4.0.0)
Requires-Dist: aiosmtplib (>=3.0.2,<4.0.0)
Requires-Dist: fastapi (>=0.115.0,<0.116.0)
Requires-Dist: fastapi-admin (>=1.0.4,<2.0.0) ; extra == "tortoise"
Requires-Dist: fastapi-cache2 (>=0.2.2,<0.3.0)
Requires-Dist: fastapi-debug-toolbar (>=0.6.3,<0.7.0)
Requires-Dist: ipython (>=8.27.0,<9.0.0)
Requires-Dist: itsdangerous (>=2.2.0,<3.0.0)
Requires-Dist: redis (>=5.2.0,<6.0.0)
Requires-Dist: scrypt (>=0.8.24,<0.9.0)
Requires-Dist: tortoise-orm (>=0.21.7,<0.22.0) ; extra == "tortoise"
Requires-Dist: typer (>=0.12.5,<0.13.0)
Requires-Dist: uvicorn (>=0.30.6,<0.31.0)
Project-URL: Bug Tracker, https://github.com/pysashapy/fasttower/issues
Project-URL: Documentation, https://pysashapy.github.io/fasttower
Project-URL: Repository, https://github.com/pysashapy/fasttower.git
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://pysashapy.github.io/fasttower/"><img src="docs/img/logo.png" alt="FastTower"  width="256"></a>
</p>
<p align="center">
    <em>FastTower — это молодой фреймворк основанный на FastAPI для быстрого создания серверных приложений с Django-like структурой.</em>
</p>
<p align="center">
<a href="https://pypi.org/project/fasttower" target="_blank">
    <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/fasttower">
</a>
<a href="https://pypi.org/project/fasttower" target="_blank">
    <img src="https://img.shields.io/pypi/pyversions/fasttower.svg?color=%2334D058" alt="Supported Python versions">
</a>
</p>

## Features

- Легкая настройка
- Высокая производительность
- Простота в использовании
- Админ панель

## Быстрый старт

В настоящее время официально поддерживаться только tortoise orm и админ панель для нее, но вы можете легко добавить свою
поддержку бд модернизируя
FastTower app в asgi.py файле

[Полный пример](https://github.com/pysashapy/fasttower/tree/main/examples/start)

### Установка

```console
pip install fasttower[tortoise]
```

Так же для управления миграциями требуется aerich, а именно его модернизированный форк

```console
pip install git+https://github.com/pysashapy/taerich.git@0.0.1
```

### Создание проекта

Для начала требуется сгенерировать основное приложение

```console
tower g p example
```

После выполнения команды, вы можете обнаружить Django-like структуру проекта и сразу же запустить сервер

```console
python manage.py run
```

<details markdown="1">
<summary>Или другим сервером...</summary>
```console
uvicorn example.asgi:app 
```
</details>

### Обзор

Главная роль manage.py файла установить env **FASTTOWER_SETTINGS_MODULE** указывающею путь до вашего settings.py
файла(**example.settings**). Вы можете
установить ее сами и после этого использовать команду **tower**. Далее будет использоваться команда **tower**, но вы
всегда можете использовать **python manage.py**
<details markdown="1">
<summary>Запуск с установленной env...</summary>
```console
tower run
```
</details>

### Структура проекта

#### asgi.py

FastTower - это полностью совместимый FastAPI class.

```python
"""
ASGI config for example project.

It exposes the ASGI callable as a module-level variable named ``application``.
"""

import os

from fasttower.utils import setup

os.environ.setdefault("FASTTOWER_SETTINGS_MODULE", "example.settings")
setup()

from fasttower.server import FastTower

from example.routers import router

app = FastTower(title="FastTower API Documentation")

app.include_router(router)
```

<details markdown="1">
<summary>Если не нужен tortoise...</summary>
Уберите lifespan
```Python
lifespan=lifespans([tortoise_lifespan])
```
</details>

#### settings.py

Вправду очень похоже на Django?

Основные поля: INSTALLED_APPS, MIDDLEWARE, USER_MODEL(Только tortoise!)

```python
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = "niJEjVCDfqHI_Fke_oUDVgcqkfWfW8ZEoUT_OQxVKco"

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

ALLOWED_HOSTS = ["*"]

INSTALLED_APPS = [
    'fasttower.apps.taerich',
    'fasttower.auth',
]

MIDDLEWARE = [
    ["fastapi.middleware.trustedhost:TrustedHostMiddleware", {"allowed_hosts": ALLOWED_HOSTS}],
    ["fastapi.middleware.gzip:GZipMiddleware", {"minimum_size": 1000, "compresslevel": 5}],
]
if DEBUG:
    MIDDLEWARE += ["debug_toolbar.middleware:DebugToolbarMiddleware"],

USER_MODEL = 'fasttower.auth.models:BaseUser'

ASGI = "example.asgi:app"

LANGUAGE_CODE = "en-us"
TIME_ZONE = "UTC"
USE_TZ = True

# Database
DATABASES = {
    "connections": {
        "default": {
            "engine": "tortoise.backends.sqlite",
            "credentials": {
                "file_path": str(BASE_DIR / "db.sqlite3"),
            }
        },
    },
}

# https://github.com/fastapi-admin/fastapi-admin
ADMIN_PANEL_REDIS = 'redis://localhost:6379/0'
```

##### INSTALLED_APPS

После создания нового приложения обязательно добавьте его в **INSTALLED_APPS**! Иначе у FastTower не будет доступа к
моделям и командам
приложения

```python
INSTALLED_APPS = [
    'fasttower.apps.taerich',
    'fasttower.auth',
    ...
    'appexample',
]
```

##### MIDDLEWARE

Поддерживаются все starlette совместимые middleware!

Структура MIDDLEWARE

```python
MIDDLEWARE = [
    ["fastapi.middleware.trustedhost:TrustedHostMiddleware", {"allowed_hosts": ALLOWED_HOSTS}],
    ["fastapi.middleware.gzip:GZipMiddleware", {"minimum_size": 1000, "compresslevel": 5}],
    ...
    ["path:class", {...kwargs}],
]
```

#### routers.py

Является отправной точкой для всех будущих APPs

```python
from fasttower.routers import APIRouter

router = APIRouter(prefix="/api/v1")
router.include_router(APP_ROUTER, prefix='/app')
```

### Создание нового приложения

Выполните команду которая создаст приложение

```console 
tower g a appexample
```

После ее выполнения обязательно добавьте приложение в **settings.py -> INSTALLED_APPS**

```python
INSTALLED_APPS = [
    'fasttower.apps.taerich',
    'fasttower.auth',
    ...
    'appexample',
]
```

Каждое приложение содержит **config.py, models.py, admin.py, serializers.py, routers.py и views.py**

#### Models

Основано на [tortoise](https://tortoise.github.io/), так что вы можете просто импортировать ее и работать с ней!

```python
from fasttower.db import models


class FastTowerModel(models.Model):
    say = models.CharField(max_length=100, default="Hello World!")
```

#### Admin

Тут содержится описание моделей для [админ панели](https://fastapi-admin-docs.long2ice.io/)

```python
from fastapi_admin.resources import Model, Dropdown
from fasttower import admin

from appexample import models


@admin.site.app.register
class AppexampleTabMenu(Dropdown):
    label = "Appexamples"
    icon = "fas fa-bars"
    resources = []
    title = "Appexamples"
```

#### Views

Тут все аналогично FastAPI, скоро появятся **mixins** как в Django для простых **CRUD** задач!

```python
from appexample.models import FastTowerModel

from fasttower.routers import APIRouter

router = APIRouter()


@router.get("/")
async def say():
    return await FastTowerModel().create()
```

Не забудьте подключить в **appexample.routers**, а так же в **example.routers**

### Admin panel

Является экспериментальной функцией. В настоящее время для ее работы требуется
[**Redis**](https://github.com/redis/redis-py)

Проверьте в settings.py

```
ADMIN_PANEL_REDIS = 'redis://localhost:6379/0'
```

А так же включите его в asgi.py

```python
from fasttower.admin.site import app as admin_app, lifespan_admin
from fasttower.db import lifespan

app = FastTower(title="FastTower API Documentation", lifespan=lifespans([lifespan, lifespan_admin]))

app.mount('/admin', admin_app)

```

<details markdown="1">
<summary>Полный код...</summary>
```python
"""
ASGI config for example project.
It exposes the ASGI callable as a module-level variable named ``application``.
"""
import os
from fasttower.utils import setup, lifespans
os.environ.setdefault("FASTTOWER_SETTINGS_MODULE", "example.settings")
setup()
from fasttower.server import FastTower
from example.routers import router
from fasttower.admin.site import app as admin_app, lifespan_admin
from fasttower.db import lifespan
app = FastTower(title="FastTower API Documentation", lifespan=lifespans([lifespan, lifespan_admin]))
app.mount('/admin', admin_app)
app.include_router(router)
```
</details>

### Commands

Список текущих команд и их описания вы можете получить используя команду

```console
tower --help
```

```text
 Usage: tower [OPTIONS] COMMAND [ARGS]...                                                                                                                                                                                         

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current shell.                                                                                                                                                        │
│ --show-completion             Show completion for the current shell, to copy it or customize the installation.                                                                                                                 │
│ --help                        Show this message and exit.                                                                                                                                                                      │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ db          Database commands                                                                                                                                                                                                  │
│ g           Generate project structures and app components for FastTower.                                                                                                                                                      │
│ run         Запуск FastTower сервера                                                                                                                                                                                           │
│ shell       Запускает интерактивную оболочку.                                                                                                                                                                                  │
│ superuser   Create a superuser.                                                                                                                                                                                                │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
```

#### Создание новых команд

Для этого создайте файл в папке **app**(appexample) commands.py

```python
import typer

example_commands = typer.Typer(name="appexample", help="Example commands")


@example_commands.command()
def hello_world():
    print("Hello World!")

```

Вот и все её можно запустить!

```console
tower appexample hello-world
```

```console
Hello World!
```

Более детально про [Typer](https://typer.tiangolo.com/)

## Продолжение следует...
