Запрещено использовать с целью получения прибыли. Если возникнут вопросы, создайте issue.

1. Введение.

Pyface будет использовать браузер Firefox для входа в веб-версию DingTalk, что позволит программировать взаимодействие с DingTalk.

2. Операционная среда

Система: Windows (также поддерживаются Linux и Mac, но потребуется изменение настроек в исходном коде, так как по умолчанию используется версия geckodriver для Windows.) Ссылка для скачивания geckodriver: https://npm.taobao.org/mirrors/geckodriver/v0.26.0/ Для работы программы требуется установка браузера Firefox.

3. Настройка.

Настройки браузера хранятся в словаре set_browser (сохраняется навсегда).

Также можно настроить следующим образом (настройки не будут сохранены):

set_browser_dict['geckodriver_path'] = 'путь'
set_browser_dict['is_headless'] = True_or_False
set_browser_dict['time_limit'] = число

Или так (это прототип функции, способ её вызова следует из контекста):

set_browser(geckodriver_path='путь', is_headless=True_or_False, time_limit=число)

Примеры путей к исполняемым файлам geckodriver на разных платформах:| Платформа | Путь | | --- | --- | | Windows | ./w/geckodriver.exe | | MacOS | ./m/geckodriver | | Linux | ./l/geckodriver |

Кстати, если возникают ошибки при выполнении программы, попробуйте заменить относительные пути на абсолютные. Абсолютные пути можно найти в разделе: 6, Приложение. Если проблемы все еще остаются, добавьте папку с geckodriver в переменную PATH.# 4. Определение

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

Имя класса: Dingtalk.
Сначала инициализируйте объект (вызовите конструктор без аргументов).

• Вызовите get_qr() для получения PIL-объекта QR-кода (вызовите метод show() этого объекта для отображения изображения). Обратите внимание, что этот вызов делает предыдущий QR-код недействительным.
  
• Вызовите get_friends() для получения всех контактов.
  
• Вызовите get_latest_msg(name) для получения последнего сообщения контакта name. Подробнее см.: 4, Определение. Обратите внимание, что если вы отправили сообщение сразу перед этим вызовом, то результатом будет ваше отправленное сообщение.
  
• Вызовите get_latest_time(name) для получения времени отправки последнего сообщения контакта name.
  
• Вызовите send_msg(name,msg) для отправки сообщения msg контакту name.
  
• Вызовите send_file(name,file_path) для отправки файла с путём file_path контакту name.
  

6. Приложения

6.1 О geckodriver.

Файл с содержанием geckodriver находится в какой-то папке внутри директории, где расположен init.py, в зависимости от системы.
Можно быстро получить путь до init.py следующим образом:

import py_dingtalk
print(py_dingtalk.__file__)

6.2 Об исключениях.

Имя исключения: PDError. Исключение можно захватить следующими способами:

except PDError:
    print("Ошибка")
# или
except (PDError), e:
    print("Ошибка", e)