Updated imap (markdown)

This commit is contained in:
Luke Bonham 2014-01-20 09:52:35 -08:00
parent 41d28b93eb
commit dd10cac130
1 changed files with 14 additions and 4 deletions

18
imap.md
View File

@ -31,16 +31,26 @@ Variable | Meaning | Type | Default
Let's focus better on `is_plain`.
You can just set your password like this:
The reason why it's false by default is to discourage the habit of storing passwords in plain files.
args.is_plain = false
args.password = "mypassword"
You can set your password in plain like this:
myimapcheck = lain.widgets.imap({
is_plain = true,
password = "myplainpassword",
[...]
})
and you'll have the same security provided by `~/.netrc`.
**Or** you can use a keyring, like [python keyring](https://pypi.python.org/pypi/keyring):
args.password = "keyring get password"
myimapcheck = lain.widgets.imap({
is_plain = true,
password = "myplainpassword",
server = "mail.autistici.org",
mail = "dada@anche.no",
})
When `is_plain == false`, it *executes* `password` before using it, so you can also use whatever password fetching solution you want.