Всплывающие уведомления в 10 строчек на Python

Введение

Мы часто используем print что-бы проследить за состоянием скрипта, или когда занимаемся отладкой. Вместо того, что-бы постоянно смотреть в окно терминала и ждать какой-то вывод, мы можем исползовать всплывающие уведомления как способ для просмотра вывода и параллельно с этим заниматься чем-то еще.

Сделать это совсем не сложно — мы будем использовать встроенные комманды нашей операционной системы для вывода уведомлений, просто запуская их через Python. Несколько строчек кода, и никаких сторонних модулей.

Mac OS

Следующая команда запускает AppleScript (встроенный скриптовый язык компании Apple) для уведомлений.

osascript -e ‘display notification «Your message goes here» with title «Title»‘

Если вы запустите эту комманду то увидите следующий результат:

Подробнее о самом скрипте:

Итак, если вы используете Mac OS, тогда вы можете выполнить следующий Python код:

Запустив этот скрипт, вы увидите схожий результат как и выше.

Linux

Linux предлагает еще более простой вариант:

Аналогично тому, как мы выводили уведомление на Mac OS через os.system, так же можно поступить в Linux системе.

Windows

В Windows нет такой команды которая запускала бы уведомления как в Linux и Mac OS, но это все равно можно сделать с помощью библиотеки win10toast , сначала её нужно установить: pip install win10toast и теперь пример ее использования:

Метод show_toast принимает и другие аргументы, но подробнее о них вы можете напрямую почитать — просто вызвав help передав ей объект функции о которой нужно узнать подробнее.

Делаем скрипт кросс-платформенным

Что-бы узнать какая система стоит на вашем компьютере используется команда system() из встроенной библиотеки platform . Для Mac OS эта команда возвращает строку «Darwin», для Linux «Linux», для Windows — «Windows», теперь, зная все это, можем поместить весь код в функцию push . Вот что получится:

Вывод

В статье было показано как вывести всплывающие уведомления на Python’е, определенно это был не единственный способ. Существует достаточное количество библиотек которые выполняют подобные цели.

Использование концентраторов уведомлений с Python How to use Notification Hubs from Python

Можно обращаться ко всем функциям Центров уведомлений из серверной части Java, PHP, Python или Ruby, используя интерфейс REST Центра уведомлений в соответствии с описанием в статье MSDN Интерфейсы API REST концентраторов уведомлений. You can access all Notification Hubs features from a Java/PHP/Python/Ruby back-end using the Notification Hub REST interface as described in the MSDN article Notification Hubs REST APIs.

Это образец эталонной реализации для отправки уведомлений в Python, который не является официально поддерживаемым пакетом SDK концентраторов уведомлений Python. This is a sample reference implementation for implementing the notification sends in Python and is not the officially supported Notifications Hub Python SDK. Этот образец был создан с помощью Python 3.4. The sample was created using Python 3.4.

В этой статье показано, как: This article shows you how to:

• Построение клиента REST для функций концентраторов уведомлений на языке Python. Build a REST client for Notification Hubs features in Python.
• Отправка уведомлений с помощью интерфейса API REST концентратора уведомления Python. Send notifications using the Python interface to the Notification Hub REST APIs.
• Получение дампа запросов и ответов HTTP REST для отладки и образовательных целей. Get a dump of the HTTP REST request/response for debugging/educational purpose.

Можно воспользоваться указаниями в разделе Приступая к работе с центрами уведомлений для выбранной мобильной платформы, которая реализует серверную часть на языке Python. You can follow the Get started tutorial for your mobile platform of choice, implementing the back-end portion in Python.

Область действия образца ограничена отправкой уведомлений. Образец не выполняет функции управления регистрацией. The scope of the sample is only limited to send notifications and it doesn’t do any registration management.

Интерфейс клиента Client interface

Интерфейс основного клиента предоставляет те же методы, что и пакет SDK центров уведомлений для .NET. The main client interface can provide the same methods that are available in the .NET Notification Hubs SDK. Этот интерфейс дает возможность напрямую переводить все руководства и примеры, доступные на этом сайте в настоящий момент и пополняемые интернет-сообществом. This interface allows you to directly translate all the tutorials and samples currently available on this site, and contributed by the community on the internet.

Полный код доступен в примере оболочки REST Python. You can find all the code available in the Python REST wrapper sample.

Например, чтобы создать клиента, необходимо выполнить следующие действия. For example, to create a client:

Чтобы отправить всплывающее уведомление Windows: To send a Windows toast notification:

Реализация Implementation

Если вы еще этого не делали, выполните шаги, описанные в [Учебника по началу работы], до последнего раздела, в котором вам нужно реализовать серверную часть. If you did not already, follow the Get started tutorial up to the last section where you have to implement the back-end.

Подробные сведения о реализации полноценной оболочки REST можно найти в MSDN. All the details to implement a full REST wrapper can be found on MSDN. В этом разделе описана реализация основных действий на языке Python, необходимых для доступа к конечным точкам REST службы «Центры уведомлений» и отправки уведомлений. This section describes the Python implementation of the main steps required to access Notification Hubs REST endpoints and send notifications

1. Проанализируйте строку подключения Parse the connection string
2. Создайте маркер проверки подлинности Generate the authorization token
3. Отправка уведомления с помощью HTTP REST API Send a notification using HTTP REST API

Проанализируйте строку подключения Parse the connection string

Ниже показан основной класс, реализующий клиента, конструктор которого выполняет анализ строки подключения: Here is the main class implementing the client, whose constructor parses the connection string:

Создание маркера безопасности Create security token

Подробные сведения о создании токенов безопасности можно найти здесь. The details of the security token creation are available here. Для создания маркера на основе универсального кода ресурса (URI) текущего запроса и учетных данных, извлеченных из строки подключения, добавьте следующие методы в класс NotificationHub . Add following methods to the NotificationHub class to create the token based on the URI of the current request and the credentials extracted from the connection string.

Отправка уведомления с помощью HTTP REST API Send a notification using HTTP REST API

Сначала следует определить класс, представляющий уведомление. First, let use define a class representing a notification.

Этот класс представляет собой контейнер для собственного текста уведомления либо набор свойств шаблонного уведомления, а также набор заголовков, содержащих свойства формата (собственная платформа или шаблон) и специальные свойства платформы (например, свойство срока действия Apple и заголовки WNS). This class is a container for a native notification body or a set of properties of a template notification, a set of headers, which contains format (native platform or template) and platform-specific properties (like Apple expiration property and WNS headers).

Обратитесь к документации по REST API для службы «Центры уведомлений» и изучите форматы специализированных платформ уведомлений, чтобы узнать обо всех доступных параметрах. Refer to the Notification Hubs REST APIs documentation and the specific notification platforms’ formats for all the options available.

Имея в распоряжении этот класс, запишите методы отправки уведомлений внутри класса NotificationHub . Now with this class, write the send notification methods inside of the NotificationHub class.

Указанные выше методы отправляют запрос HTTP POST к конечной точке «/messages» центра уведомлений с соответствующим текстом и заголовками для отправки уведомления. These methods send an HTTP POST request to the /messages endpoint of your notification hub, with the correct body and headers to send the notification.

Включение подробного ведения журнала с помощью свойства отладки Using debug property to enable detailed logging

Если включить свойство отладки при инициализации центра уведомлений, в журнал будут записаны подробные сведения о дампе запроса и ответа HTTP, а также детальные выходные данные об отправке уведомлений. Enabling debug property while initializing the Notification Hub writes out detailed logging information about the HTTP request and response dump as well as detailed Notification message send outcome. Свойство TestSend службы «Центры уведомлений» возвращает подробные сведения о результатах отправки уведомлений. The Notification Hubs TestSend property returns detailed information about the notification send outcome. Чтобы его использовать, выполните инициализацию с помощью приведенного кода. To use it — initialize using the following code:

В результате к URL-адресу типа HTTP запроса на отправку для концентратора уведомлений прикрепляется строка запроса «test». The Notification Hub Send request HTTP URL gets appended with a «test» query string as a result.

Завершение работы с учебником Complete the tutorial

Теперь вы можете завершить работу с учебником по началу работы, отправив уведомление из серверной части Python. Now you can complete the Get Started tutorial by sending the notification from a Python back-end.

Инициализируйте клиент концентратора уведомлений (замените строку подключения и имя концентратора в соответствии с инструкциями в [Учебника по началу работы]): Initialize your Notification Hubs client (substitute the connection string and hub name as instructed in the Get started tutorial):

Затем добавьте код отправки, определяемый целевой мобильной платформой. Then add the send code depending on your target mobile platform. В этом примере добавлены методы более высокого уровня, чтобы включить отправку уведомлений для определенной платформы, например send_windows_notification (для Windows), send_apple_notification (для Apple) и т. д. This sample also adds higher-level methods to enable sending notifications based on the platform, for example, send_windows_notification for windows; send_apple_notification (for apple) etc.

Магазин Windows и Windows Phone 8.1 (без Silverlight) Windows Store and Windows Phone 8.1 (non-Silverlight)

Windows Phone 8.0 и 8.1 Silverlight Windows Phone 8.0 and 8.1 Silverlight

iOS iOS

Android Android

Kindle Fire Kindle Fire

Baidu Baidu

После выполнения кода Python на целевом устройстве должно отобразиться уведомление. Running your Python code should produce a notification appearing on your target device.

Примеры Examples

Включение свойства debug Enabling the debug property

Если включить флаг отладки во время инициализации центра уведомлений (NotificationHub), вы увидите подробный дамп HTTP-запроса и ответа HTTP наряду с данными NotificationOutcome, которые указывают, какие именно заголовки HTTP переданы в запросе и какой ответ HTTP был получен от центра уведомлений. When you enable the debug flag while initializing the NotificationHub, you see detailed HTTP request and response dump as well as NotificationOutcome like the following where you can understand what HTTP headers are passed in the request and what HTTP response was received from the Notification Hub:

Вы увидите подробный результат центра уведомлений, например сведения о том, You see detailed Notification Hub result for example.

• когда сообщение успешно отправлено в службу push-уведомлений. when the message is successfully sent to the Push Notification Service.
• Если какое-либо push-уведомление не достигло адресата, отобразятся следующие выходные данные (указывающие, что, вероятнее всего, регистрации для доставки уведомлений не были найдены из-за несоответствующих тегов). If there were no targets found for any push notification, then you are likely going to see the following output as the response (which indicates that there were no registrations found to deliver the notification probably because the registrations had some mismatched tags)

Рассылка всплывающих уведомлений для Windows Broadcast toast notification to Windows

Обратите внимание на заголовки, которые отправляются при рассылке всплывающих уведомлений клиенту Windows. Notice the headers that get sent out when you are sending a broadcast toast notification to Windows client.

Отправка уведомления с указанием тега (или регулярного выражения) Send notification specifying a tag (or tag expression)

Обратите внимание на заголовок HTTP Tags, который будет добавлен к HTTP-запросу (в приведенном ниже примере уведомление отправляется только для регистраций с полезными данными «sports»). Notice the Tags HTTP header, which gets added to the HTTP request (in the example below, the notification is sent only to registrations with ‘sports’ payload)

Отправка уведомления с указанием нескольких тегов Send notification specifying multiple tags

Обратите внимание на изменения заголовка Tags HTTP при отправке нескольких тегов. Notice how the Tags HTTP header changes when multiple tags are sent.

Шаблон уведомления Templated notification

Обратите внимание, что происходит изменение заголовка Format HTTP и текст полезных данных отправляется в составе запроса HTTP. Notice that the Format HTTP header changes and the payload body is sent as part of the HTTP request body:

Сторона клиента — зарегистрированный шаблон: Client side — registered template:

Серверная сторона — отправка полезных данных: Server side — sending the payload:

Дальнейшие действия Next Steps

В этой статье рассмотрено создание простого клиента REST Python для службы «Центры уведомлений». This article showed how to create a Python REST client for Notification Hubs. Здесь можно выполнять следующие действия: From here you can:

• Скачать полный [пример программы-оболочки REST Python], содержащий весь код из этой статьи. Download the full Python REST wrapper sample, which contains all the code in this article.
• Продолжение изучения функции добавления тегов для концентраторов уведомлений в [учебнике «экстренные новости] » Continue learning about Notification Hubs tagging feature in the Breaking News tutorial
• Продолжить изучение функции шаблонов центров уведомлений в учебнике по передаче локализованных экстренных новостей Continue learning about Notification Hubs Templates feature in the Localizing News tutorial

—>