Package: utilbox
# UtilBox README> `utilbox` is a collection of Python utility packages to help you save time and avoid writing code for commonlyrequired tasks.The current set of utilities cover the following areas:*   Encryption*   JSON manipulation*   Sending Email*   Number manipulations*   File, directory manipulations*   System interaction*   Spreadsheet (Excel, CSV) manipulation*   String and multi-line text manipulationAn overview of the available packages is tabulated as below.Package | Class | Description--- | --- | ---crypt_utils | CryptUtils | Encrypt data with AES-128/192/256-bit encryptionjson_utils | JsonUtils | Convert data to `JSON` formatted stringmail_utils | MailUtils | Send a plain-text or HTML-formatted email using Python `smtplib` or external mail application (CLI)number_utils | NumberUtils | Perform various operations with numbers and numeric listsos_utils | SysUtils, FileUtils, DirUtils | Manipulate files, directories and interact with the underlying OSspreadsheet_utils | ExcelUtils, CsvUtils | Work with spreadsheets and CSV filesstring_utils | StringUtils, TextUtils | Manipulate strings and multi-line text## Installation### Install using `pip`Make sure you have `pip` installed on your system, and then run:```pip install utilbox```### Install from sources*   Download the [latest release] from `GitHub` and extract it to a temporary location*   Open your terminal and `cd` to the extracted archive directory*   Run `python setup.py install`### DependenciesPackage dependencies are listed in `requirements.txt`.## UsageThe below rule should be applied in general when trying to use a utility class,> from utilbox.*<package_name>* import *<class_name>*For example to use the `FileUtils` class from `os_utils` package,> from utilbox.*os_utils* import *FileUtils*Here are some real-world scenarios where `utilbox` can serve your purposes,### Example 1Let's say you want to fetch only the last line of some text file. To do this,```pythonfrom utilbox.os_utils import FileUtilslast_line = FileUtils.get_file_last_line("path/to/file.ext")print last_line```### Example 2What if you wanted the epoch time? No worries,```pythonfrom utilbox.os_utils import SysUtilsepoch_time = SysUtils.get_epoch_time()print epoch_time```### Example 3You can send an email just as easily,```pythonfrom utilbox.mail_utils import MailUtilssmtp_server = "192.168.0.1"sender_email_id = "someguy@example.com"mailer = MailUtils(smtp_server, sender_email_id)# send a plain-text messagemailer.send_mail_plain("receiver@example2.com", "This is a test mail", sender_email_id, "This message was brought to you by 'utilbox'!")# send an HTML messagemailer.send_mail_plain("receiver@example2.com", "This is a test mail", sender_email_id, "This message was brought to you by <b>'utilbox'<b>!")````utilbox` is being updated constantly, so feel free to send in any suggestions for new features or issues with existing ones. Enjoy!## Release historyRelease history is available in `CHANGELOG.md`.## LicenseSee `LICENSE.txt` for license information.## Author[Jenson Jose]Follow me [@JoseJenson]Send your suggestions / feedback at `jensonjose@live.in`### How to contributeTo contribute, simply:*   Fork the project*   Create your feature branch*   Commit your changes*   Push committed changes to your branch*   If you're happy and you know it, create a new `PULL` request[latest release]: https://github.com/jensonjose/utilbox/releases/latest[Jenson Jose]: https://www.jensonjose.com[@JoseJenson]: https://twitter.com/JoseJenson