Экспорт устройств из консоли Браузер-а

Инструмент для экспорта данных об устройствах из облачной консоли управления. Приложение позволяет загрузить информацию об устройствах, сотрудниках и контейнерах, а затем экспортировать данные в формате CSV или XLSX.

Требования

• Python 3.11 или выше
• Доступ к API консоли (API токен): https://yandex.ru/dev/browser/corp-console/doc/ru/access

Установка и запуск

Для пользователей Windows

Шаг 1: Установка Python

1. Скачайте Python с официального сайта: https://www.python.org/downloads/
2. Запустите установщик
3. ВАЖНО: Отметьте галочку "Add Python to PATH" в начале установки
4. Нажмите "Install Now"
5. После установки откройте командную строку (нажмите Win+R, введите cmd и нажмите Enter)
6. Проверьте установку командой:

   python --version

Шаг 2: Установка uv (менеджер пакетов)

1. В командной строке выполните:

   pip install uv

Шаг 3: Запуск приложения

Выберите один из вариантов:

Вариант А: Запуск без установки (используя uvx)

uvx --from git+https://github.com/abugrin/browser_reports.git browser-reports

Вариант Б: Установка и запуск

uv tool install git+https://github.com/abugrin/browser_reports.git
browser-reports

---

Для пользователей macOS

Шаг 1: Установка Python

Python обычно предустановлен на macOS, но рекомендуется установить актуальную версию:

1. Откройте Terminal (Finder → Программы → Утилиты → Terminal)
2. Установите Homebrew (если ещё не установлен):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Установите Python:

   brew install python@3.11

4. Проверьте установку:

   python3 --version

Шаг 2: Установка uv

pip3 install uv

Шаг 3: Запуск приложения

Вариант А: Запуск без установки (используя uvx)

uvx --from git+https://github.com/abugrin/browser_reports.git browser-reports

Вариант Б: Установка и запуск

uv tool install git+https://github.com/abugrin/browser_reports.git
browser-reports

---

Для пользователей Linux (Ubuntu)

Шаг 1: Установка Python

1. Откройте терминал (Ctrl+Alt+T)
2. Обновите список пакетов:

   sudo apt update

3. Установите Python:

   sudo apt install python3.11 python3-pip

4. Проверьте установку:

   python3 --version

Шаг 2: Установка uv

pip3 install uv

Если команда pip3 не найдена, выполните:

sudo apt install python3-pip
pip3 install uv

Шаг 3: Добавление пути к исполняемым файлам Python

Добавьте следующую строку в файл ~/.bashrc или ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Затем перезагрузите конфигурацию:

source ~/.bashrc

Шаг 4: Запуск приложения

Вариант А: Запуск без установки (используя uvx)

uvx --from git+https://github.com/abugrin/browser_reports.git browser-reports

Вариант Б: Установка и запуск

uv tool install git+https://github.com/abugrin/browser_reports.git
browser-reports

---

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

Первый запуск

1. Запустите приложение командой browser-reports
2. Приложение запросит API токен для доступа к Яндекс.Браузер API
3. Введите токен (он будет скрыт при вводе)
4. Подтвердите сохранение токена для будущих запусков

Последующие запуски

1. Приложение предложит использовать сохранённый токен
2. Выберите формат экспорта (CSV или XLSX)
3. Укажите имя файла для экспорта
4. Дождитесь завершения экспорта

Где хранится токен?

Токен сохраняется в файле .env в директории:

• Windows: C:\Users\ИмяПользователя\.browser_reports\.env
• macOS/Linux: ~/.browser_reports/.env

Структура экспортируемых данных

Экспортируемый файл содержит следующие поля:

Поле	Описание
ID физического устройства	Физический идентификатор устройства
Имя машины	Имя машины
Платформа ОС	Операционная система (Windows, macOS, Linux и т.д.)
Версия ОС	Версия операционной системы
Имя компьютера	Имя компьютера
Серийный номер	Серийный номер устройства
Модель устройства	Модель устройства
Производитель	Производитель устройства
Логин пользователя	Логин пользователя на устройстве
Версия браузера	Версия Браузера
Тип ассоциации	employee, container или none
Email сотрудника	Email сотрудника (если привязано к сотруднику)
ФИО сотрудника	Полное имя сотрудника
Логин сотрудника	Логин сотрудника
Название контейнера	Название контейнера (если привязано к контейнеру)
Дата создания	Дата создания записи (формат: дд-мм-гггг чч:мм:сс)
Дата обновления	Дата последнего обновления (формат: дд-мм-гггг чч:мм:сс)

Решение проблем

Ошибка "command not found" после установки

Windows:

# Перезапустите командную строку

macOS/Linux:

# Убедитесь, что путь к исполняемым файлам добавлен в PATH
export PATH="$HOME/.local/bin:$PATH"

Ошибка подключения к API

• Проверьте правильность введённого API токена
• Убедитесь в наличии доступа к интернету
• Проверьте, что токен не истёк

Ошибка при экспорте

• Убедитесь, что у вас есть права на запись в выбранную директорию
• Закройте файл Excel, если он открыт при повторном экспорте

Локальная разработка

1. Клонируйте репозиторий:

   git clone https://github.com/abugrin/browser_reports.git
   cd browser_reports

2. Установите зависимости:

   uv sync

3. Запустите приложение:

   uv run browser-reports

Лицензия

MIT

Автор

Anton Bugrin (abugrin@yandex.ru)