Textlinebreaker

Description

Text Line Breaker is a Python script that takes a string of text and breaks it into lines of a specified maximum width. This tool is particularly useful for formatting and displaying text in a terminal.

Features

• Split text lines to fit within a specified maximum width.
• Choose alignment options for the text (left, center, right).
• Adjust the maximum width (default value is the terminal width).

Latest Version 0.2.0

• Added new parameters ("min", "2words", "max") to set different lines width.
• Improved algorithm to better split the input in the desired lenght lines.

Table of Contents

• Getting Started
  • Prerequisites
  • Installation
• Usage
  • Parameters
  • Examples
• Contributing
• License

Getting Started

Prerequisites

This script relies on the Python standard library and does not require any additional dependencies.

Installation

• Install the package with pip

  pip install textlinebreaker

• or upgrade it with

  pip install --upgrade textlinebreaker

• Import the package in your program

  from textlinebreaker import split_line

Usage

This function takes a long string of text as input and breaks it into lines according to the specified maximum width. The default length is the width of the terminal.

Parameters

The split_line function accepts the following parameters:

• line: is the main argument, it's the text that needs to be broken down.
  • allowed values: strings, list of strings
• max_width: allows to set the max length of text on a line.
  • allowed values: integers, "min", "2words", "max"
  • default value = "max" (terminal width)
• alignment: allows to change the alignment of the text inside the frame.
  • allowed values: "left", "centre", "center", "right"
  • default value = "left"

Examples

Here's an example of how to use the split_line function:

from textlinebreaker import split_line

text = "This is an example of text line breaking using the Text Line Breaker script."
lines = split_line(text, max_width=30, alignment="center")

for line in lines:
  print(line)

Output:

 This is an example of text 
line breaking using the Text 
    Line Breaker script.     

Contributing

If you'd like to contribute to this project, please follow these steps:

1. Fork the repository on GitHub.
2. Clone the fork to your local machine.
3. Create a new branch for your feature or bug fix.
4. Make your changes and commit them.
5. Push the changes to your fork on GitHub.
6. Create a pull request to the original repository.

License

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