progress-table 1.2.4__tar.gz → 1.3.0__tar.gz

{progress-table-1.2.4 → progress-table-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: progress-table
-Version: 1.2.4
+Version: 1.3.0
 Summary: Display progress as a pretty table in the command line.
 Home-page: https://github.com/gahaalt/progress-table.git
 Author: Szymon Mikler

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table/__init__.py

@@ -1,6 +1,6 @@
-#  Copyright (c) 2022 Szymon Mikler
+#  Copyright (c) 2022-2024 Szymon Mikler
 
-__version__ = "1.2.4"
+__version__ = "1.3.0"
 
 from progress_table.v0.progress_table import ProgressTableV0
 from progress_table.v1.progress_table import ProgressTableV1

progress-table-1.3.0/progress_table/v0/__init__.py

@@ -0,0 +1 @@
+#  Copyright (c) 2022-2024 Szymon Mikler

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table/v0/progress_table.py

@@ -1,4 +1,4 @@
-#  Copyright (c) 2022 Szymon Mikler
+#  Copyright (c) 2022-2024 Szymon Mikler
 
 from __future__ import annotations
 

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table/v0/symbols.py

@@ -1,3 +1,5 @@
+#  Copyright (c) 2022-2024 Szymon Mikler
+
 from dataclasses import dataclass
 
 

progress-table-1.3.0/progress_table/v1/__init__.py

@@ -0,0 +1 @@
+#  Copyright (c) 2022-2024 Szymon Mikler

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table/v1/progress_table.py

@@ -1,4 +1,4 @@
-#  Copyright (c) 2022 Szymon Mikler
+#  Copyright (c) 2022-2024 Szymon Mikler
 
 from __future__ import annotations
 
@@ -659,13 +659,17 @@ class TableProgressBar:
                 total = len(row)
                 step = self._step % total
 
-            new_row = []
+            new_row = [Style.BRIGHT]
             for letter_idx, letter in enumerate(row):
-                if letter == " ":
-                    if letter_idx / len(row) <= (step / total) % (1 + EPS):
-                        letter = self.table.table_style.embedded_pbar_filled
-                    elif (letter_idx - 1) / len(row) <= (step / total) % (1 + EPS):
-                        letter = self.table.table_style.embedded_pbar_head
+                is_bar = letter_idx / len(row) <= (step / total) % (1 + EPS)
+                is_head = (letter_idx - 1) / len(row) <= (step / total) % (1 + EPS)
+                if letter == " " and is_bar:
+                    letter = self.table.table_style.embedded_pbar_filled
+                if letter == " " and is_head:
+                    letter = self.table.table_style.embedded_pbar_head
+
+                if not is_bar and not is_head:
+                    new_row.append(Style.RESET_ALL)
                 new_row.append(letter)
             pbar.extend(new_row)
         pbar.append(CURSOR_UP * self.level)

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table/v1/styles.py

@@ -1,3 +1,6 @@
+#  Copyright (c) 2022-2024 Szymon Mikler
+
+
 class StyleNormal:
     name = "normal"
     pbar_filled = "■"

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: progress-table
-Version: 1.2.4
+Version: 1.3.0
 Summary: Display progress as a pretty table in the command line.
 Home-page: https://github.com/gahaalt/progress-table.git
 Author: Szymon Mikler

progress-table-1.3.0/progress_table.egg-info/PKG-INFO.sync-conflict-20240314-015933-NXTV2IO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.1
+Name: progress-table
+Version: 1.2.3
+Summary: Display progress as a pretty table in the command line.
+Home-page: https://github.com/gahaalt/progress-table.git
+Author: Szymon Mikler
+Author-email: sjmikler@gmail.com
+License: MIT
+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
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+
+> Note: versions 1.X introduced new features and changes of default behaviour.
+>
+> The old version is still available as `progress_table.ProgressTableV0`.
+>
+> New features include:
+> * Nested progress bar support
+> * Custom table styles support
+> * Color customization on row level support
+> * Adding columns automatically, without calling `add_column`
+> * Continuous progress bar when iterator length is unknown
+> * Pandas and numpy being only optional dependencies
+> * Other minor changes
+
+# Progress Table
+
+[![PyPi version](https://img.shields.io/badge/dynamic/json?label=latest&query=info.version&url=https%3A%2F%2Fpypi.org%2Fpypi%2Fprogress-table%2Fjson)](https://pypi.org/project/progress-table)
+[![PyPI license](https://img.shields.io/badge/dynamic/json?label=license&query=info.license&url=https%3A%2F%2Fpypi.org%2Fpypi%2Fprogress-table%2Fjson)](https://pypi.org/project/progress-table)
+
+Lightweight utility to display the progress of your process as a pretty table in the command line.
+Alternative to TQDM whenever you want to track metrics produced by your process.
+
+![example](https://github.com/gahaalt/progress-table/blob/main/images/progress-table-example.png?raw=true)
+
+Designed to monitor machine learning experiments, but can be used for any metrics-producing process.
+Allows you to quickly see what's going on with your process.
+Increases readability and simplifies your command line logging.
+
+## Purpose
+
+Change this:
+
+![example](https://github.com/gahaalt/progress-table/blob/main/images/progress-before3.gif?raw=true)
+
+Into this:
+
+![example](https://github.com/gahaalt/progress-table/blob/main/images/progress-after4.gif?raw=true)
+
+## Example
+
+> Click here for examples of integration with deep learning libraries:
+> [integrations.md](https://github.com/gahaalt/progress-table/blob/main/integrations.md).
+
+```python
+import random
+import sys
+import time
+
+from progress_table import ProgressTable
+
+# Create table object:
+table = ProgressTable()
+
+# Or customize its settings:
+table = ProgressTable(
+    columns=["step"],
+    refresh_rate=20,
+    num_decimal_places=4,
+    default_column_width=None,
+    default_column_color=None,
+    default_column_alignment=None,
+    default_column_aggregate=None,
+    default_row_color=None,
+    embedded_progress_bar=True,
+    pbar_show_throughput=True,
+    pbar_show_progress=False,
+    print_row_on_update=True,
+    reprint_header_every_n_rows=30,
+    custom_format=None,
+    table_style="round",
+    file=sys.stdout,
+)
+
+# You (optionally) define the columns at the beginning
+table.add_column("x", width=3)
+table.add_column("x root", color="red")
+table.add_column("random average", color=["bright", "red"], aggregate="mean")
+
+for step in range(10):
+    x = random.randint(0, 200)
+
+    # There are two ways to add new values:
+    table["x"] = x
+    table["step"] = step
+    # Second:
+    table.update("x root", x ** 0.5)
+    table.update("x squared", x ** 2)
+
+    # Display the progress bar by wrapping the iterator
+    for _ in table(10):  # -> Equivalent to `table(range(10))`
+        # You can use weights for aggregated values
+        table.update("random average", random.random(), weight=1)
+        time.sleep(0.1)
+
+    # Go to the next row when you're ready
+    table.next_row()
+
+# Close the table when it's ready
+table.close()
+
+# Export your data
+data = table.to_list()
+pandas_df = table.to_df()  # Requires pandas to be installed
+np_array = table.to_numpy()  # Requires numpy to be installed
+```
+
+![example](https://github.com/gahaalt/progress-table/blob/main/images/example-output4.gif?raw=true)
+
+## Installation
+
+Install Progress Table easily with pip:
+
+```
+pip install progress-table
+```
+
+## Links
+
+* [See on GitHub](https://github.com/gahaalt/progress-table)
+* [See on PyPI](https://pypi.org/project/progress-table)
+
+## Alternatives
+
+* Progress bars: great for tracking progress, but they don't provide ways to display data in clear and compact way
+    * `tqdm`
+    * `rich.progress`
+    * `keras.utils.Progbar`
+
+* Libraries displaying data: great for presenting tabular data, but they lack the progress tracking aspect
+    * `rich.table`
+    * `tabulate`
+    * `texttable`

{progress-table-1.2.4 → progress-table-1.3.0}/progress_table.egg-info/SOURCES.txt

@@ -4,8 +4,8 @@ pyproject.toml
 setup.cfg
 setup.py
 progress_table/__init__.py
-progress_table/test_docs_automated.py
 progress_table.egg-info/PKG-INFO
+progress_table.egg-info/PKG-INFO.sync-conflict-20240314-015933-NXTV2IO
 progress_table.egg-info/SOURCES.txt
 progress_table.egg-info/dependency_links.txt
 progress_table.egg-info/requires.txt

{progress-table-1.2.4 → progress-table-1.3.0}/setup.py

@@ -1,8 +1,8 @@
-#  Copyright (c) 2022 Szymon Mikler
+#  Copyright (c) 2022-2024 Szymon Mikler
 
 from pathlib import Path
 
-from setuptools import setup, find_packages
+from setuptools import find_packages, setup
 
 
 def package_relative_path(path):

progress-table-1.2.4/progress_table/test_docs_automated.py

@@ -1,60 +0,0 @@
-#  Copyright (c) 2022 Szymon Mikler
-
-import logging
-import os
-import pathlib
-import re
-
-
-def get_header(msg):
-    msg_len = len(msg)
-    header = [
-        "#" * (msg_len + 6),
-        "## " + msg + " ##",
-        "#" * (msg_len + 6),
-    ]
-    return "\n".join(header) + "\n"
-
-
-def scan_for_code_blobs(text):
-    # Capture code blocks starting with py or python
-    blobs = re.findall(r"```(py|python)\n([\s\S]+?)\n```", text)
-
-    new_blobs = []
-    for mode, blob in blobs:
-        if "..." in blob:
-            continue
-        header = get_header(f"Generated ({mode})")
-        blob = header + blob
-
-        # For `py` code blocks, we append them to previous existing block
-        # But `python` block starts a new scope and finishes the previous block
-        # They usually need to include imports
-        if mode == "py" and new_blobs:
-            new_blobs[-1] = new_blobs[-1] + "\n" + blob
-        else:
-            new_blobs.append(blob)
-    return new_blobs
-
-
-def test_all_code_blobs():
-    all_code_blobs = []
-
-    for root, dirs, files in os.walk("."):
-        for file in files:
-            path = pathlib.Path(os.path.join(root, file))
-            if path.suffix == ".md":
-                code_blobs = scan_for_code_blobs(path.open("r").read())
-                for blob in code_blobs:
-                    all_code_blobs.append(blob)
-
-    logging.warning(f"Detected {len(all_code_blobs)} code examples!")
-
-    for idx, blob in enumerate(all_code_blobs):
-        try:
-            globals_temp = {}
-            exec(blob, globals_temp)
-        except Exception as e:
-            print(f"Exception during automated documentation testing {idx}/{len(all_code_blobs)}:")
-            print(blob)
-            raise e