whatsupbraeker 0.3.3

Python bindings for the WhatsUpBraeker Go WhatsApp bridge.

What-s-up-braeker

Go-библиотека для работы с WhatsApp через whatsmeow. Пакет предоставляет минимальный API, пригодный для собственных Go-приложений и для использования через ctypes в Python.

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

• pkg/waclient — основная логика соединения, отправки и получения сообщений.
• cmd/wa-bridge — точка сборки c-shared, экспортирующая функции WaRun и WaFree.
• examples/python/client.py — пример вызова общей библиотеки из Python.
• main.go — демонстрация использования пакета напрямую из Go.

Использование в Go

go run ./main.go

Перед запуском задайте номер телефона и текст сообщения в main.go. При первой авторизации появится QR-код, который нужно отсканировать в WhatsApp.

Чтобы подключить библиотеку в другом проекте:

import "github.com/Alias1177/What-s-up-braeker/pkg/waclient"

Сборка динамической библиотеки

mkdir -p dist
go build -buildmode=c-shared -o dist/libwa.so ./cmd/wa-bridge

Команда создаст dist/libwa.so и заголовок dist/libwa.h. В средах с ограниченными правами на запись в глобальные кэши можно использовать локальные каталоги:

GOTOOLCHAIN=go1.24.0 \
GOMODCACHE=$PWD/.gomodcache \
GOCACHE=$PWD/.gocache \
go build -buildmode=c-shared -o dist/libwa.so ./cmd/wa-bridge

Пример на Python

После сборки библиотеки:

python3 examples/python/client.py \
  --phone [phone] \
  --message "Hello from Python!" \
  --read-limit 5 \
  --listen-seconds 8

Флаги --read-limit и --listen-seconds позволяют регулировать, сколько входящих сообщений будет собрано и как долго ждать отве тов. Передайте --read-only, чтобы ничего не отправлять и просто прочитать чат. Флаг --lib позволяет указать путь к .so, а -- db-uri — строку подключения к SQLite с сохранённой сессией WhatsApp.

Использование в собственном скрипте Python

from pathlib import Path

from python import WhatsAppBridge

bridge = WhatsAppBridge(Path("dist/libwa.so"))

# Отправить сообщение и подождать до 3 ответов не дольше 15 секунд
response = bridge.send_message(
    db_uri="file:whatsapp.db?_foreign_keys=on",
    phone="79991234567",
    text="Привет!",
    read_limit=3,
    listen_seconds=15,
)

# Только прочитать сообщения — будет использован JSON-пейлоад без текста
history = bridge.read_messages(
    db_uri="file:whatsapp.db?_foreign_keys=on",
    phone="79991234567",
    read_limit=10,
)

Под капотом WhatsAppBridge формирует JSON-параметры для функции WaRun. Доступные поля:

• send_text — текст сообщения, который нужно отправить (если опущен, работает режим чтения);
• read_limit — сколько входящих сообщений вернуть (по умолчанию библиотека берёт разумное значение; сначала выгружается имеющаяся история чата, затем собираются новые сообщения за время сессии);
• listen_seconds — максимальное время ожидания новых сообщений (дробное число секунд);
• filter_chat — идентификатор чата (JID), который нужно слушать; если опущен, используется номер из аргумента phone;
• include_from_me — возвращать ли собственные сообщения в выдаче (по умолчанию true).

Требования

• Go 1.24+ (для зависимостей whatsmeow);
• база WhatsApp (whatsapp.db) рядом с бинарём;
• Python 3.8+ (для примера).

Примечания

• В pkg/waclient.Config можно управлять тайм-аутами, логами и выводом QR.
• WaRun возвращает JSON со статусом, ID отправленного сообщения, собранными в сессии сообщениями и флагом requires_qr.
• При необходимости можно передать JSON-строку напрямую в message (например, {"send_text":"hi","read_limit":5}).