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

lkj/strings.py

@@ -741,7 +741,7 @@ def print_list(
     sep: str = ", ",
     line_prefix: str = "",
     items_per_line=None,
-    show_count=True,
+    show_count: Union[bool, Callable[[int], str]] = False,
     title=None,
     print_func=print,
 ):
@@ -755,7 +755,7 @@ def print_list(
         sep: Separator for items
         line_prefix: Prefix for each line
         items_per_line: For columns style, how many items per line
-        show_count: Whether to show the count of items
+        show_count: Whether to prefix with the count of items
         title: Optional title to display before the list
         print_func: Function to use for printing. Defaults to print.
                    If None, returns the string instead of printing.
@@ -765,19 +765,16 @@ def print_list(
 
         # Wrapped style (default)
         >>> print_list(items, max_width=30)
-        List (6 items):
         apple, banana, cherry, date,
         elderberry, fig
 
         # Columns style
         >>> print_list(items, style="columns", items_per_line=3)
-        List (6 items):
         apple banana     cherry
         date  elderberry fig
 
         # Numbered style
         >>> print_list(items, style="numbered")
-        List (6 items):
         1. apple
         2. banana
         3. cherry
@@ -787,7 +784,6 @@ def print_list(
 
         # Bullet style
         >>> print_list(items, style="bullet")
-        List (6 items):
         • apple
         • banana
         • cherry
@@ -796,7 +792,7 @@ def print_list(
         • fig
 
         # Return string instead of printing
-        >>> result = print_list(items, style="numbered", print_func=None)
+        >>> result = print_list(items, style="numbered", print_func=None, show_count=True)
         >>> print(result)
         List (6 items):
         1. apple
@@ -847,6 +843,8 @@ def print_list(
             print_func=print_func,
         )
     items = list(items)  # Convert to list if it's an iterable
+    if show_count is True:
+        show_count = lambda n_items: f"List ({n_items} items):"
 
     # Handle print_func=None by using StringAppender
     if print_func is None:
@@ -860,7 +858,7 @@ def print_list(
     if title:
         print_func(title)
     elif show_count:
-        print_func(f"List ({len(items)} items):")
+        print_func(show_count(len(items)))
 
     if not items:
         print_func(f"{line_prefix}(empty list)")

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lkj
-Version: 0.1.44
+Version: 0.1.46
 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.46.dist-info}/RECORD

@@ -7,9 +7,9 @@ lkj/importing.py,sha256=TcW3qUDmw7jqswpxXnksjlHkkbOJq70NbUk1ZyaafT0,6658
 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/strings.py,sha256=J3MD8sbXoaV7uACtue5v9QhAhFLjUCksf-cCTf9Ez5o,41509
+lkj-0.1.46.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+lkj-0.1.46.dist-info/METADATA,sha256=Q7e2mCXrROS5o5HcDNEnsJO3WZQnW-AnR2-0eiOKLfY,8221
+lkj-0.1.46.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+lkj-0.1.46.dist-info/top_level.txt,sha256=3DZOUwYmyurJFBXQCvCmEIVm8z2b42O5Sx3RDQyePfg,4
+lkj-0.1.46.dist-info/RECORD,,