Skip to main content

Collection of utility packages for Python.

Project description

# UtilBox README

> `utilbox` is a collection of Python utility packages to help you save time and avoid writing code for commonly
required 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 manipulation

An overview of the available packages is tabulated as below.

Package | Class | Description
--- | --- | ---
crypt_utils | CryptUtils | Encrypt data with AES-128/192/256-bit encryption
json_utils | JsonUtils | Convert data to `JSON` formatted string
mail_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 lists
os_utils | SysUtils, FileUtils, DirUtils | Manipulate files, directories and interact with the underlying OS
spreadsheet_utils | ExcelUtils, CsvUtils | Work with spreadsheets and CSV files
string_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 install`

### Dependencies

Package dependencies are listed in `requirements.txt`.

## Usage

The 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 1
Let's say you want to fetch only the last line of some text file. To do this,

from utilbox.os_utils import FileUtils

last_line = FileUtils.get_file_last_line("path/to/file.ext")
print last_line

### Example 2
What if you wanted the epoch time? No worries,

from utilbox.os_utils import SysUtils

epoch_time = SysUtils.get_epoch_time()
print epoch_time

### Example 3
You can send an email just as easily,

from utilbox.mail_utils import MailUtils

smtp_server = ""
sender_email_id = ""

mailer = MailUtils(smtp_server, sender_email_id)

# send a plain-text message
mailer.send_mail_plain("", "This is a test mail", sender_email_id, "This message was brought to you by 'utilbox'!")

# send an HTML message
mailer.send_mail_plain("", "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 history

Release history is available in ``.

## License

See `LICENSE.txt` for license information.

## Author

[Jenson Jose]
Follow me [@JoseJenson]
Send your suggestions / feedback at ``

### How to contribute

To 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]:
[Jenson Jose]:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

utilbox-0.1.6.tar.gz (17.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page