geodrive 0.0.5

Universal SDK for rover programming

Python SDK для управления роботами-роверами через gRPC

---

geodrive - это удобный Python SDK для управления роботами-роверами через gRPC протокол.

🚀 Основные возможности

• Два клиента на выбор - Асинхронный для веб-приложений и синхронный для скриптов
• Готовый веб-интерфейс - Красивая панель управления из коробки с картой и телеметрией
• Безопасность - Надежная обработка ошибок и переподключение
• Реальное время - Потоковая телеметрия и управление
• Универсальность - Поддержка различных моделей роботов-роверов

📦 Установка

uv add geodrive
# или
pip install geodrive

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

Базовое использование

Подключение к роверу

from geodrive import Rover

# Подключение к роверу
with Rover(host="10.1.100.160", port=5656) as rover:
    # Отправка команды движения к точке
    rover.goto(5.0, 3.0, 1.57)
    
    # Получение телеметрии
    telemetry = rover.get_telemetry()
    print(f"Позиция: ({telemetry.position[0]:.2f}, {telemetry.position[1]:.2f})")
    print(f"Ориентация: {telemetry.attitude[2]:.2f} рад")

🛠️ Что внутри?

Управление движением

• Точное позиционирование в координатах X, Y, Yaw
• Потоковое отслеживание прогресса движения
• RC-Channels для возможности ручного управления

Телеметрия в реальном времени

• Потоковая передача данных о позиции и ориентации
• Мониторинг состояния батареи и датчиков

Надежная коммуникация

• gRPC для высокопроизводительной связи
• Автоматическое переподключение при обрывах
• Валидация команд и данных

Гибкость использования

• Синхронный для простых скриптов
• Асинхронный для веб-приложений
• Поддержка контекстных менеджеров

📋 Требования

• Python 3.10+
• geonode на стороне робота или кастомный gRPC сервер
• Сетевое соединение с роботом

🔗 Зависимости

geodrive построен на современных технологиях:

• grpcio - высокопроизводительный gRPC клиент
• protobuf - работа с бинарными протоколами
• structlog - структурированное логирование

📚 Документация

Начало работы

• 🚀 Быстрый старт
• 💡 Примеры

API документация

• 🔧 Основные классы

Для разработчиков

• 🤝 Руководство по контрибьютингу

📄 Лицензия

Проект распространяется под лицензией MIT.