| # |
| # Copyright (C) 2016 The Android Open Source Project |
| # |
| # Licensed under the Apache License, Version 2.0 (the "License"); |
| # you may not use this file except in compliance with the License. |
| # You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, software |
| # distributed under the License is distributed on an "AS IS" BASIS, |
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| # See the License for the specific language governing permissions and |
| # limitations under the License. |
| # |
| """Defines API for presenting desktop notifications.""" |
| from __future__ import absolute_import |
| |
| import subprocess |
| from typing import Optional |
| |
| |
| def toast(subject: str, body: Optional[str] = None) -> None: |
| """Presents a brief popup notification. |
| |
| Currently this is only implemented for systems with libnotify-bin installed |
| (Ubuntu seems to have this by default). If not present, the function simply |
| does nothing. |
| |
| Args: |
| subject: Subject text to display. |
| body: Optional additional text to display. |
| """ |
| try: |
| args = ['notify-send', subject] |
| if body is not None: |
| args.append(body) |
| subprocess.call(args) |
| except OSError: |
| pass |