txtwrap 1.2.0__tar.gz → 2.1.0__tar.gz

txtwrap-2.1.0/PKG-INFO

@@ -0,0 +1,292 @@
+Metadata-Version: 2.1
+Name: txtwrap
+Version: 2.1.0
+Summary: A simple text wrapping tool.
+Author: azzammuhyala
+Author-email: azzammuhyala@gmail.com
+License: MIT
+Keywords: wrap,wrapper,wrapping,wrapped,wrapping tool,text wrap,text wrapper,simple wrap,align,aligner,aligning,aligned
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.3
+Description-Content-Type: text/markdown
+
+# TxTWrap🔡
+A tool for wrapping a text.🔨
+
+## All constants, functions, and classes❕
+- `LOREM_IPSUM_WORDS`
+- `LOREM_IPSUM_SENTENCES`
+- `LOREM_IPSUM_PARAGRAPHS`
+- `TextWrapper` (Updated)
+- `mono`
+- `word` (Updated)
+- `wrap` (Updated)
+- `align` (Updated)
+- `fillstr` (Updated)
+- `printwrap` (Updated)
+- `indent`
+- `dedent`
+- `shorten` (Updated)
+
+## Documents📄
+
+### Wrapper📦
+```py
+class TextWrapper:
+
+    def __init__(
+
+        self,
+        width: Union[int, float] = 70,
+        start: SupportsIndex = 0,
+        linegap: Union[int, float] = 0,
+        method: Literal['mono', 'word'] = 'word',
+        alignment: Literal['left', 'center', 'right', 'fill',
+                           'fill-left', 'fill-center', 'fill-right'] = 'left',
+        fillchar: str = ' ',
+        placeholder: str = '...',
+        prefix: Optional[str] = None,
+        separator: Optional[str] = None,
+        preserve_empty: bool = True,
+        use_minimum_width: bool = True,
+        justify_last_line: bool = False,
+        break_on_hyphens: bool = True,
+        sizefunc: Callable[[str], Tuple[Union[int, float],
+                                        Union[int, float]]] = lambda s : (len(s), 1),
+        predicate: Callable[[str], bool] = lambda line: line.strip()
+
+    ) -> None
+```
+
+> **width** : _int | float_
+=> The maximum width of the wrapped line. Default: 70.
+
+> **start** : _SupportsIndex_
+=> The starting index of the text (specific to the shorten method). Default: 0.
+
+> **linegap** : _int | float_
+=> The gap between lines (specific to the align method). Default: 0.
+
+> **method** : _Literal['mono', 'word']_
+=> The text wrapping method. Default: 'word'.
+
+> **alignment** : _Literal['left', 'center', 'right', 'fill',
+'fill-left', 'fill-center', 'fill-right']_
+=> The text alignment (specific to align and fillstr method). Default: 'left'.
+
+> **fillchar** : _str_
+=> The character used for padding. Default: ' '.
+
+> **placeholder** : _str_
+=> The placeholder used when shortening text (specific to the shorten method). Default: '...'.
+
+> **prefix** : _Optional[str]_
+=> A prefix to add or remove (for the indent method, it must be a string and will be added at the
+beginning of each line. For dedent, it is optional and removes the prefix from the beginning of each
+line). Default: None.
+
+> **separator** : _Optional[str]_
+=> The separator used between words. Default: None.
+
+> **preserve_empty** : _bool_
+=> Whether to retain empty lines. Default: True.
+
+> **use_minimum_width** : _bool_
+=> Whether to use the minimum detected width (specific to the align and fillstr methods).
+Default: True.
+
+> **justify_last_line** : _bool_
+=> Whether to adjust the alignment of the last line (applies to align and fillstr methods, but only
+for non-wrapped text and only for fill alignment). Default: False.
+
+> **break_on_hyphens** : _bool_
+=> Whether to allow breaking words at hyphens (-) (specific to align and fillstr methods).
+Default: True.
+
+> **sizefunc** : _(str) -> tuple[int | float, int | float]_
+=> A function to calculate the width and height of the text. The default is a lambda function
+returning the text length as width and 1 as height.
+
+> **predicate** : _(str) -> bool_
+=> A function to filter lines (specific to indent and dedent methods). The default is a lambda
+function that trims empty lines from the left and right.
+
+### Mod📦 `python -m txtwrap`
+```
+usage: txtwrap [-h] [-v] [-w <int>] [-s <int>] [-m {word|mono|indent|dedent|shorten}]
+               [-a {left|center|right|fill|fill-left|fill-center|fill-right}] [-f <str>] [-p <str>]
+               [-x <str>] [-r <str>] [-n] [-i] [-j] [-b] text
+
+Command-line tool for wrapping, aligning, or shortening text.
+
+positional arguments:
+  text                  Target text
+
+options:
+  -h, --help            show this help message and exit
+  -v, --version         Show the version of the txtwrap
+  -w <int>, --width <int>
+                        Width of the text wrapping (default: current width terminal or 70)
+  -s <int>, --start <int>
+                        start index of the text to be shorten (default: 0)
+  -m {word|mono|indent|dedent|shorten}, --method {word|mono|indent|dedent|shorten}
+                        Method to be applied to the text (default: "word")
+  -a {left|center|right|fill|fill-left|fill-center|fill-right},
+  --alignment {left|center|right|fill|fill-left|fill-center|fill-right}
+                        Alignment of the text (default: "left")
+  -f <str>, --fillchar <str>
+                        Fill character (default: " ")
+  -p <str>, --placeholder <str>
+                        Placeholder to be used when shortening the text (default: "...")
+  -x <str>, --prefix <str>
+                        Prefix to be added (indent) or remove (dedent) to the text
+  -r <str>, --separator <str>
+                        The separator used between words
+  -n, --neglect-empty   Neglect empty lines in the text
+  -i, --use-minimum-width
+                        Whether to use the minimum detected width
+  -j, --justify-last-line
+                        Whether to adjust the alignment of the last line
+  -b, --not-break-on-hyphens
+                        Doesn't break on hyphens
+
+for example: python|py -m txtwrap "Lorem ipsum odor amet, consectetuer adipiscing elit." -w 20 `
+             -m word -a center
+```
+
+## Examples❓
+
+### Render a wrap text in PyGame🎮
+```py
+from typing import Literal, Optional
+from txtwrap import align, LOREM_IPSUM_PARAGRAPHS
+import pygame
+
+def render_wrap(
+
+    font: pygame.Font,
+    text: str,
+    width: int,
+    antialias: bool,
+    color: pygame.Color,
+    background: Optional[pygame.Color] = None,
+    linegap: int = 0,
+    method: Literal['word', 'mono'] = 'word',
+    alignment: Literal['left', 'center', 'right', 'fill',
+                       'fill-left', 'fill-center', 'fill-right'] = 'left',
+    preserve_empty: bool = True,
+    use_minimum_width: bool = True,
+    justify_last_line: bool = False,
+    break_on_hyphens: bool = True
+
+) -> pygame.Surface:
+
+    align_info = align(
+        text=text,
+        width=width,
+        linegap=linegap,
+        method=method,
+        alignment=alignment,
+        preserve_empty=preserve_empty,
+        use_minimum_width=use_minimum_width,
+        justify_last_line=justify_last_line,
+        break_on_hyphens=break_on_hyphens,
+        return_details=True,
+        sizefunc=font.size
+    )
+
+    surface = pygame.Surface(align_info['size'], pygame.SRCALPHA)
+
+    if background is not None:
+        surface.fill(background)
+
+    for x, y, text in align_info['aligned']:
+        surface.blit(font.render(text, antialias, color), (x, y))
+
+    return surface
+
+# Example usage:
+pygame.init()
+pygame.display.set_caption("Lorem Ipsum")
+
+running = True
+width, height = 800, 600
+screen = pygame.display.set_mode((width, height))
+clock = pygame.time.Clock()
+
+surface = render_wrap(
+    font=pygame.font.SysFont('Arial', 18),
+    text=LOREM_IPSUM_PARAGRAPHS,
+    width=width,
+    antialias=True,
+    color='#ffffff',
+    background='#303030',
+    alignment='fill'
+)
+
+wsurf, hsurf = surface.get_size()
+pos = ((width - wsurf) / 2, (height - hsurf) / 2)
+
+while running:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+    screen.fill('#000000')
+    screen.blit(surface, pos)
+    pygame.display.flip()
+    clock.tick(60)
+```
+
+### Print a wrap text to terminal🔡
+```py
+from txtwrap import printwrap, LOREM_IPSUM_WORDS
+
+width = 20
+
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='left')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='center')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='right')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill') # or alignment='fill-left'
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill-center')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill-right')
+```
+
+### Short a long text🔤
+```py
+from txtwrap import shorten, LOREM_IPSUM_SENTENCES
+
+print(shorten(LOREM_IPSUM_SENTENCES, width=20, placeholder='…'))
+```
+
+### Bonus🎁 - Print a colorfull text to terminal🔥
+```py
+# Run this code in a terminal that supports ansi characters
+
+from re import compile
+from random import randint
+from txtwrap import printwrap, LOREM_IPSUM_PARAGRAPHS
+
+# Set the text to be printed here
+text = LOREM_IPSUM_PARAGRAPHS
+
+remove_ansi_regex = compile(r'\x1b\[(K|.*?m)').sub
+
+def len_no_ansi(s: str):
+    return len(remove_ansi_regex('', s))
+
+while True:
+    printwrap(
+        ''.join(f'\x1b[{randint(31, 36)}m{char}' for char in text) + '\x1b[0m',
+        end='\x1b[H\x1b[J',
+        alignment='fill',
+        lenfunc=len_no_ansi
+    )
+```

txtwrap-2.1.0/README.md

@@ -0,0 +1,277 @@
+# TxTWrap🔡
+A tool for wrapping a text.🔨
+
+## All constants, functions, and classes❕
+- `LOREM_IPSUM_WORDS`
+- `LOREM_IPSUM_SENTENCES`
+- `LOREM_IPSUM_PARAGRAPHS`
+- `TextWrapper` (Updated)
+- `mono`
+- `word` (Updated)
+- `wrap` (Updated)
+- `align` (Updated)
+- `fillstr` (Updated)
+- `printwrap` (Updated)
+- `indent`
+- `dedent`
+- `shorten` (Updated)
+
+## Documents📄
+
+### Wrapper📦
+```py
+class TextWrapper:
+
+    def __init__(
+
+        self,
+        width: Union[int, float] = 70,
+        start: SupportsIndex = 0,
+        linegap: Union[int, float] = 0,
+        method: Literal['mono', 'word'] = 'word',
+        alignment: Literal['left', 'center', 'right', 'fill',
+                           'fill-left', 'fill-center', 'fill-right'] = 'left',
+        fillchar: str = ' ',
+        placeholder: str = '...',
+        prefix: Optional[str] = None,
+        separator: Optional[str] = None,
+        preserve_empty: bool = True,
+        use_minimum_width: bool = True,
+        justify_last_line: bool = False,
+        break_on_hyphens: bool = True,
+        sizefunc: Callable[[str], Tuple[Union[int, float],
+                                        Union[int, float]]] = lambda s : (len(s), 1),
+        predicate: Callable[[str], bool] = lambda line: line.strip()
+
+    ) -> None
+```
+
+> **width** : _int | float_
+=> The maximum width of the wrapped line. Default: 70.
+
+> **start** : _SupportsIndex_
+=> The starting index of the text (specific to the shorten method). Default: 0.
+
+> **linegap** : _int | float_
+=> The gap between lines (specific to the align method). Default: 0.
+
+> **method** : _Literal['mono', 'word']_
+=> The text wrapping method. Default: 'word'.
+
+> **alignment** : _Literal['left', 'center', 'right', 'fill',
+'fill-left', 'fill-center', 'fill-right']_
+=> The text alignment (specific to align and fillstr method). Default: 'left'.
+
+> **fillchar** : _str_
+=> The character used for padding. Default: ' '.
+
+> **placeholder** : _str_
+=> The placeholder used when shortening text (specific to the shorten method). Default: '...'.
+
+> **prefix** : _Optional[str]_
+=> A prefix to add or remove (for the indent method, it must be a string and will be added at the
+beginning of each line. For dedent, it is optional and removes the prefix from the beginning of each
+line). Default: None.
+
+> **separator** : _Optional[str]_
+=> The separator used between words. Default: None.
+
+> **preserve_empty** : _bool_
+=> Whether to retain empty lines. Default: True.
+
+> **use_minimum_width** : _bool_
+=> Whether to use the minimum detected width (specific to the align and fillstr methods).
+Default: True.
+
+> **justify_last_line** : _bool_
+=> Whether to adjust the alignment of the last line (applies to align and fillstr methods, but only
+for non-wrapped text and only for fill alignment). Default: False.
+
+> **break_on_hyphens** : _bool_
+=> Whether to allow breaking words at hyphens (-) (specific to align and fillstr methods).
+Default: True.
+
+> **sizefunc** : _(str) -> tuple[int | float, int | float]_
+=> A function to calculate the width and height of the text. The default is a lambda function
+returning the text length as width and 1 as height.
+
+> **predicate** : _(str) -> bool_
+=> A function to filter lines (specific to indent and dedent methods). The default is a lambda
+function that trims empty lines from the left and right.
+
+### Mod📦 `python -m txtwrap`
+```
+usage: txtwrap [-h] [-v] [-w <int>] [-s <int>] [-m {word|mono|indent|dedent|shorten}]
+               [-a {left|center|right|fill|fill-left|fill-center|fill-right}] [-f <str>] [-p <str>]
+               [-x <str>] [-r <str>] [-n] [-i] [-j] [-b] text
+
+Command-line tool for wrapping, aligning, or shortening text.
+
+positional arguments:
+  text                  Target text
+
+options:
+  -h, --help            show this help message and exit
+  -v, --version         Show the version of the txtwrap
+  -w <int>, --width <int>
+                        Width of the text wrapping (default: current width terminal or 70)
+  -s <int>, --start <int>
+                        start index of the text to be shorten (default: 0)
+  -m {word|mono|indent|dedent|shorten}, --method {word|mono|indent|dedent|shorten}
+                        Method to be applied to the text (default: "word")
+  -a {left|center|right|fill|fill-left|fill-center|fill-right},
+  --alignment {left|center|right|fill|fill-left|fill-center|fill-right}
+                        Alignment of the text (default: "left")
+  -f <str>, --fillchar <str>
+                        Fill character (default: " ")
+  -p <str>, --placeholder <str>
+                        Placeholder to be used when shortening the text (default: "...")
+  -x <str>, --prefix <str>
+                        Prefix to be added (indent) or remove (dedent) to the text
+  -r <str>, --separator <str>
+                        The separator used between words
+  -n, --neglect-empty   Neglect empty lines in the text
+  -i, --use-minimum-width
+                        Whether to use the minimum detected width
+  -j, --justify-last-line
+                        Whether to adjust the alignment of the last line
+  -b, --not-break-on-hyphens
+                        Doesn't break on hyphens
+
+for example: python|py -m txtwrap "Lorem ipsum odor amet, consectetuer adipiscing elit." -w 20 `
+             -m word -a center
+```
+
+## Examples❓
+
+### Render a wrap text in PyGame🎮
+```py
+from typing import Literal, Optional
+from txtwrap import align, LOREM_IPSUM_PARAGRAPHS
+import pygame
+
+def render_wrap(
+
+    font: pygame.Font,
+    text: str,
+    width: int,
+    antialias: bool,
+    color: pygame.Color,
+    background: Optional[pygame.Color] = None,
+    linegap: int = 0,
+    method: Literal['word', 'mono'] = 'word',
+    alignment: Literal['left', 'center', 'right', 'fill',
+                       'fill-left', 'fill-center', 'fill-right'] = 'left',
+    preserve_empty: bool = True,
+    use_minimum_width: bool = True,
+    justify_last_line: bool = False,
+    break_on_hyphens: bool = True
+
+) -> pygame.Surface:
+
+    align_info = align(
+        text=text,
+        width=width,
+        linegap=linegap,
+        method=method,
+        alignment=alignment,
+        preserve_empty=preserve_empty,
+        use_minimum_width=use_minimum_width,
+        justify_last_line=justify_last_line,
+        break_on_hyphens=break_on_hyphens,
+        return_details=True,
+        sizefunc=font.size
+    )
+
+    surface = pygame.Surface(align_info['size'], pygame.SRCALPHA)
+
+    if background is not None:
+        surface.fill(background)
+
+    for x, y, text in align_info['aligned']:
+        surface.blit(font.render(text, antialias, color), (x, y))
+
+    return surface
+
+# Example usage:
+pygame.init()
+pygame.display.set_caption("Lorem Ipsum")
+
+running = True
+width, height = 800, 600
+screen = pygame.display.set_mode((width, height))
+clock = pygame.time.Clock()
+
+surface = render_wrap(
+    font=pygame.font.SysFont('Arial', 18),
+    text=LOREM_IPSUM_PARAGRAPHS,
+    width=width,
+    antialias=True,
+    color='#ffffff',
+    background='#303030',
+    alignment='fill'
+)
+
+wsurf, hsurf = surface.get_size()
+pos = ((width - wsurf) / 2, (height - hsurf) / 2)
+
+while running:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
+    screen.fill('#000000')
+    screen.blit(surface, pos)
+    pygame.display.flip()
+    clock.tick(60)
+```
+
+### Print a wrap text to terminal🔡
+```py
+from txtwrap import printwrap, LOREM_IPSUM_WORDS
+
+width = 20
+
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='left')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='center')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='right')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill') # or alignment='fill-left'
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill-center')
+print('=' * width)
+printwrap(LOREM_IPSUM_WORDS, width=width, alignment='fill-right')
+```
+
+### Short a long text🔤
+```py
+from txtwrap import shorten, LOREM_IPSUM_SENTENCES
+
+print(shorten(LOREM_IPSUM_SENTENCES, width=20, placeholder='…'))
+```
+
+### Bonus🎁 - Print a colorfull text to terminal🔥
+```py
+# Run this code in a terminal that supports ansi characters
+
+from re import compile
+from random import randint
+from txtwrap import printwrap, LOREM_IPSUM_PARAGRAPHS
+
+# Set the text to be printed here
+text = LOREM_IPSUM_PARAGRAPHS
+
+remove_ansi_regex = compile(r'\x1b\[(K|.*?m)').sub
+
+def len_no_ansi(s: str):
+    return len(remove_ansi_regex('', s))
+
+while True:
+    printwrap(
+        ''.join(f'\x1b[{randint(31, 36)}m{char}' for char in text) + '\x1b[0m',
+        end='\x1b[H\x1b[J',
+        alignment='fill',
+        lenfunc=len_no_ansi
+    )
+```

{txtwrap-1.2.0 → txtwrap-2.1.0}/setup.py

@@ -5,21 +5,22 @@ with open('README.md', encoding='utf-8') as readme:
 
 setup(
     name='txtwrap',
-    version='1.2.0',
+    version='2.1.0',
     description='A simple text wrapping tool.',
     long_description=long_description,
     long_description_content_type='text/markdown',
     author='azzammuhyala',
+    author_email='azzammuhyala@gmail.com',
     license='MIT',
-    python_requires='>=3.8',
+    python_requires='>=3.3',
     packages=find_packages(),
     include_package_data=True,
     keywords=['wrap', 'wrapper', 'wrapping', 'wrapped', 'wrapping tool', 'text wrap',
               'text wrapper', 'simple wrap', 'align', 'aligner', 'aligning', 'aligned'],
     classifiers=[
         'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.3',
         'Topic :: Software Development :: Libraries :: Python Modules',
-        'License :: OSI Approved :: MIT License',
+        'License :: OSI Approved :: MIT License'
     ]
 )

{txtwrap-1.2.0 → txtwrap-2.1.0}/txtwrap/__init__.py

@@ -1,12 +1,13 @@
 """
-A simple text wrapping tool
+A simple text wrapping tool.
 """
 
-# Supports only in Python 3.8+
+# Supports only in Python 3.3+
 
 from .txtwrap import (
     version,
     LOREM_IPSUM_WORDS, LOREM_IPSUM_SENTENCES, LOREM_IPSUM_PARAGRAPHS,
+    TextWrapper,
     mono, word, wrap, align, fillstr, printwrap,
     indent, dedent,
     shorten
@@ -19,6 +20,7 @@ __all__ = [
     'LOREM_IPSUM_WORDS',
     'LOREM_IPSUM_SENTENCES',
     'LOREM_IPSUM_PARAGRAPHS',
+    'TextWrapper',
     'mono',
     'word',
     'wrap',