lkj 0.1.44__py3-none-any.whl → 0.1.45__py3-none-any.whl

{lkj-0.1.44.dist-info → lkj-0.1.45.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lkj
-Version: 0.1.44
+Version: 0.1.45
 Summary: A dump of homeless useful utils
 Home-page: https://github.com/thorwhalen/lkj
 Author: Thor Whalen
@@ -167,3 +167,103 @@ import_object(dot_path: str)
 >>> f is join
 True
 ```
+
+## Pretty Printing Lists
+
+The `print_list` function provides flexible, human-friendly ways to display lists and collections. It supports multiple display styles and can be used in several ways.
+
+### Basic Usage
+
+```python
+from lkj.strings import print_list
+
+items = ['apple', 'banana', 'cherry', 'date', 'elderberry', 'fig']
+
+# Different display styles
+print_list(items, style='wrapped')      # Automatic line wrapping
+print_list(items, style='columns')      # Column format
+print_list(items, style='numbered')     # Numbered list
+print_list(items, style='bullet')       # Bullet points
+print_list(items, style='compact')      # All on one line
+print_list(items, style='table')        # Table format
+```
+
+### Direct Usage with Customization
+
+```python
+# Customize width, separators, and formatting
+print_list(items, style='wrapped', max_width=40, sep=' | ')
+print_list(items, style='columns', items_per_line=3)
+print_list(items, style='numbered', line_prefix='  ')
+print_list(items, style='bullet', show_count=False)
+
+# Return string instead of printing
+result = print_list(items, style='numbered', print_func=None)
+print(result)
+```
+
+### Partial Function Factory
+
+When you don't specify the `items` parameter, `print_list` returns a partial function that you can reuse:
+
+```python
+# Create specialized printers
+numbered_printer = print_list(style='numbered', show_count=False)
+bullet_printer = print_list(style='bullet', print_func=None)
+compact_printer = print_list(style='compact', max_width=60)
+
+# Reuse with different data
+numbered_printer(['a', 'b', 'c'])        # Prints: 1. a\n2. b\n3. c
+result = bullet_printer(['x', 'y', 'z']) # Returns: '• x\n• y\n• z'
+compact_printer(['item1', 'item2'])      # Prints: item1, item2
+```
+
+### Convenience Methods
+
+The `print_list` object provides convenient pre-configured methods:
+
+```python
+# Quick access to common styles
+print_list.compact(items)    # Compact format, no count
+print_list.wrapped(items)    # Wrapped format, no count  
+print_list.columns(items)    # Column format, no count
+print_list.numbered(items)   # Numbered format, no count
+print_list.bullets(items)    # Bullet format, no count
+
+# Specialized methods
+print_list.as_table(data)    # Table with headers
+print_list.summary(items)    # Summary for long lists
+```
+
+### Advanced Examples
+
+```python
+# Table with custom data
+data = [['Name', 'Age', 'City'], ['Alice', 25, 'NYC'], ['Bob', 30, 'LA']]
+print_list.as_table(data)
+
+# Summary for long lists
+long_list = list(range(100))
+print_list.summary(long_list, max_items=6)  # Shows: [0, 1, 2, ..., 97, 98, 99]
+
+# Custom print function (e.g., for logging)
+def my_logger(msg):
+    print(f"[LOG] {msg}")
+
+print_list(items, style='bullet', print_func=my_logger)
+
+# Combine partial with custom parameters
+custom_compact = print_list(style='compact', sep=' | ')
+custom_compact(items)  # Prints: apple | banana | cherry | date | elderberry | fig
+```
+
+### Key Features
+
+- **Multiple Styles**: `wrapped`, `columns`, `numbered`, `bullet`, `compact`, `table`
+- **Flexible Output**: Print directly or return strings with `print_func=None`
+- **Partial Functions**: Create reusable printers with pre-configured settings
+- **Customizable**: Control width, separators, line prefixes, and more
+- **Type Safe**: Uses `Literal` types for style validation
+- **Self-Contained**: No external dependencies beyond Python standard library
+
+The `print_list` function is perfect for debugging, logging, user interfaces, and any situation where you need to display lists in a readable format.

{lkj-0.1.44.dist-info → lkj-0.1.45.dist-info}/RECORD

@@ -8,8 +8,8 @@ lkj/iterables.py,sha256=9jeO36w-IGiZryge7JKgXZOGZAgehUvhwKV3nHPcZWk,2801
 lkj/loggers.py,sha256=ImmBdacz89Lvb3dg_xI5jOct_44rSRv0hNI_CVehy60,13706
 lkj/misc.py,sha256=IZf05tkl0cgiMgBwCMH5cLSC59fRXwnemPRo8G0OxQg,1436
 lkj/strings.py,sha256=aib3KLFBuHl2WuDI2m7xC2JXM9E2-fk9CkXU7Pld6VU,41459
-lkj-0.1.44.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-lkj-0.1.44.dist-info/METADATA,sha256=UIL9HF85Q1yjtn_UCjmh7LYpRv_XDEJHvVZQUlWGm84,4684
-lkj-0.1.44.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-lkj-0.1.44.dist-info/top_level.txt,sha256=3DZOUwYmyurJFBXQCvCmEIVm8z2b42O5Sx3RDQyePfg,4
-lkj-0.1.44.dist-info/RECORD,,
+lkj-0.1.45.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+lkj-0.1.45.dist-info/METADATA,sha256=J8VwBFxfxTERN8kVlzKROEz3kkz0FvILqflc6rFVxeI,8221
+lkj-0.1.45.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+lkj-0.1.45.dist-info/top_level.txt,sha256=3DZOUwYmyurJFBXQCvCmEIVm8z2b42O5Sx3RDQyePfg,4
+lkj-0.1.45.dist-info/RECORD,,