dataframe-textual 1.3.9__tar.gz → 1.16.2__tar.gz

{dataframe_textual-1.3.9 → dataframe_textual-1.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataframe-textual
-Version: 1.3.9
+Version: 1.16.2
 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
@@ -48,7 +48,7 @@ A powerful, interactive terminal-based viewer/editor for CSV/TSV/Excel/Parquet/J
 ### Data Viewing
 - 🚀 **Fast Loading** - Powered by Polars for efficient data handling
 - 🎨 **Rich Terminal UI** - Beautiful, color-coded columns with various data types (e.g., integer, float, string)
-- ⌨️ **Comprehensive Keyboard Navigation** - Intuitive controls for browsing, editing, and manipulating data
+- ⌨️ **Comprehensive Keyboard Navigation** - Intuitive controls
 - 📊 **Flexible Input** - Read from files and/or stdin (pipes/redirects)
 - 🔄 **Smart Pagination** - Lazy load rows on demand for handling large datasets
 
@@ -62,8 +62,10 @@ A powerful, interactive terminal-based viewer/editor for CSV/TSV/Excel/Parquet/J
 ### Advanced Features
 - 📂 **Multi-File Support** - Open multiple files in separate tabs
 - 🔄 **Tab Management** - Seamlessly switch between open files with keyboard shortcuts
+- 📑 **Duplicate Tab** - Create a copy of the current tab with the same data
 - 📌 **Freeze Rows/Columns** - Keep important rows and columns visible while scrolling
 - 🎯 **Cursor Type Cycling** - Switch between cell, row, and column selection modes
+- 📸 **Take Screenshot** - Capture terminal view as a SVG image
 
 ## Installation
 
@@ -81,7 +83,7 @@ This installs an executable `dv`.
 
 Then run:
 ```bash
-dv <csv_file>
+dv <file>
 ```
 
 ### Using [uv](https://docs.astral.sh/uv/)
@@ -95,7 +97,7 @@ cd dataframe-textual
 uv sync --extra excel  # with Excel support
 
 # Run directly with uv
-uv run dv <csv_file>
+uv run dv <file>
 ```
 
 ### Development installation
@@ -108,7 +110,10 @@ cd dataframe-textual
 # Install from local source
 pip install -e .
 
-# Or with development dependencies
+# With Excel support
+pip install -e ".[excel]"
+
+# With development dependencies
 pip install -e ".[excel,dev]"
 ```
 
@@ -120,15 +125,21 @@ pip install -e ".[excel,dev]"
 # After pip install dataframe-textual
 dv pokemon.csv
 
-# Or if running from source
-python main.py pokemon.csv
+# Or run from module
+python -m dataframe-textual pokemon.csv
 
 # Or with uv
 uv run python main.py pokemon.csv
 
-# Read from stdin (auto-detects format; defaults to TSV if not recognized)
+# Read from stdin (defaults to TSV)
 cat data.tsv | dv
 dv < data.tsv
+
+# Specify format for gzipped stdin
+zcat data.csv.gz | dv -f csv
+
+# Gzipped files are supported
+dv data.csv.gz
 ```
 
 ### Multi-File Usage - Multiple Tabs
@@ -140,16 +151,85 @@ dv file1.csv file2.csv file3.csv
 # Open multiple sheets in tabs in an Excel file
 dv file.xlsx
 
-# Mix files and stdin (read from stdin, then open file)
+# Mix files and stdin
 dv data1.tsv < data2.tsv
 ```
 
 When multiple files are opened:
-- Each file appears as a separate tab at the top
-- Switch between tabs using `>` (next) or `<` (previous)
+- Each file appears as a separate tab. An Excel file may contain multiple tabs.
+- Switch between tabs using `>` (next) or `<` (previous), or use `b` for cycling through tabs
+- Save current tab to file with `Ctrl+T`
+- Save all tabs to file with `Ctrl+A`
+- Duplicate the current tab with `Ctrl+D`
 - Open additional files with `Ctrl+O`
-- Close the current tab with `Ctrl+W`
-- Each file maintains its own state (edits, sort order, selections, history, etc.)
+- Each file maintains its own state (edits, sort order, selections, history, etc.) and allow undo/redo.
+
+## Command Line Options
+
+```
+usage: dv [-h] [-f {csv,excel,tsv,parquet,json,ndjson}] [-H] [-I] [-E] [-c COMMENT_PREFIX] [-q QUOTE_CHAR] [-l SKIP_LINES] [-a SKIP_ROWS_AFTER_HEADER] [-n NULL [NULL ...]] [files ...]
+
+Interactive terminal based viewer/editor for tabular data (e.g., CSV/TSV/Excel).
+
+positional arguments:
+  files                 Input files (or read from stdin)
+
+options:
+  -h, --help            show this help message and exit
+  -f, --format {csv,excel,tsv,parquet,json,ndjson}
+                        Specify the format of the input files
+  -H, --no-header       Specify that input files have no header row
+  -I, --no-inference   Do not infer data types 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 (default: skip none)
+  -q, --quote-char QUOTE_CHAR
+                        Quote character for reading CSV/TSV (default: "; use -q without argument value to disable)
+  -l, --skip-lines SKIP_LINES
+                        Skip lines when reading CSV/TSV (default: 0)
+  -a, --skip-rows-after-header SKIP_ROWS_AFTER_HEADER
+                        Skip rows after header when reading CSV/TSV (default: 0)
+  -n, --null NULL [NULL ...]
+                        Values to interpret as null values when reading CSV/TSV
+```
+
+### CLI Examples
+
+```bash
+# View headless CSV file
+dv -H data_no_header.csv
+
+# Disable type inference for faster loading
+dv -I large_data.csv
+
+# Ignore parsing errors in malformed CSV
+dv -E data_with_errors.csv
+
+# Skip first 3 lines of file (e.g., metadata)
+dv -l 3 data_with_meta.csv
+
+# Skip 1 row after header (e.g., units row)
+dv -a 1 data_with_units.csv
+
+# Skip comment lines (or just -c)
+dv -c "#" commented_data.csv
+
+# Treat specific values as null/missing (e.g., 'NA', 'N/A', '-')
+dv -n NA N/A - data.csv
+
+# Use different quote character (e.g., single quote for CSV)
+dv -q "'" data.csv
+
+# Disable quote character processing for TSV with embedded quotes
+dv -q data.tsv
+
+# Complex CSV with comments and units row
+dv -l 3 -a 1 -I messy_scientific_data.csv
+
+# Process compressed data
+dv data.csv.gz
+zcat compressed_data.csv.gz | dv -f csv
+```
 
 ## Keyboard Shortcuts
 
@@ -159,20 +239,28 @@ When multiple files are opened:
 
 | Key | Action |
 |-----|--------|
-| `Ctrl+O` | Open file in a new tab |
-| `Ctrl+W` | Close current tab |
-| `Ctrl+A` | Save all open tabs to Excel file |
-| `>` or `b` | Move to next tab |
+| `>` | Move to next tab |
 | `<` | Move to previous tab |
+| `b` | Cycle through tabs |
 | `B` | Toggle tab bar visibility |
-| `q` | Quit the application |
+| `q` | Close current tab (prompts to save unsaved changes) |
+| `Q` | Close all tabs and app (prompts to save unsaved changes) |
+| `Ctrl+Q` | Force to quit app (regardless of unsaved changes) |
+| `Ctrl+T` | Save current tab to file |
+| `w` | Save current tab to file (overwrite without prompt) |
+| `Ctrl+A` | Save all tabs to file |
+| `W` | Save all tabs to file (overwrite without prompt) |
+| `Ctrl+D` | Duplicate current tab |
+| `Ctrl+O` | Open file in a new tab |
+| `Double-click` | Rename tab |
 
 #### View & Settings
 
 | Key | Action |
 |-----|--------|
 | `F1` | Toggle help panel |
-| `k` | Cycle through themes |
+| `k` | Cycle through dark, light and other themes |
+| `Ctrl+P` -> `Screenshot` | Capture terminal view as a SVG image |
 
 ---
 
@@ -186,20 +274,34 @@ When multiple files are opened:
 | `G` | Jump to last row (loads all remaining rows) |
 | `↑` / `↓` | Move up/down one row |
 | `←` / `→` | Move left/right one column |
-| `Home` / `End` | Jump to first/last column in current row |
-| `Ctrl + Home` / `Ctrl + End` | Jump to top/bottom in current page |
+| `Home` / `End` | Jump to first/last column |
+| `Ctrl + Home` / `Ctrl + End` | Jump to page top/bottom |
 | `PageDown` / `PageUp` | Scroll down/up one page |
+| `Ctrl+F` | Page forward |
+| `Ctrl+B` | Page backforward |
+
+#### Undo/Redo/Reset
+| Key | Action |
+|-----|--------|
+| `u` | Undo last action |
+| `U` | Redo last undone action |
+| `Ctrl+U` | Reset to initial state |
 
-#### Viewing & Display
+#### Display
 
 | Key | Action |
 |-----|--------|
-| `Enter` | View full details of current row in modal |
-| `F` | Show frequency distribution for column |
+| `Enter` | Record view of current row transposed |
+| `F` | Show frequency distribution for current column |
 | `s` | Show statistics for current column |
 | `S` | Show statistics for entire dataframe |
-| `K` | Cycle cursor type: cell → row → column → cell |
+| `K` | Cycle cursor types: cell → row → column → cell |
 | `~` | Toggle row labels |
+| `_` (underscore) | Expand column to full width |
+| `z` | Freeze rows and columns |
+| `,` | Toggle thousand separator for numeric display |
+| `h` | Hide current column |
+| `H` | Show all hidden rows/columns |
 
 #### Data Editing
 
@@ -208,56 +310,57 @@ When multiple files are opened:
 | `Double-click` | Edit cell or rename column header |
 | `delete` | Clear current cell (set to NULL) |
 | `e` | Edit current cell (respects data type) |
-| `E` | Edit entire column with expression |
+| `E` | Edit entire column with value/expression |
 | `a` | Add empty column after current |
 | `A` | Add column with name and value/expression |
+| `@` | Add a link column from URL template |
 | `-` (minus) | Delete current column |
-| `_` (underscore) | Delete current column and all columns after |
-| `Ctrl+_` | Delete current column and all columns before |
 | `x` | Delete current row |
-| `X` | Delete current row and all rows below |
-| `Ctrl+X` | Delete current row and all rows above |
+| `X` | Delete current row and all those below |
+| `Ctrl+X` | Delete current row and all those above |
 | `d` | Duplicate current column (appends '_copy' suffix) |
 | `D` | Duplicate current row |
-| `h` | Hide current column |
-| `H` | Show all hidden rows/columns |
 
-#### Searching & Filtering
+#### Row Selection
 
 | Key | Action |
 |-----|--------|
-| `\` | Search in current column using cursor value and select rows |
-| `\|` (pipe) | Search in current column with expression and select rows |
-| `/` | Find in current column with cursor value and highlight matches |
-| `?` | Find in current column with expression and highlight matches |
-| `n` | Go to next match |
-| `N` | Go to previous match |
+| `\` | Select rows that matches cursor value in current column |
+| `\|` (pipe) | Select rows by expression |
 | `{` | Go to previous selected row |
 | `}` | Go to next selected row |
 | `'` | Select/deselect current row |
-| `t` | Toggle selected rows (invert) |
-| `T` | Clear all selected rows and/or matches |
-| `"` (quote) | Filter to selected rows only |
-| `v` | View only rows by selected rows and/or matches or cursor value |
-| `V` | View only rows by expression |
+| `t` | Toggle row selections (invert) |
+| `T` | Clear all row selections and/or cell matches |
 
-#### SQL Interface
+#### Find & Replace
 
 | Key | Action |
 |-----|--------|
-| `l` | Simple SQL interface (select columns & WHERE clause) |
-| `L` | Advanced SQL interface (full SQL queries) |
+| `/` | Find in current column with cursor value and highlight matching cells |
+| `?` | Find in current column with expression and highlight matching cells |
+| `n` | Go to next matching cell |
+| `N` | Go to previous matching cell |
+| `;` | Find across all columns with cursor value |
+| `:` | Find across all columns with expression |
+| `r` | Find and replace in current column (interactive or replace all) |
+| `R` | Find and replace across all columns (interactive or replace all) |
 
-#### Find & Replace
+#### View & Filter
+| Key | Action |
+|-----|--------|
+| `"` (quote) | Filter to rows that are selected or contain matching cells (and remove others) |
+| `v` | View rows (and hide others) by row selections and cell matches or cursor value |
+| `V` | View rows (and hide others) by expression |
+
+#### SQL Interface
 
 | Key | Action |
 |-----|--------|
-| `f` | Find across all columns with cursor value |
-| `Ctrl+F` | Find across all columns with expression |
-| `r` | Find and replace in current column (interactive or replace all) |
-| `R` | Find and replace across all columns (interactive or replace all) |
+| `l` | Simple SQL interface (select columns & where clause) |
+| `L` | Advanced SQL interface (full SQL query with syntax highlight) |
 
-#### Sorting
+#### Sorting (supporting multiple columns)
 
 | Key | Action |
 |-----|--------|
@@ -273,7 +376,7 @@ When multiple files are opened:
 | `Shift+←` | Move current column left |
 | `Shift+→` | Move current column right |
 
-#### Type Conversion
+#### Type Casting
 
 | Key | Action |
 |-----|--------|
@@ -281,21 +384,15 @@ When multiple files are opened:
 | `%` | Cast current column to float (Float64) |
 | `!` | Cast current column to boolean |
 | `$` | Cast current column to string |
-| `@` | Make URLs in current column clickable with Ctrl/Cmd + click|
 
-#### Data Management
+#### Copy & Save
 
 | Key | Action |
 |-----|--------|
-| `z` | Freeze rows and columns |
-| `,` | Toggle thousand separator for numeric display |
 | `c` | Copy current cell to clipboard |
 | `Ctrl+C` | Copy column to clipboard |
 | `Ctrl+R` | Copy row to clipboard (tab-separated) |
 | `Ctrl+S` | Save current tab to file |
-| `u` | Undo last action |
-| `U` | Redo last undone action |
-| `Ctrl+U` | Reset to initial state |
 
 ## Features in Detail
 
@@ -303,155 +400,108 @@ When multiple files are opened:
 
 Columns are automatically styled based on their data type:
 - **integer**: Cyan text, right-aligned
-- **float**: Magenta text, right-aligned
+- **float**: Yellow text, right-aligned
 - **string**: Green text, left-aligned
 - **boolean**: Blue text, centered
-- **temporal**: Yellow text, centered
+- **temporal**: Magenta text, centered
 
 ### 2. Row Detail View
 
 Press `Enter` on any row to open a modal showing all column values for that row.
-Useful for examining wide datasets where columns don't fit on screen.
+Useful for examining wide datasets where columns don't fit well on screen.
 
 **In the Row Detail Modal**:
-- Press `v` to **view** the main table to show only rows with the selected column value
-- Press `"` to **filter** all rows containing the selected column value
+- Press `v` to **view** all rows containing the selected column value (and hide others)
+- Press `"` to **filter** all rows containing the selected column value (and remove others)
+- Press `{` to move to the **previous row** (respects hidden rows)
+- Press `}` to move to the **next row** (respects hidden rows)
 - Press `q` or `Escape` to close the modal
 
-### 3. Search & Filtering
+### 3. Row Selection
 
-The application provides multiple search modes for different use cases:
+The application provides multiple modes for selecting rows (marks it for filtering or viewing):
 
-**Search Operations** - Direct value/expression matching in current column:
-- **`|` - Column Expression Search**: Opens dialog to search current column with custom expression
-- **`\` - Column Cursor Search**: Instantly search current column using the cursor value
-
-**Find Operations** - Find by value/expression:
-- **`/` - Column Find**: Find cursor value within current column
-- **`?` - Column Expression Find**: Open dialog to search current column with expression
-- **`f` - Global Find**: Find cursor value across all columns
-- **`Ctrl+f` - Global Expression Find**: Open dialog to search all columns with expression
-
-**Selection & Filtering**:
-- **`'` - Toggle Row Selection**: Select/deselect current row (marks it for filtering)
-- **`t` - Invert Selections**: Flip selection state of all rows at once
-- **`T` - Clear Selections**: Remove all row selections and matches
-- **`"` - Filter Selected**: Display only the selected rows and remove others
-- **`v` - View by Value**: Filter/view rows by selected rows or cursor value (others hidden but preserved)
-- **`V` - View by Expression**: Filter/view rows using custom Polars expression (others hidden but preserved)
+- `\` - Select rows that match cursor value in current column (respects data type)
+- `|` - Opens dialog to select rows with custom expression
+- `'` - Select/deselect current row
+- `t` - Flip selections of all rows
+- `T` - Clear all row selections and cell matches
+- `{` - Go to previous selected row
+- `}` - Go to next selected row
 
 **Advanced Matching Options**:
 
 When searching or finding, you can use checkboxes in the dialog to enable:
-- **Match Nocase**: Ignore case differences (e.g., "john", "John", "JOHN" all match)
-- **Match Whole**: Match complete value, not partial substrings or words (e.g., "cat" won't match in "catfish")
+- **Match Nocase**: Ignore case differences
+- **Match Whole**: Match complete value, not partial substrings or words
 
-These options work with plain text searches. Use Polars regex patterns in expressions for more control:
-- **Case-insensitive matching in expressions**: Use `(?i)` prefix in regex (e.g., `(?i)john`)
-- **Word boundaries in expressions**: Use `\b` in regex (e.g., `\bjohn\b` matches whole word)
+These options work with plain text searches. Use Polars regex patterns in expressions for more control. For example, use `(?i)` prefix in regex (e.g., `(?i)john`) for case-insensitive matching.
 
 **Quick Tips:**
-- Search results highlight matching rows/cells in **red**
-- Multiple searches **accumulate selections** - each new search adds to the selections
+- Search results highlight matching rows in **red**
+- Use expression for advanced selection (e.g., $attack > $defense)
+- Multiple searches **accumulate** - each new search adds to the selections or matches
 - Type-aware matching automatically converts values. Resort to string comparison if conversion fails
 - Use `u` to undo any search or filter
 
-### 3b. Find & Replace
-
-The application provides powerful find and replace functionality for both single-column and global replacements.
+### 4. Find & Replace
+**Find Operations** - Find by value/expression and highlight matching cells:
+- `/` - Find cursor value within current column (respects data type)
+- `?` - Open dialog to search current column with expression
+- `;` - Find cursor value across all columns
+- `:` - Open dialog to search all columns with expression
+- `n` - Go to next matching cell
+- `N` - Go to previous matching cell
 
-**Replace Operations**:
-- **`r` - Column Replace**: Replace values in the current column
-- **`R` - Global Replace**: Replace values across all columns
+Replace values in current column (`r`) or across all columns (`R`).
 
 **How It Works:**
 
-When you press `r` or `R`, a dialog opens where you can enter:
-1. **Find term**: The value or expression to search for
-2. **Replace term**: What to replace matches with
-3. **Matching options**:
-   - **Match Nocase**: Ignore case differences when matching (unchecked by default)
-   - **Match Whole**: Match complete words only, not partial words (unchecked by default)
-4. **Replace option**:
-   - Choose **"Replace All"** to replace all matches at once (with confirmation)
-   - Otherwise, review and confirm each match individually
-
-**Replace All** (`r` or `R` → Choose "Replace All"):
-- Shows a confirmation dialog with the number of matches and replacements
-- Replaces all matches with a single operation
-- Full undo support with `u`
-- Useful for bulk replacements when you're confident about the change
-
-**Replace Interactive** (`r` or `R` → Choose "Replace Interactive"):
-- Shows each match one at a time with a preview of the replacement
-- For each match, press:
-  - `Enter` or press the `Yes` button - **Replace this occurrence** and move to next
-  - Press the `Skip` button - **Skip this occurrence** and move to next
-  - `Escape` or press the `No` button - **Cancel** remaining replacements (but keep already-made replacements)
-- Displays progress: `Occurrence X of Y` (Y = total matches, X = current)
-- Shows the value that will be replaced and what it will become
-- Useful for careful replacements where you want to review each change
-
-**Search Term Types:**
-- **Plain text**: Exact string match (e.g., "John" finds "John")
-  - Use **Match Nocase** checkbox to match regardless of case (e.g., find "john", "John", "JOHN")
-  - Use **Match Whole** checkbox to match complete words only (e.g., find "cat" but not in "catfish")
-- **NULL**: Replace null/missing values (type `NULL`)
-- **Expression**: Polars expressions for complex matching (e.g., `$_ > 50` for column replace)
-- **Regex patterns**: Use Polars regex syntax for advanced matching
-  - Case-insensitive: Use `(?i)` prefix (e.g., `(?i)john`)
-  - Whole word: Use `\b` boundary markers (e.g., `\bjohn\b`)
+When you press `r` or `R`, enter:
+1. **Find term**: Value or expression to search for (done by string value)
+2. **Replace term**: Replacement value
+3. **Matching options**: Match Nocase (ignore case), Match Whole (complete match only)
+4. **Replace mode**: All at once or interactive review
 
-**Examples:**
+**Replace All**:
+- Replaces all matches with one operation
+- Shows confirmation with match count
 
-```
-Find: "John"
-Replace: "Jane"
-→ All occurrences of "John" become "Jane"
-
-Find: "john"
-Replace: "jane"
-Match Nocase: ✓ (checked)
-→ "John", "JOHN", "john" all become "jane"
-
-Find: "cat"
-Replace: "dog"
-Match Whole: ✓ (checked)
-→ "cat" becomes "dog", but "catfish" is not matched
-
-Find: "NULL"
-Replace: "Unknown"
-→ All null/missing values become "Unknown"
-
-Find: "(?i)active"        # Case-insensitive
-Replace: "inactive"
-→ "Active", "ACTIVE", "active" all become "inactive"
-```
+**Replace Interactive**:
+- Review each match one at a time (confirm, skip, or cancel)
+- Shows progress: `X of Y`
 
-**For Global Replace (`R`)**:
-- Searches and replaces across all columns simultaneously
-- Each column can have different matching behavior (string matching for text, numeric for numbers)
-- Preview shows which columns contain matches before replacement
-- Useful for standardizing values across multiple columns
+**Tips:**
+- Search are done by string value (i.e. ignoring data type)
+- Type `NULL` to replace null/missing values
+- Use `Match Nocase` for case-insensitive matching
+- Use `Match Whole` to avoid partial replacements
+- Support undo (`u`)
 
-**Features:**
-- **Full history support**: Use `u` (undo) to revert any replacement
-- **Visual feedback**: Matching cells are highlighted before you choose replacement mode
-- **Safe operations**: Requires confirmation before replacing
-- **Progress tracking**: Shows how many replacements have been made during interactive mode
-- **Type-aware**: Respects column data types when matching and replacing
-- **Flexible matching**: Support for case-insensitive and whole-word matching
+### 5. Filter vs. View
 
-**Tips:**
-- Use interactive mode for one-time replacements to be absolutely sure
-- Use "Replace All" for routine replacements (e.g., fixing typos, standardizing formats)
-- Use **Match Nocase** for matching variations of names or titles
-- Use **Match Whole** to avoid unintended partial replacements
-- Use `u` immediately if you accidentally replace something wrong
-- For complex replacements, use Polars expressions or regex patterns in the find term
-- Test with a small dataset first before large replacements
+Both operations show rows that are selected or contain matching cells, but with fundamentally different effects:
 
-### 4. [Polars Expressions](https://docs.pola.rs/api/python/stable/reference/expressions/index.html)
+| Operation | Keyboard | Effect | Data Preserved |
+|-----------|----------|--------|-----------------|
+| **View** | `v`, `V` | Hides non-matching rows | Yes (hidden, can be restored by `H`) |
+| **Filter** | `"` | Removes non-matching rows | No (permanently deleted) |
+
+**When to use View** (`v` or `V`):
+- Exploring or analyzing data safely
+- Switching between different perspectives
+- Press `H` to restore hidden rows (and hidden columns)
+
+**When to use Filter** (`"`):
+- Cleaning data (removing unwanted rows)
+- Creating a trimmed dataset for export
+- Permanent row removal from your dataframe
+
+**Note**:
+- If currently there are no selected rows and no matching cells, the `"` (Filter) and `v` (View) will use cursor value for search.
+- Both support full undo with `u`.
+
+### 6. [Polars Expressions](https://docs.pola.rs/api/python/stable/reference/expressions/index.html)
 
 Complex values or filters can be specified via Polars expressions, with the following adaptions for convenience:
 
@@ -459,6 +509,7 @@ Complex values or filters can be specified via Polars expressions, with the foll
 - `$_` - Current column (based on cursor position)
 - `$1`, `$2`, etc. - Column by 1-based index
 - `$age`, `$salary` - Column by name (use actual column names)
+- `` $`col name` `` - Column by name with spaces (backtick quoted)
 
 **Row References:**
 - `$#` - Current row index (1-based)
@@ -469,6 +520,7 @@ Complex values or filters can be specified via Polars expressions, with the foll
 - `$age < 30` - Age less than 30
 - `$status == 'active'` - Status exactly matches 'active'
 - `$name != 'Unknown'` - Name is not 'Unknown'
+- `$# <= 10` - Top 10 rows
 
 **Logical Operators:**
 - `&` - AND
@@ -483,8 +535,9 @@ Complex values or filters can be specified via Polars expressions, with the foll
 - `($score >= 80) & ($score <= 90)` - Score between 80 and 90
 - `~($status == 'inactive')` - Status is not inactive
 - `$revenue > $expenses` - Revenue exceeds expenses
+- ``$`product id` > 100`` - Product ID with spaces in column name greater than 100
 
-**String Matching:**
+**String Matching:** ([Polars string API reference](https://docs.pola.rs/api/python/stable/reference/series/string.html))
 - `$name.str.contains("John")` - Name contains "John" (case-sensitive)
 - `$name.str.contains("(?i)john")` - Name contains "john" (case-insensitive)
 - `$email.str.ends_with("@company.com")` - Email ends with domain
@@ -505,26 +558,41 @@ Complex values or filters can be specified via Polars expressions, with the foll
 - Use column names that match exactly (case-sensitive)
 - Use parentheses to clarify complex expressions: `($a & $b) | ($c & $d)`
 
-### 5. Sorting
+### 7. Sorting
 
 - Press `[` to sort current column ascending
 - Press `]` to sort current column descending
 - Multi-column sorting supported (press multiple times on different columns)
 - Press same key twice to remove the column from sorting
 
-### 6. Frequency Distribution
+### 8. Dataframe & Column Metadata
+
+View quick metadata about your dataframe and columns to understand their structure and content.
+
+**Dataframe Metadata** (`m`):
+- Press `m` to open a modal displaying:
+  - **Rows** - Total number of rows in the dataframe
+  - **Columns** - Total number of columns in the dataframe
 
-Press `F` to see how many times each value appears in the current column. The modal shows:
-- Value
-- Count
-- Percentage
-- Histogram
+**Column Metadata** (`M`):
+- Press `M` to open a modal displaying details for all columns:
+  - **ID** - 1-based column index
+  - **Name** - Column name
+  - **Type** - Data type (e.g., Int64, String, Float64, Boolean)
+
+**In Metadata Modals**:
+- Press `q` or `Escape` to close
+
+### 9. Frequency Distribution
+
+Press `F` to see value distributions of the current column. The modal shows:
+- Value, Count, Percentage, Histogram
 - **Total row** at the bottom
 
 **In the Frequency Table**:
 - Press `[` and `]` to sort by any column (value, count, or percentage)
-- Press `v` to **filter** the main table to show only rows with the selected value
-- Press `"` to **exclude** all rows except those containing the selected value
+- Press `v` to **filter** all rows with the selected value (others hidden but preserved)
+- Press `"` to **exclude** all rows containing the selected value (others removed)
 - Press `q` or `Escape` to close the frequency table
 
 This is useful for:
@@ -533,19 +601,11 @@ This is useful for:
 - Identifying rare or common values
 - Finding the most/least frequent entries
 
-### 7. Column & Dataframe Statistics
+### 10. Column & Dataframe Statistics
 
-Press `s` to see summary statistics for the current column, or press `S` for statistics across the entire dataframe.
-
-**Column Statistics** (`s`):
-- Shows calculated statistics using Polars' `describe()` method
-- Displays: count, null count, mean, median, std, min, max, etc.
-- Values are color-coded according to their data type
-- Statistics label column has no styling for clarity
-
-**Dataframe Statistics** (`S`):
-- Shows statistics for all numeric and applicable columns simultaneously
-- Data columns are color-coded by their data type (integer, float, string, etc.)
+Show summary statistics (count, null count, mean, median, std, min, max, etc.) using Polars' `describe()` method.
+- `s` for the current column
+- `S` for all columns across the entire dataframe
 
 **In the Statistics Modal**:
 - Press `q` or `Escape` to close the statistics table
@@ -559,7 +619,7 @@ This is useful for:
 - Quick statistical summaries without external tools
 - Comparing statistics across columns
 
-### 8. Data Editing
+### 11. Data Editing
 
 **Edit Cell** (`e` or **Double-click**):
 - Opens modal for editing current cell
@@ -581,53 +641,31 @@ This is useful for:
 - Useful for removing leading rows or the beginning of a dataset
 
 **Delete Column** (`-`):
-- Removes the entire column from view and dataframe
-
-**Delete Column and After** (`_`):
-- Deletes the current column and all columns to the right
-- Useful for removing trailing columns or the end of a dataset
+- Removes the entire column from display and dataframe
 
-**Delete Column and Before** (`Ctrl+-`):
-- Deletes the current column and all columns to the left
-- Useful for removing leading columns or the beginning of a dataset
+**Add Empty Column** (`a`):
+- Adds a new empty column after the current column
+- Column is initialized with NULL values for all rows
 
-### 9. Hide & Show Columns
+**Add Column with Value/Expression** (`A`):
+- Opens dialog to specify column name and initial value/expression
+- Value can be a constant (e.g., `0`, `"text"`) or a Polars expression (e.g., `$age * 2`)
+- Expression can reference other columns and perform calculations
+- Useful for creating derived columns or adding data with formulas
 
-**Hide Column** (`h`):
-- Temporarily hides the current column from display
-- Column data is preserved in the dataframe
-- Hidden columns are included in saves
-
-**Show Hidden Rows/Columns** (`H`):
-- Restores all previously hidden rows/columns to the display
-
-This is useful for:
-- Focusing on specific columns without deleting data
-- Temporarily removing cluttered or unnecessary columns
-
-### 10. Duplicate Column
-
-Press `d` to duplicate the current column:
+**Duplicate Column** (`d`):
 - Creates a new column immediately after the current column
 - New column has '_copy' suffix (e.g., 'price' → 'price_copy')
-- Duplicate preserves all data from original column
-- New column is inserted into the dataframe
-
-This is useful for:
-- Creating backup copies of columns before transformation
-- Working with alternative versions of column data
-- Comparing original vs. processed column values side-by-side
-
-### 11. Duplicate Row
+- Useful for creating backups before transformation
 
-Press `D` to duplicate the current row:
+**Duplicate Row** (`D`):
 - Creates a new row immediately after the current row
 - Duplicate preserves all data from original row
-- New row is inserted into the dataframe
+- Useful for batch adding similar records
 
-This is useful for:
-- Creating variations of existing data records
-- Batch adding similar rows with modifications
+**Hide/Show Columns** (`h` / `H`):
+- `h` - Temporarily hide current column (data preserved)
+- `H` - Restore all hidden columns and rows
 
 ### 12. Column & Row Reordering
 
@@ -644,7 +682,7 @@ This is useful for:
 Press `z` to open the dialog:
 - Enter number of fixed rows and/or columns to keep top rows/columns visible while scrolling
 
-### 13.5. Thousand Separator Toggle
+### 14. Thousand Separator Toggle
 
 Press `,` to toggle thousand separator formatting for numeric data:
 - Applies to **integer** and **float** columns
@@ -654,14 +692,11 @@ Press `,` to toggle thousand separator formatting for numeric data:
 - Display-only: does not modify underlying data in the dataframe
 - State persists during the session
 
-### 14. Save File
+### 15. Save File
 
-Press `Ctrl+S` to save:
-- Save filtered, edited, or sorted data back to file
-- Choose filename in modal dialog
-- Confirm if file already exists
+Press `Ctrl+S` to save filtered, edited, or sorted data back to file
 
-### 15. Undo/Redo/Reset
+### 16. Undo/Redo/Reset
 
 **Undo** (`u`):
 - Reverts last action with full state restoration
@@ -679,7 +714,7 @@ Press `Ctrl+S` to save:
 - Clears all edits, deletions, selections, filters, and sorts
 - Useful for starting fresh without reloading the file
 
-### 16. Column Type Conversion
+### 17. Column Type Conversion
 
 Press the type conversion keys to instantly cast the current column to a different data type:
 
@@ -696,26 +731,19 @@ Press the type conversion keys to instantly cast the current column to a differe
 
 **Note**: Type conversion attempts to preserve data where possible. Conversions may lose data (e.g., float to int rounding).
 
-### 17. Cursor Type Cycling
+### 18. Cursor Type Cycling
 
 Press `K` to cycle through selection modes:
 1. **Cell mode**: Highlight individual cell (and its row/column headers)
 2. **Row mode**: Highlight entire row
 3. **Column mode**: Highlight entire column
 
-### 18. URL Handling
-
-Press `@` to make URLs in the current column clickable:
-- **Ctrl/Cmd + click** on URLs to open them in your default browser
-- **Scans** all cells in the current column for URLs starting with `http://` or `https://`
-- **Applies** link styling to make them clickable and dataframe remains unchanged
-
 ### 19. SQL Interface
 
 The SQL interface provides two modes for querying your dataframe:
 
 #### Simple SQL Interface (`l`)
-Select specific columns and apply WHERE conditions without writing full SQL:
+SELECT specific columns and apply WHERE conditions without writing full SQL:
 - Choose which columns to include in results
 - Specify WHERE clause for filtering
 - Ideal for quick filtering and column selection
@@ -726,56 +754,77 @@ Execute complete SQL queries for advanced data manipulation:
 - Support for JOINs, GROUP BY, aggregations, and more
 - Access to all SQL capabilities for complex transformations
 - Always use `self` as the table name
+- Syntax highlighted
 
 **Examples:**
 ```sql
 -- Filter and select specific rows and/or columns
-SELECT name, age FROM self WHERE age > 30
-
--- Aggregate with GROUP BY
-SELECT department, COUNT(*) as count, AVG(salary) as avg_salary
+SELECT name, age
 FROM self
-GROUP BY department
+WHERE age > 30
 
--- Complex filtering with multiple conditions
+-- Use backticks (`) for column names with spaces
 SELECT *
 FROM self
-WHERE (age > 25 AND salary > 50000) OR department = 'Management'
+WHERE `product id` = 7
 ```
 
 ### 20. Clipboard Operations
 
-Copies value to system clipboard with `pbcopy` on macOS and `xclip` on Linux
+Copies value to system clipboard with `pbcopy` on macOS and `xclip` on Linux.
+
+**Note** May require a X server to work.
 
-Press `Ctrl+C` to copy:
 - Press `c` to copy cursor value
 - Press `Ctrl+C` to copy column values
 - Press `Ctrl+R` to copy row values (delimited by tab)
+- Hold `Shift` to select with mouse
 
-## Examples
+### 21. Link Column Creation
 
-### Single File Examples
+Press `@` to create a new column containing dynamically generated URLs using template.
 
-```bash
-# View Pokemon dataset
-dv pokemon.csv
+**Template Placeholders:**
 
-# Chain with other command and specify input file format
-cut -d',' -f1,2,3 pokemon.csv | dv -f csv
-```
+The link template supports multiple placeholder types for maximum flexibility:
 
-### Multi-File/Tab Examples
+- **`$_`** - Current column (the column where cursor was when `@` was pressed), e.g., `https://example.com/search/$_` - Uses values from the current column
 
-```bash
-# Open multiple sheets as tabs in a single Excel
-dv sales.xlsx
+- **`$1`, `$2`, `$3`, etc.** - Column by 1-based position index, e.g., `https://example.com/product/$1/details/$2` - Uses 1st and 2nd columns
 
-# Open multiple files as tabs
-dv pokemon.csv titanic.csv
+- **`$name`** - Column by name (use actual column names), e.g., `https://example.com/$region/$city/data` - Uses `region` and `city` columns
 
-# Start with one file, then open others using Ctrl+O
-dv initial_data.csv
-```
+**Features:**
+- **Multiple Placeholders**: Mix and match placeholders in a single template
+- **URL Prefix**: Automatically prepends `https://` if URL doesn't start with `http://` or `https://`
+
+**Tips:**
+- Use full undo (`u`) if template produces unexpected URLs
+- For complex multi-column URLs, use column names (`$name`) for clarity over positions (`$1`)
+
+### 22. Tab Management
+
+Manage multiple files and dataframes simultaneously with tabs.
+
+**Tab Operations:**
+- **`Ctrl+O`** - Open file in a new tab
+- **`>`** - Move to next tab
+- **`<`** - Move to previous tab
+- **`b`** - Cycle through tabs
+- **`B`** - Toggle tab bar visibility
+- **`Double-click`** - Rename the tab
+- **`Ctrl+D`** - Duplicate current tab (creates a copy with same data and state)
+- **`Ctrl+T`** - Save current tab to file
+- **`w`** - Save current tab to file (overwrite without prompt)
+- **`Ctrl+A`** - Save all tabs in a single Excel file
+- **`W`** - Save all tabs to file (overwrite without prompt)
+- **`q`** - Close current tab (closes tab, prompts to save if unsaved changes)
+- **`Q`** - Close all tabs and exit app (prompts to save tabs with unsaved changes)
+- **`Ctrl+Q`** - Force to quit app regardless of unsaved changes
+
+**Tips:**
+- Tabs with unsaved changes are indicated with a bright background
+- Closing or quitting a tab with unsaved changes triggers a save prompt
 
 ## Dependencies