#mensagem

Elixir command line app that prints out various kinds of messages.

At the moment, it prints out random quotes, like the Unix fortune app, and reminders.

In the future, I hope to make it easy for other users to extend it, so that they can print out any kind of message.

###Install

Download mensagem, change to the mensagem directory and run the following commands:

mix deps.get
mix escript.build

###Use

Once you have built the script, it is treated like any other executable. On Linux and Mac OS, you can run it with ./mensagem. On Windows, you need to type escript mensagem.

At the moment, mensagem (with no arguments) prints out random quotes and reminders. The -q option will just print out quotes and the -r option will just print out the reminders.

The quotes are stored in the lib/mensagem/quotes directory. These are text files which are formatted just like the text files that the fortune program uses. So if you install fortune-mod, or fortune, you can copy the text files in the package to the quotes directory and Mensagem will be able to read them.

To add reminders, use the -a option, as in the examples below:

mensagem -a 10/12 "Feed the pet tiger."

mensagem -a 2016/7/12 "Greet the wife."

mensagem -a 9/12 "Go to work." 3

The date needs to be formatted either Month/Day or Year/Month/Day. If you write just the month and the date, Mensagem will assume that the reminder is for this year, or next year if the date is already passed. If you write the year, the year must be written with four digits.

In the last example above, the number 3 indicates that mensagem should start showing this message three days in advance -- from 9 Sep to 12 Sep.

###Status

Pre-alpha.

####Author

This program has been developed by David Whitlock.

####License

Mensagem is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.