progress-table 2.3.1__tar.gz → 3.0.0__tar.gz

progress_table-3.0.0/.gitignore

@@ -0,0 +1,10 @@
+.idea
+.ipynb_checkpoints
+*.ipynb
+__pycache__
+*.egg-info
+
+devel/
+dist
+build
+*.sh

progress_table-3.0.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: progress-table
+Version: 3.0.0
+Summary: Display progress as a pretty table in the command line.
+Project-URL: Home, https://github.com/gahaalt/progress-table.git
+Project-URL: Docs, https://github.com/sjmikler/progress-table/blob/main/docs
+Author-email: Szymon Mikler <sjmikler@gmail.com>
+License: MIT
+License-File: LICENSE.txt
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.7
+Requires-Dist: colorama
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: isort; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'

{progress_table-2.3.1 → progress_table-3.0.0}/README.md

@@ -1,4 +1,6 @@
-> Version 2.X introduces new features and new interactive modes.
+> Version 2.x.x introduces new features and new interactive modes.
+>
+> Version 3.x.x improves compatibility and stability.
 >
 > New features allow for previously impossible applications, see examples below.
 
@@ -24,6 +26,8 @@ Lightweight utility to display the progress of your process as a pretty table in
 
 ## Examples
 
+From `examples/` directory:
+
 * Neural network training
 
 ![example-training](images/examples-training.gif)
@@ -92,13 +96,11 @@ Go to [advanced usage](docs/advanced-usage.md) page for more information.
 
 Progress Table works correctly in most consoles, but there are some exceptions:
 
-* Some cloud logging consoles (e.g. kubernetes) don't support `\r` properly.
-  You can still use ProgressTable, but with `interactive=0` option. This mode will not display progress bars.
-* Some consoles like `PyCharm Python Console` or `IDLE` don't support cursor movement.
-  You can still use ProgressTable, but with `interactive=1` option. This mode displays only 1 progress bar at once.
+* Some cloud logging consoles (e.g. kubernetes) don't support `\r` properly. You can still use ProgressTable, but with `interactive=0` option. This mode will not display progress bars.
+
+* Some consoles like 'PyCharm Python Console' or 'IDLE' don't support cursor movement. You can still use ProgressTable, but with `interactive=1` option. In this mode, you can display only a single progress bar.
 
-> By default `interactive=2`. You can change the default `interactive` with an argument when creating the table object
-> or by setting `PTABLE_INTERACTIVE` environment variable, e.g. `PTABLE_INTERACTIVE=1`.
+> By default `interactive=2`. You can change the default 'interactive' with an argument when creating the table object or by setting 'PTABLE_INTERACTIVE' environment variable, e.g. `PTABLE_INTERACTIVE=1`.
 
 ### Other problems
 

progress_table-3.0.0/progress_table/__init__.py

@@ -0,0 +1,18 @@
+#  Copyright (c) 2022-2025 Szymon Mikler
+#  Licensed under the MIT License
+
+"""Progress Table provides an easy and pretty way to track your process.
+
+Supported features:
+    - Styling and coloring
+    - Modifying existing cells
+    - Progress bars integrated into the table
+"""
+
+__license__ = "MIT"
+__version__ = "3.0.0"
+__author__ = "Szymon Mikler"
+
+from progress_table.progress_table import ProgressTable, styles
+
+__all__ = ["ProgressTable", "styles"]

{progress_table-2.3.1/progress_table/v1 → progress_table-3.0.0/progress_table}/common.py

@@ -1,6 +1,7 @@
-#  Copyright (c) 2022-2024 Szymon Mikler
+#  Copyright (c) 2022-2025 Szymon Mikler
+#  Licensed under the MIT License
 
-from __future__ import annotations
+"""Common utilities for progress_table."""
 
 from typing import Union
 
@@ -20,12 +21,11 @@ COLORAMA_TRANSLATE = {
 NoneType = type(None)
 ColorFormat = Union[str, tuple, list, NoneType]
 ColorFormatTuple = (str, tuple, list, NoneType)
-
 CURSOR_UP = "\033[A"
 
 
 def maybe_convert_to_colorama_str(color: str) -> str:
-    # Translation layer to fix unintuitive colorama names
+    """Convert color from string to colorama string."""
     color = COLORAMA_TRANSLATE.get(color.lower(), color)
 
     if isinstance(color, str):
@@ -39,6 +39,10 @@ def maybe_convert_to_colorama_str(color: str) -> str:
 
 
 def maybe_convert_to_colorama(color: ColorFormat) -> str:
+    """Fix unintuitive colorama names.
+
+    Translation layer from user-passed to colorama-compatible names.
+    """
     if color is None or color == "":
         return ""
     if isinstance(color, str):