mirror of
https://github.com/markqvist/Sideband.git
synced 2024-10-01 03:15:37 -04:00
59 lines
1.4 KiB
Python
59 lines
1.4 KiB
Python
|
'''
|
||
|
Email
|
||
|
=====
|
||
|
|
||
|
The :class:`Email` provides access to public methods to use email of your
|
||
|
device.
|
||
|
|
||
|
.. note::
|
||
|
On Android `INTERNET` permission is needed.
|
||
|
|
||
|
Simple Examples
|
||
|
---------------
|
||
|
|
||
|
To send an e-mail::
|
||
|
|
||
|
>>> from plyer import email
|
||
|
>>> recipient = 'abc@gmail.com'
|
||
|
>>> subject = 'Hi'
|
||
|
>>> text = 'This is an example.'
|
||
|
>>> create_chooser = False
|
||
|
>>> email.send(recipient=recipient, subject=subject, text=text,
|
||
|
create_chooser=create_chooser)
|
||
|
|
||
|
>>> # opens email interface where user can change the content.
|
||
|
|
||
|
Supported Platforms
|
||
|
-------------------
|
||
|
Android, iOS, Windows, OS X, Linux
|
||
|
|
||
|
'''
|
||
|
|
||
|
|
||
|
class Email:
|
||
|
'''
|
||
|
Email facade.
|
||
|
'''
|
||
|
|
||
|
def send(self, recipient=None, subject=None, text=None,
|
||
|
create_chooser=None):
|
||
|
'''
|
||
|
Open an email client message send window, prepopulated with the
|
||
|
given arguments.
|
||
|
|
||
|
:param recipient: Recipient of the message (str)
|
||
|
:param subject: Subject of the message (str)
|
||
|
:param text: Main body of the message (str)
|
||
|
:param create_chooser: Whether to display a program chooser to
|
||
|
handle the message (bool)
|
||
|
|
||
|
.. note:: create_chooser is only supported on Android
|
||
|
'''
|
||
|
self._send(recipient=recipient, subject=subject, text=text,
|
||
|
create_chooser=create_chooser)
|
||
|
|
||
|
# private
|
||
|
|
||
|
def _send(self, **kwargs):
|
||
|
raise NotImplementedError()
|