novcord-bot 0.1.0

Асинхронная библиотека для NovCord Bot API в стиле aiogram (import novcord)

novcord — Python-библиотека для NovCord Bot API

Асинхронная библиотека для написания ботов NovCord. API в стиле aiogram: Dispatcher/Router, декораторы-хендлеры, magic-filter F, InlineKeyboardBuilder, лёгкий FSM.

Боты хостятся тобой: запускаешь скрипт на своём ПК/сервере — бот работает, пока скрипт запущен (как у Telegram). Сервер NovCord только отдаёт Bot API.

Установка

pip install novcord-bot

Ставится как novcord-bot, а в коде импортируется как import novcord (дефис в импортах Python недопустим). Зависимость — только aiohttp.

Пока пакет не опубликован в PyPI — ставь локально из этой папки:

cd novcord-python
pip install .

Публикация в PyPI (чтобы заработал глобальный pip install novcord-bot) описана в PUBLISHING.md.

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

import asyncio
from novcord import Bot, Dispatcher, Router, F
from novcord.filters import Command
from novcord.keyboard import InlineKeyboardBuilder

dp = Dispatcher()
router = Router()
dp.include_router(router)

@router.message(Command("start"))
async def start(message):
    kb = InlineKeyboardBuilder()
    kb.button(text="Кнопка", callback_data="hi")
    kb.button(text="Сайт", url="https://novcord.online")
    await message.answer("Привет!", reply_markup=kb.as_markup())

@router.callback_query(F.data == "hi")
async def hi(query):
    await query.answer("Нажато!")
    await query.message.answer("Спасибо за нажатие 👍")

@router.message(F.text)
async def echo(message):
    await message.answer(message.text)

async def main():
    bot = Bot("ТВОЙ_ТОКЕН")   # токен из Настройки → Мои боты
    await dp.start_polling(bot)

asyncio.run(main())

Токен берётся в приложении: Настройки → Мои боты → создать бота → скопировать токен.

Локальный сервер

bot = Bot("ТОКЕН", base_url="http://localhost:3008")

Фильтры

Запись	Что значит
Command("start")	сообщение /start (и /start аргументы)
F.text	у сообщения непустой текст
F.text.startswith("/")	текст начинается с /
F.text.contains("foo")	текст содержит foo
F.data == "a"	у callback data == "a"
F.data.in_({"a", "b"})	data в наборе
MyStates.waiting	текущее состояние FSM

Несколько фильтров в одном декораторе = И (все должны пройти):

@router.message(Command("admin"), F.text.contains("secret"))
async def h(message): ...

Inline-клавиатура

kb = InlineKeyboardBuilder()
kb.button(text="A", callback_data="a")
kb.button(text="B", callback_data="b")
kb.button(text="Сайт", url="https://novcord.online")
kb.adjust(2, 1)          # 2 кнопки в первом ряду, 1 во втором
markup = kb.as_markup()

FSM (пошаговые диалоги)

from novcord.fsm import State, StatesGroup

class Form(StatesGroup):
    name = State()
    age = State()

@router.message(Command("form"))
async def start(message, state):       # state инжектится автоматически
    await state.set_state(Form.name)
    await message.answer("Имя?")

@router.message(Form.name)
async def got_name(message, state):
    await state.update_data(name=message.text)
    await state.set_state(Form.age)
    await message.answer("Возраст?")

@router.message(Form.age)
async def got_age(message, state):
    data = await state.update_data(age=message.text)
    await state.clear()
    await message.answer(f"{data['name']}, {data['age']}")

Хендлер может принимать state (FSMContext) и/или bot — они подставляются по имени параметра.

Методы Bot

Метод	Описание
get_me()	инфо о боте
send_message(chat_id, text, reply_markup=, reply_to_message_id=)	текст
send_photo(chat_id, photo=путь | file_url=, caption=, reply_markup=)	фото
send_document(chat_id, document=путь | file_url=, caption=)	файл
edit_message_text(chat_id, message_id, text, reply_markup=)	редактировать
delete_message(chat_id, message_id)	удалить
answer_callback_query(id, text=, show_alert=)	ответ на нажатие
set_my_commands([("start","Запуск")])	список команд
get_my_commands()	получить команды

Про chat_id: это id ПОЛЬЗОВАТЕЛЯ (message.from_user.id), не id диалога. Шорткаты message.answer() / callback.message.answer() подставляют его сами — вручную думать об этом не нужно.

Шорткаты

• message.answer(text) — ответить в тот же чат
• message.reply(text) — ответить с цитированием
• message.answer_photo(...), message.answer_document(...)
• message.edit_text(...), message.delete()
• callback.answer(text) — подтвердить нажатие
• callback.message — сообщение, под которым была кнопка

Примеры

• examples/echo_bot.py — эхо + inline-кнопки
• examples/fsm_bot.py — пошаговая анкета (FSM)

Ограничения v1

• Только личные сообщения (DM). Серверные каналы — позже.
• answer_callback_query подтверждает нажатие (всплывающий тост в UI — на будущее); отвечай на нажатия обычным message.answer / edit_text.