Легкий вес и клиент Dropbox с открытым исходным кодом для MacOS и Linux.
Maestral-это клиент Dropbox с открытым исходным кодом, написанный на Python. Основная цель проекта - предоставить клиенту для платформ и файловых систем, которые больше не поддерживаются Dropbox.
В настоящее время Maestral не поддерживает Dropbox Paper, управление командами Dropbox и управление настройками общих папок. Если вам нужна какая -либо из этой функции, используйте веб -сайт Dropbox или официальный клиент. Maestral поддерживает синхронизацию нескольких учетных записей Dropbox и исключая локальные файлы из синхронизации с файлом «.mignore».
Основное внимание на «простой» синхронизации файлов связано с преимуществами: на MacOS пакет Maestral App значительно меньше, чем официальное приложение Dropbox, и использует меньше памяти. Точное использование памяти будет зависеть от размера вашей синхронизированной папки Dropbox и может быть дополнительно уменьшено при запуске Maestral без графического интерфейса.
Maestral использует Public Dropbox API, который, в отличие от официального клиента, не поддерживает передачу только тех частей файла, которые изменились («двоичная дифференциация»). Таким образом, Маестрал может использовать большую пропускную способность, что официальный клиент. Тем не менее, он будет избегать загрузки или загрузки файла, если он уже существует с тем же контентом локально или в облаке.
Пакет приложений предоставляется для MacOS Catalina и выше и может быть загружен с вкладки Releseses. Этот пакет приложений также является пакетом в качестве домашнего бочка.
На других платформах вы можете загрузить и установить Maestral как пакет Python от PYPI или в качестве изображения Docker из Docker Hub.
Для получения более подробной информации об установке, настройке и системных требованиях, пожалуйста, проверьте документацию.
Официальные мастерские релизы также доступны в качестве домашних бочек. Если у вас есть домашнее пиво в вашей системе, вы можете установить, используя:
$ brew install maestralРекомендуется установить Maestral в виртуальную среду следующим образом:
$ python3 -m venv maestral-venv
$ source maestral-venv/bin/activate
(maestral-venv)$ python3 -m pip install --upgrade maestral Если вы собираетесь использовать графический пользовательский интерфейс, вам также необходимо указать опцию GUI во время установки или обновления. Это установит фронт maestral-qt и PyQt5 на Linux и maestral-cocoa на macOS:
(maestral-venv)$ python3 -m pip install --upgrade 'maestral[gui]'Изображение Docker доступно для платформ x86, ARM/V7 (32 бит) и ARM64 и может быть установлено с:
$ docker pull maestraldbx/maestral
Запустите maestral gui в командной строке (или откройте приложение Maestral на MacOS), чтобы начать маэральный с графическим пользовательским интерфейсом. Во время первого запуска Maestral поможет вам связывать и настройку вашего Dropbox, а затем начнет синхронизировать.
После установки Maestral будет доступен в качестве сценария командной строки, набрав maestral в командной строке. Введите maestral --help , чтобы получить полный список доступных команд. Наиболее важными являются:
maestral gui : начинает массировый графический интерфейс. Создает синхронизионный демон, если не работает.maestral start|stop : запускает или останавливает демон -майестальный синхронизатор.maestral pause|resume : пауза или резюме синхронизируется.maestral autostart -Y|-N : Устанавливает демон для запуска в системе.maestral status : получает текущий статус Маестала.maestral filestatus LOCAL_PATH : получает статус синхронизации отдельного файла или папки.maestral excluded add|remove|list : группа команд для управления исключенными папками.maestral ls DROPBOX_PATH : перечисляет содержимое каталога на Dropbox.maestral notify snooze N : Snoozes настольных уведомлений на n минут. Maestral поддерживает синхронизацию нескольких учетных записей Dropbox, запустив несколько экземпляров с различными файлами конфигурации. Это должно быть настроено из командной строки, передавая опцию --config-name в maestral start или maestral gui . Затем Maestral выберет существующую конфигурацию с данным именем или создаст новую. Например:
$ maestral start --config-name= " personal "
$ maestral start --config-name= " work " Это начнет два экземпляра Maestral, синхронизируя частную и рабочую учетную запись, соответственно. Конфигурации будут автоматически очищены при отключении учетной записи. Вы можете перечислить все в настоящее время связанные учетные записи с помощью maestral config-files . Например, вышеуказанная настройка вернет следующее на MacOS:
$ maestral config-files
Config name Account Path
maestral [email protected] ~/Library/Application Support/maestral/maestral.ini
private [email protected] ~/Library/Application Support/maestral/private.iniПо умолчанию имена папок Dropbox будут содержать капитализированное конфигурационное имя в брекетах. В вышеприведенном случае это будут «Dropbox (личный)» и «Dropbox (работа)».
Полная документация CLI доступна на веб -сайте.
Есть несколько тем, которые могут использовать вашу помощь. Некоторые из них просты, такие как добавление новых команд CLI, другие требуют большего опыта, таких как упаковка для платформ, не являющихся MACO. Обратите внимание на проблемы, помеченные «хорошим первым выпуском» или «Помогите, хотели».
Соответствующие ресурсы:
Ancoming.md содержит подробную информацию о ожидаемом стиле кода и формате тестирования.
Если вы используете пакет приложений MacOS, пожалуйста, рассмотрите возможность спонсировать проект с 1 фунтов стерлингов в месяц, чтобы компенсировать стоимость учетной записи Apple Developer, чтобы подписать и нотаризовать пакет.