Утилита предназначена для создания локальных бекапов fig / jam файлов

Для работы необходимо:

1. bash консоль
2. Установленная node (проверено на версии v16.13.0)
3. Для полной версии, установленный python (проверено на Python 2.7.18)

Ligth запуск

Предусмотрен вариант запуска в режиме простого скачивания отдельного файла.

Для этого необходимо в корне проекта:

1. Установить зависимости node (команда npm i)
2. Выполнить команду node figma_download_file_by_url.js figmaLogin=<ваш логин> figmaPassword=<ваш пароль> figmaUrl=<полный адрес файла, который необходимо скачать>.

В ligth запуске все файлы будут сохранены в директорию ./store/download. Если эта директория не пустая, существующие в ней файлы будут переименованы

Full запуск

Требует установленного python, отличается от ligth версии следующим:

1. Скачивает все файлы для команд, указанных в ./config/get_figme_files_list.yml
2. Анализирует время изменения файла в figma и если файл не менялся с прошлого запуска пропускает их

Работает следующим образом:

1. Установить зависимости node (команда npm i)
2. Необходимо запустить скрипт team_file_scanner.sh для подготовки списка файлов для скачивания. Информация о файлах сохраняется в ./process/figma_files_list*.json в следующем формате:

[
    {
        "key": "<ключ файла>",
        "project": "<название проекта>",
        "team": "<название команды>",
        "file": "<название файла>",
        "last_modified": "<дата последнего изменения>",
        "path": "<путь куда будет сохранен файл>"
    },
    ...
    {
        "key": "<ключ файла>",
        "project": "<название проекта>",
        "team": "<название команды>",
        "file": "<название файла>",
        "last_modified": "<дата последнего изменения>",
        "path": "<путь куда будет сохранен файл>"
    }
]

При этом если файл уже существует, сравниваются даты сохранения файла на диск и модификации файла в figma. Если новых изменений нету, то файл исключается из списка на скачивания. При запуске team_file_scanner.sh удаляет предыдущие файлы ./process/figma_files_list*.json, если они были 3. Для запуска скачивания файлов необходимо запустить скрипт team_file_download.sh <ваш логин> <ваш пароль>. Скрипт идет по файлам ./process/figma_files_list*.json и сохраняет их в ./store/TEAM <название команды>/PROJECT <имя проекта>/<имя файла>. Если файл был ранее загружен пердыдущая версия сохранятся с временной меткой.

Настройки

1. ./config/download_settings.json - настройки таймаутов для скачивания файлов

   1. downloadTimeout - ожидание скачивания файла в секундах. Если указан 0 - таймаут оключается
   2. selectorTimeout - ожидание появления нужных пунктов меню на странице в миллисекундах
   3. navigationTimeout - таймаут навигации в миллисекундах
   4. launchTimeout - таймаут запуска headless хрома в миллисекундах
   5. loginTimeout - таймаут ожидания логина в миллисекундах
   6. pageOpenTimeout - таймаут открытия страницы в миллисекундах

2. ./config/get_figme_files_list.yml - настройки для скачивания файлов команд

   1. access_token - access token для вызовов методов figma api
   2. teams - список идентификаторов команд (можно подсмотреть в урле https://www.figma.com/files/<...>/team/<нужный ид команды>/...)