geodrive 0.0.3

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.x:.2f}, {telemetry.y:.2f})")
    print(f"Ориентация: {telemetry.yaw:.2f} рад")

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

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

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

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

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

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

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

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

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

📋 Требования

• Python 3.10+
• gRPC сервер на стороне робота
• Сетевое соединение с роботом

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

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

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

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

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

• 🚀 Быстрый старт
• 📦 Установка
• 💡 Примеры

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

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

Сообщество

• 👥 Community Playbook

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

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

📄 Лицензия

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