README
¶
Awesome Boss – FinTech-фреймворк на Go, вдохновлённый котом Боссом! 🐱
Awesome Boss — это лёгкий, быстрый и безопасный фреймворк для Go.
Он сочетает производительность fasthttp с простотой MTH-архитектуры (Model–Templates–Handler).
🧪 Текущая версия: 0.5 ** – ядро готово, BAT, Boss Socket,
boss.tomlготов, аудит и DDoS-защита готовы, проведены доработки, BossQ, Decimal, HTTP/2, плагины, и улучшенный WebSocket - следующие версии добавят ещё больше нового
✨ Быстрый старт
go install github.com/boss-technologies/awesome-boss/cmd/boss@latest
boss new myapp --template normal
cd myapp
boss run
Готово! Сервер запущен на http://localhost:8080.
Пример кода
package main
import (
"log"
"github.com/boss-technologies/awesome-boss"
"github.com/boss-technologies/awesome-boss/config"
"github.com/boss-technologies/awesome-boss/core"
)
func main() {
cfg, err := config.LoadConfig("boss.toml")
if err != nil {
log.Fatalf("Ошибка загрузки конфигурации: %v", err)
}
app := awesomeboss.New(cfg)
app.Get("/", func(ctx *core.BossContext) error {
return ctx.JSON(200, map[string]string{"message": "Привет от кота Босса! 🐈"})
})
log.Fatal(app.Run(cfg.Addr))
}
📦 Особенности
- 🚀 Молниеносная скорость –
fasthttp+ Go 1.26 - 🧩 MTH-архитектура – Model, Templates, Handler. Никакой магии.
- 🪄 Middleware – глобальные и на уровне групп
- 🧶 Шаблонизатор Fur – на основе
html/template, безопасный от XSS - 🔐 BAT (Boss Auth Token) – токены на PASETO
- 📡 Boss Socket – высокопроизводительный WebSocket
- 🏦 Два режима:
normal(быстрый старт) иfintech(Decimal, аудит, DDoS-защита) - 🧩 Плагины – Позволяют расширять функционал без изменения ядра на основе интерфейсов.
- 🕵🏻♂️ BossQ - быстрая ORM с кодогенерацией.
- 🕹 Boss Admin - Админ-панель, созданная для Awesome Boss. Будет в 0.9
- 💰 Decimal "из коробки" - встроенный Decimal. Уже с 0.4
🗺️ Дорожная карта (Roadmap)
| Версия | Что появится |
|---|---|
| 0.1 | ✅ Роутер, Fur, CLI, два режима |
| 0.2 | ✅ BAT, Boss Socket, boss.toml |
| 0.3 | ✅ Аудит, безопасность, DDoS-защита |
| 0.4 | ✅ BossQ (ORM + Decimal) и HTTP/2 |
| 0.5 | ✅ Система плагинов, улучшение WebSocket |
| 0.6 | 🔜 Батарейки - куда-же без них! |
| 0.7 | Батареек много не бывает 🧰 |
| 0.8 | Boss Socket (рост производительности) |
| 0.9 | Boss Admin (админ-панель), генерация моделий (boss generate model), кеширование |
| 1.0 | Юбилей, полноценная работа с плагинами |
👉 Сейчас версия 0.5: - – ядро готово, BAT, Boss Socket,
boss.tomlготов, аудит и DDoS-защита готовы, проведены доработки, BossQ, Decimal, HTTP/2, плагины, и улучшенный WebSocket - следующие версии добавят ещё больше нового
⚙️ Установка CLI
go install github.com/boss-technologies/awesome-boss/cmd/boss@latest
Проверь: boss version
📄 Лицензия
AGPL v3 – подробности в файле LICENSE.
🐈 Благодарности
Вдохновлено моим котом Боссом, который нажимает лапой на клавиатуру, когда я пишу код.
Сделано с любовью
Documentation
¶
Index ¶
- func Logger(next core.Handler) core.Handler
- type BossApp
- func (app *BossApp) Delete(path string, handler core.Handler)
- func (app *BossApp) EnableCSRF(secretKey []byte)
- func (app *BossApp) Get(path string, handler core.Handler)
- func (app *BossApp) Group(prefix ...string) *Group
- func (app *BossApp) Post(path string, handler core.Handler)
- func (app *BossApp) Put(path string, handler core.Handler)
- func (app *BossApp) Run(addr string) error
- func (app *BossApp) Set(key string, value any)
- func (app *BossApp) Static(prefix, dir string)
- func (app *BossApp) StaticFS(prefix string, fsys fs.FS)
- func (app *BossApp) Use(mw core.Middleware)
- func (app *BossApp) WebSocket(path string, handler func(conn net.Conn))
- type Fur
- type Group
- func (g *Group) Delete(path string, handler core.Handler) *Group
- func (g *Group) Get(path string, handler core.Handler) *Group
- func (g *Group) Post(path string, handler core.Handler) *Group
- func (g *Group) Put(path string, handler core.Handler) *Group
- func (g *Group) Use(mw core.Middleware) *Group
- func (g *Group) WebSocket(path string, handler func(net.Conn)) *Group
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type BossApp ¶
type BossApp struct {
// contains filtered or unexported fields
}
BossApp представляет HTTP-приложение с поддержкой middleware и групп маршрутов
func (*BossApp) EnableCSRF ¶
EnableCSRF включает защиту от CSRF. secretKey — 32-байтовый ключ.
func (*BossApp) Static ¶
Static регистрирует маршрут для отдачи статических файлов из указанной директории. Например: app.Static("/static", "./public")
func (*BossApp) StaticFS ¶ added in v0.5.5
StaticFS регистрирует обработчик для раздачи файлов из embed.FS
func (*BossApp) Use ¶
func (app *BossApp) Use(mw core.Middleware)
Use добавляет глобальное middleware
type Fur ¶
type Fur struct {
// contains filtered or unexported fields
}
func (*Fur) Render ¶
Render выполняет рендеринг шаблона с данными, используя пул буферов для скорости.
func (*Fur) RenderPartial ¶ added in v0.5.8
RenderPartial рендерит только указанный шаблон БЕЗ основного макета. Идеально для HTMX-запросов.
type Group ¶
type Group struct {
// contains filtered or unexported fields
}
Group представляет группу маршрутов с общими middleware
Source Files
Directories