whatsupbraeker 0.1.0

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!"

Флаг --lib позволяет указать путь к .so, а --db-uri — строку подключения к SQLite с сохранённой сессией WhatsApp.

Требования

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

Примечания

• В pkg/waclient.Config можно управлять тайм-аутами, логами и выводом QR.
• WaRun возвращает JSON со статусом, ID отправленного сообщения, собранными в сессии сообщениями и флагом requires_qr.