dataframe-textual 2.6.2__tar.gz → 2.8.0__tar.gz

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataframe-textual
-Version: 2.6.2
+Version: 2.8.0
 Summary: Interactive terminal viewer/editor for tabular data
 Project-URL: Homepage, https://github.com/need47/dataframe-textual
 Project-URL: Repository, https://github.com/need47/dataframe-textual.git
@@ -184,14 +184,15 @@ options:
   -t, --truncate-ragged-lines
                         Truncate ragged lines when reading CSV/TSV
   -E, --ignore-errors   Ignore errors when reading CSV/TSV
-  -c, --comment-prefix [COMMENT_PREFIX]
-                        Comment lines are skipped when reading CSV/TSV
-  -q, --quote-char [QUOTE_CHAR]
-                        Quote character for reading CSV/TSV
-  -l, --skip-lines SKIP_LINES
-                        Skip lines when reading CSV/TSV
-  -a, --skip-rows-after-header SKIP_ROWS_AFTER_HEADER
-                        Skip rows after header when reading CSV/TSV
+  -c, --comment-prefix [PREFIX]
+                        Comment lines starting with `PREFIX` are skipped when reading CSV/TSV
+  -q, --quote-char [C]
+                        Use `C` as quote character for reading CSV/TSV
+  -L, --skip-lines N
+                        Skip first N lines when reading CSV/TSV
+  -A, --skip-rows-after-header N
+                        Skip N rows after header when reading CSV/TSV
+  -N, --n-rows N        Stop after reading N rows from CSV/TSV
   -n, --null NULL [NULL ...]
                         Values to interpret as null values when reading CSV/TSV
 ```
@@ -357,6 +358,7 @@ zcat compressed_data.csv.gz | dv -f csv
 | Key | Action |
 |-----|--------|
 | `"` (quote) | Filter selected rows (others removed) |
+| `.` | View rows with non-null values in current column (others hidden) |
 | `v` | View selected rows (others hidden) |
 | `V` | View selected by expression (others hidden) |
 

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/README.md

@@ -145,14 +145,15 @@ options:
   -t, --truncate-ragged-lines
                         Truncate ragged lines when reading CSV/TSV
   -E, --ignore-errors   Ignore errors when reading CSV/TSV
-  -c, --comment-prefix [COMMENT_PREFIX]
-                        Comment lines are skipped when reading CSV/TSV
-  -q, --quote-char [QUOTE_CHAR]
-                        Quote character for reading CSV/TSV
-  -l, --skip-lines SKIP_LINES
-                        Skip lines when reading CSV/TSV
-  -a, --skip-rows-after-header SKIP_ROWS_AFTER_HEADER
-                        Skip rows after header when reading CSV/TSV
+  -c, --comment-prefix [PREFIX]
+                        Comment lines starting with `PREFIX` are skipped when reading CSV/TSV
+  -q, --quote-char [C]
+                        Use `C` as quote character for reading CSV/TSV
+  -L, --skip-lines N
+                        Skip first N lines when reading CSV/TSV
+  -A, --skip-rows-after-header N
+                        Skip N rows after header when reading CSV/TSV
+  -N, --n-rows N        Stop after reading N rows from CSV/TSV
   -n, --null NULL [NULL ...]
                         Values to interpret as null values when reading CSV/TSV
 ```
@@ -318,6 +319,7 @@ zcat compressed_data.csv.gz | dv -f csv
 | Key | Action |
 |-----|--------|
 | `"` (quote) | Filter selected rows (others removed) |
+| `.` | View rows with non-null values in current column (others hidden) |
 | `v` | View selected rows (others hidden) |
 | `V` | View selected by expression (others hidden) |
 

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dataframe-textual"
-version = "2.6.2"
+version = "2.8.0"
 description = "Interactive terminal viewer/editor for tabular data"
 readme = "README.md"
 requires-python = ">=3.11"

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/src/dataframe_textual/__main__.py

@@ -51,15 +51,34 @@ def cli() -> argparse.Namespace:
     )
     parser.add_argument("-E", "--ignore-errors", action="store_true", help="Ignore errors when reading CSV/TSV")
     parser.add_argument(
-        "-c", "--comment-prefix", nargs="?", const="#", help="Comment lines are skipped when reading CSV/TSV"
+        "-c",
+        "--comment-prefix",
+        metavar="PREFIX",
+        nargs="?",
+        const="#",
+        help="Comment lines starting with `PREFIX` are skipped when reading CSV/TSV",
     )
     parser.add_argument(
-        "-q", "--quote-char", nargs="?", const=None, default='"', help="Quote character for reading CSV/TSV"
+        "-q",
+        "--quote-char",
+        metavar="C",
+        nargs="?",
+        const=None,
+        default='"',
+        help="Use `C` as quote character for reading CSV/TSV",
     )
-    parser.add_argument("-l", "--skip-lines", type=int, default=0, help="Skip lines when reading CSV/TSV")
     parser.add_argument(
-        "-a", "--skip-rows-after-header", type=int, default=0, help="Skip rows after header when reading CSV/TSV"
+        "-L", "--skip-lines", metavar="N", type=int, default=0, help="Skip first N lines when reading CSV/TSV"
     )
+    parser.add_argument(
+        "-A",
+        "--skip-rows-after-header",
+        metavar="N",
+        type=int,
+        default=0,
+        help="Skip N rows after header when reading CSV/TSV",
+    )
+    parser.add_argument("-N", "--n-rows", metavar="N", type=int, help="Stop after reading N rows from CSV/TSV")
     parser.add_argument("-n", "--null", nargs="+", help="Values to interpret as null values when reading CSV/TSV")
 
     args = parser.parse_args()
@@ -98,6 +117,7 @@ def main() -> None:
         null_values=args.null,
         ignore_errors=args.ignore_errors,
         truncate_ragged_lines=args.truncate_ragged_lines,
+        n_rows=args.n_rows,
     )
     app = DataFrameViewer(*sources)
     app.run()

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/src/dataframe_textual/common.py

@@ -485,6 +485,7 @@ def load_dataframe(
     null_values: list[str] | None = None,
     ignore_errors: bool = False,
     truncate_ragged_lines: bool = False,
+    n_rows: int | None = None,
 ) -> list[Source]:
     """Load DataFrames from file specifications.
 
@@ -502,6 +503,8 @@ def load_dataframe(
         skip_rows_after_header: Number of rows to skip after header. Defaults to 0.
         null_values: List of values to interpret as null when reading CSV/TSV files. Defaults to None.
         ignore_errors: Whether to ignore errors when reading CSV/TSV files. Defaults to False.
+        truncate_ragged_lines: Whether to truncate ragged lines when reading CSV/TSV files. Defaults to False.
+        n_rows: Number of rows to read from CSV/TSV files. Defaults to None (read all rows).
 
     Returns:
         List of `Source` objects.
@@ -551,6 +554,7 @@ def load_dataframe(
                 null_values=null_values,
                 ignore_errors=ignore_errors,
                 truncate_ragged_lines=truncate_ragged_lines,
+                n_rows=n_rows,
             )
         )
 
@@ -635,6 +639,7 @@ def load_file(
     null_values: list[str] | None = None,
     ignore_errors: bool = False,
     truncate_ragged_lines: bool = False,
+    n_rows: int | None = None,
 ) -> list[Source]:
     """Load a single file.
 
@@ -660,6 +665,8 @@ def load_file(
         schema_overrides: Optional dictionary of column name to Polars data type to override inferred schema.
         null_values: List of values to interpret as null when reading CSV/TSV files. Defaults to None.
         ignore_errors: Whether to ignore errors when reading CSV/TSV files.
+        truncate_ragged_lines: Whether to truncate ragged lines when reading CSV/TSV files. Defaults to False.
+        n_rows: Number of rows to read from CSV/TSV files. Defaults to None (read all rows).
 
     Returns:
         List of `Source` objects.
@@ -684,6 +691,7 @@ def load_file(
             null_values=null_values,
             ignore_errors=ignore_errors,
             truncate_ragged_lines=truncate_ragged_lines,
+            n_rows=n_rows,
         )
         data.append(Source(lf, filename, filepath.stem))
     elif file_format in ("xlsx", "xls"):
@@ -740,6 +748,8 @@ def load_file(
             schema_overrides=schema_overrides,
             null_values=null_values,
             ignore_errors=ignore_errors,
+            truncate_ragged_lines=truncate_ragged_lines,
+            n_rows=n_rows,
         )
 
     return data

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/src/dataframe_textual/data_frame_table.py

@@ -188,9 +188,10 @@ class DataFrameTable(DataTable):
         - *(Supports case-insensitive & whole-word matching)*
 
         ## 👁️ View & Filter
-        - **"** - 📍 Filter selected rows (removes others)
-        - **v** - 👁️ View selected rows (hides others)
-        - **V** - 🔧 View selected rows matching expression (hides others)
+        - **"** - 📍 Filter selected rows (others removed)
+        - **.** - 👁️ View rows with non-null values in current column (others hidden)
+        - **v** - 👁️ View selected rows (others hidden)
+        - **V** - 🔧 View selected rows matching expression (others hidden)
 
         ## 🔍 SQL Interface
         - **l** - 💬 Open simple SQL interface (select columns & where clause)
@@ -264,6 +265,7 @@ class DataFrameTable(DataTable):
         ("left_square_bracket", "sort_ascending", "Sort ascending"),  # `[`
         ("right_square_bracket", "sort_descending", "Sort descending"),  # `]`
         # View & Filter
+        ("full_stop", "view_rows_non_null", "View rows with non-null values in current column"),
         ("v", "view_rows", "View selected rows"),
         ("V", "view_rows_expr", "View selected rows matching expression"),
         ("quotation_mark", "filter_rows", "Filter selected rows"),  # `"`
@@ -761,6 +763,10 @@ class DataFrameTable(DataTable):
         """Show metadata for the current column."""
         self.do_metadata_column()
 
+    def action_view_rows_non_null(self) -> None:
+        """View rows with non-null values in the current column."""
+        self.do_view_rows_non_null()
+
     def action_view_rows(self) -> None:
         """View rows by current cell value."""
         self.do_view_rows()
@@ -3603,6 +3609,15 @@ class DataFrameTable(DataTable):
         self.show_next_replace_confirmation()
 
     # View & Filter
+    def do_view_rows_non_null(self) -> None:
+        """View non-null rows based on the cursor column."""
+        cidx = self.cursor_col_idx
+        col_name = self.cursor_col_name
+
+        term = pl.col(col_name).is_not_null()
+
+        self.view_rows((term, cidx, False, True))
+
     def do_view_rows(self) -> None:
         """View rows.
 
@@ -3712,7 +3727,7 @@ class DataFrameTable(DataTable):
             return
 
         # Add to history
-        self.add_history(f"Filtered by expression [$success]{expr_str}[/]")
+        self.add_history(f"Viewed rows by expression [$success]{expr_str}[/]")
 
         ok_rids = set(df_filtered[RID])
 
@@ -3734,7 +3749,7 @@ class DataFrameTable(DataTable):
         # Recreate table for display
         self.setup_table()
 
-        self.notify(f"Filtered to [$success]{matched_count}[/] matching row(s)", title="View Rows")
+        self.notify(f"Showing [$success]{matched_count}[/] matching row(s)", title="View Rows")
 
     def do_filter_rows(self) -> None:
         """Filter rows.

{dataframe_textual-2.6.2 → dataframe_textual-2.8.0}/uv.lock

@@ -171,7 +171,7 @@ wheels = [
 
 [[package]]
 name = "dataframe-textual"
-version = "2.6.2"
+version = "2.8.0"
 source = { editable = "." }
 dependencies = [
     { name = "polars" },