enhanced-print 0.1.0
An enhanced print function for Python with advanced features.
Requires Python: >=3.6

# Enhanced Print Library

## Introduction

This library provides an enhanced `eprint` function for Python, offering a wide range of features to make your print statements more powerful, informative, and visually appealing. From basic styling and coloring to advanced debugging aids and structured data output, `eprint` aims to simplify your development and debugging workflows.

## Features

`eprint` offers a comprehensive set of features, including but not limited to:

### Basic Formatting
- **Colors**: Apply foreground colors to your text (e.g., red, green, blue).
- **Background Colors**: Set background colors for your text.
- **Styles**: Apply text styles like bold, italic, underline, strikethrough, and reverse.

### Layout and Presentation
- **Alignment**: Align text to left, right, or center within a specified width.
- **Padding**: Add padding around your text.
- **Borders**: Enclose your text within single or double line borders.
- **Boxing**: Create a simple box around your text.

### Debugging and Contextual Information
- **Variable Name Display**: Automatically print the name of the variable along with its value.
- **Expression Evaluation**: Evaluate and display the result of a given expression.
- **Timestamp**: Include a timestamp with each print statement.
- **Line Information**: Show the filename and line number where `eprint` was called.
- **Function Name**: Display the name of the function from which `eprint` was called.
- **Thread Information**: Include the current thread's name and ID.
- **Process ID**: Show the process ID.
- **Hostname**: Display the hostname.
- **Username**: Show the current username.
- **Application Name**: Add a custom application name to the output.

### Advanced Data Output
- **Pretty Printing**: Format complex data structures (dictionaries, lists) for better readability.
- **Type Information**: Display the data type of each argument.
- **JSON Formatting**: Output data as a formatted JSON string.
- **XML Formatting**: Output data as an XML string.
- **YAML Formatting**: Output data as a YAML string.

### Logging
- **File Logging**: Redirect `eprint` output to a specified log file.
- **Log Levels**: Assign different log levels (INFO, WARNING, ERROR, DEBUG, CRITICAL) to your messages.
- **Custom Log Formatters**: Define custom formats for your log file output.

## Installation

Currently, this library is not available on PyPI. You can install it by cloning the repository and installing it locally:

```bash
git clone [REPOSITORY_URL]
cd enhanced_print_lib
pip install .
```

## Usage

To use the `eprint` function, simply import it from the `enhanced_print` module:

```python
from enhanced_print.eprint import eprint

# Basic usage
eprint("Hello, World!")

# With colors and styles
eprint("This is a bold red message.", color="red", style="bold")

# With alignment and borders
eprint("Centered text with a border", align="center", width=50, border="double")

# Debugging variables
my_variable = 42
eprint(my_variable, var_name=True)

# Pretty printing a dictionary
my_dict = {"name": "Alice", "age": 30, "city": "New York"}
eprint(my_dict, pretty=True)

# Logging to a file
eprint("This message goes to the log file.", log_file="my_app.log", log_level="INFO")
```

For more detailed examples and a complete list of parameters, please refer to the source code and the example usage within `eprint.py`.

## Contributing

Contributions are welcome! Please feel free to submit issues or pull requests on the GitHub repository.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Author

Manus AI