dataframe-textual 0.1.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

dataframe_textual-1.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+dataframe_textual/__init__.py,sha256=uzB3bjlbm8JbsjxEgwqvPcYERktm3F9d9Op_6cWJ1sk,853
+dataframe_textual/__main__.py,sha256=ANe7s2SKO53ksFg-0VrCT2GRCG48wDSAZsLrWvoQwmQ,2082
+dataframe_textual/common.py,sha256=JVGl5ImbC8h9-nodcGZCyNmRcO2VlCF1-yo8Zg8uD90,11583
+dataframe_textual/data_frame_help_panel.py,sha256=XgKGEPJr2hnDWpZ5mavLRcBSPa9cvrXdzVUGFQavXm4,3353
+dataframe_textual/data_frame_table.py,sha256=mOm0pzuN61N01KXi_II6Ld4-NqVYYdiKfzukDMlJpxw,102644
+dataframe_textual/data_frame_viewer.py,sha256=9vUBdIgSoOf4fdDtI4sAPY6cF1tFdsXwpWatyDsuXh0,17196
+dataframe_textual/table_screen.py,sha256=vSevLh944xBTIYVcokABCfSUi84s9gclizx6eDmxyFY,17585
+dataframe_textual/yes_no_screen.py,sha256=vyUKMBbbwgt5At1U430eLg3WbJvqUNoz2GpvdnMd7q0,22921
+dataframe_textual-1.1.0.dist-info/METADATA,sha256=FvSPyXMtELpoIrqfXhzlUkPRb91-6GM16NDwIr-q24g,25378
+dataframe_textual-1.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dataframe_textual-1.1.0.dist-info/entry_points.txt,sha256=Z0XKp1ACvmbJymekkxt-C81I0OoInksr5Ib0w2OT_a4,55
+dataframe_textual-1.1.0.dist-info/licenses/LICENSE,sha256=AVTg0gk1X-LHI-nnHlAMDQetrwuDZK4eypgSMDO46Yc,1069
+dataframe_textual-1.1.0.dist-info/RECORD,,

dataframe_textual-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dv = dataframe_textual.__main__:main

dataframe_textual-0.1.0.dist-info/METADATA

@@ -1,522 +0,0 @@
-Metadata-Version: 2.4
-Name: dataframe-textual
-Version: 0.1.0
-Summary: Interactive CSV/Excel viewer for the terminal (Textual TUI)
-Project-URL: Homepage, https://github.com/need47/dataframe-viewer
-Project-URL: Repository, https://github.com/need47/dataframe-viewer.git
-Project-URL: Documentation, https://github.com/need47/dataframe-viewer#readme
-Project-URL: Bug Tracker, https://github.com/need47/dataframe-viewer/issues
-Author-email: Tiejun Cheng <need47@gmail.com>
-License: MIT
-License-File: LICENSE
-Keywords: csv,data-analysis,interactive,polars,terminal,textual,tui,viewer
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: POSIX
-Classifier: Operating System :: Unix
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Office/Business
-Classifier: Topic :: Utilities
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Requires-Dist: polars>=1.34.0
-Requires-Dist: rich>=14.2.0
-Requires-Dist: textual>=1.0.0
-Provides-Extra: dev
-Requires-Dist: textual-dev>=1.8.0; extra == 'dev'
-Provides-Extra: excel
-Requires-Dist: fastexcel>=0.16.0; extra == 'excel'
-Requires-Dist: xlsxwriter>=3.2.9; extra == 'excel'
-Description-Content-Type: text/markdown
-
-# DataFrame Viewer
-
-A powerful, interactive terminal-based CSV viewer built with Python, Polars, and Textual. Inspired by VisiData, this tool provides smooth keyboard navigation, data manipulation, and a clean interface for exploring CSV data directly in your terminal. Now with **multi-file support for simultaneous data comparison**!
-
-![Screenshot](https://raw.githubusercontent.com/need47/dataframe-viewer/refs/heads/main/screenshot.png)
-
-## Features
-
-### Core Data Viewing
-- 🚀 **Fast CSV Loading** - Powered by Polars for efficient data handling with lazy pagination
-- 🎨 **Rich Terminal UI** - Beautiful, color-coded columns with automatic type detection
-- ⌨️ **Comprehensive Keyboard Navigation** - Intuitive controls for browsing, editing, and manipulating data
-- 📊 **Flexible Input** - Read from files or stdin (pipes/redirects)
-- 🔄 **Smart Pagination** - Lazy load rows on demand for handling large datasets
-
-### Data Manipulation
-- 📝 **Data Editing** - Edit cells, delete rows, and remove columns
-- 🔍 **Search & Filter** - Find values, highlight matches, and filter selected rows
-- ↔️ **Column/Row Reordering** - Move columns and rows with simple keyboard shortcuts
-- 📈 **Sorting & Statistics** - Multi-column sorting and frequency distribution analysis
-- 💾 **Save & Undo** - Save filtered data back to CSV with full undo/redo support
-
-### Advanced Features
-- 📌 **Pin Rows/Columns** - Keep important rows and columns visible while scrolling
-- 🎯 **Cursor Type Cycling** - Switch between cell, row, and column selection modes
-- 📂 **Multi-File Support** - Open multiple CSV files in tabs for side-by-side comparison
-- 🔄 **Tab Management** - Seamlessly switch between open files with keyboard shortcuts
-
-## Installation
-
-### Using uv (recommended)
-
-```bash
-# Clone or download the project
-cd dataframe-viewer
-
-# Run directly with uv
-uv run python main.py <csv_file>
-```
-
-### Using pip
-
-```bash
-pip install polars textual
-python main.py <csv_file>
-```
-
-## Usage
-
-### Basic Usage - Single File
-
-```bash
-# View a CSV file
-python main.py pokemon.csv
-
-# Or with uv
-uv run python main.py pokemon.csv
-
-# Read from stdin
-cat data.csv | python main.py
-python main.py < data.csv
-```
-
-### Multi-File Usage - Multiple Tabs
-
-```bash
-# Open multiple files in tabs
-python main.py file1.csv file2.csv file3.csv
-
-# Open multiple sheets in tabs in an Excel file
-python main.py file.xlsx
-
-# Or with uv
-uv run python main.py file1.csv file2.csv file3.csv
-
-# Mix files and stdin (file opens first, then read from stdin)
-python main.py data1.csv < data2.csv
-```
-
-When multiple files are opened:
-- Each file appears as a separate tab at the top
-- Switch between tabs using `>` (next) or `<` (previous)
-- Open additional files with `Ctrl+O`
-- Close the current tab with `Ctrl+W`
-- Each file maintains its own state (sort order, selections, history, etc.)
-- Edits and filters are independent per file
-
-## Keyboard Shortcuts
-
-### App-Level Controls
-
-#### File & Tab Management
-
-| Key | Action |
-|-----|--------|
-| `Ctrl+O` | Open new CSV file in a new tab |
-| `Ctrl+W` | Close current tab |
-| `Ctrl+Shift+S` | Save all open tabs to Excel file |
-| `>` or `b` | Move to next tab |
-| `<` | Move to previous tab |
-| `B` | Toggle tab bar visibility |
-| `q` | Quit the application |
-
-#### View & Settings
-
-| Key | Action |
-|-----|--------|
-| `?` or `h` | Toggle help panel (context-sensitive) |
-| `k` | Cycle through themes |
-
----
-
-### Table-Level Controls
-
-#### Navigation
-
-| Key | Action |
-|-----|--------|
-| `g` | Jump to first row |
-| `G` | Jump to last row (loads all remaining rows) |
-| `↑` / `↓` | Move up/down one row |
-| `←` / `→` | Move left/right one column |
-| `PageDown` / `PageUp` | Scroll down/up |
-| Arrow keys | Navigate the table |
-
-#### Viewing & Display
-
-| Key | Action |
-|-----|--------|
-| `Enter` | View full details of current row in modal |
-| `F` | Show frequency distribution for column |
-| `C` | Cycle cursor type: cell → row → column → cell |
-| `#` | Toggle row labels visibility |
-
-#### Data Editing
-
-| Key | Action |
-|-----|--------|
-| `e` | Edit current cell (respects data type) |
-| `d` | Delete current row |
-| `-` | Delete current column |
-
-#### Searching & Filtering
-
-| Key | Action |
-|-----|--------|
-| `\|` (pipe) | Search in current column (case-insensitive) |
-| `/` (slash) | Global search across all columns |
-| `\` | Search current column using cell value |
-| `s` | Select/deselect current row |
-| `t` | Toggle highlighting of all selected rows (invert) |
-| `T` | Clear all selected rows |
-| `"` (quote) | Filter to show only selected rows |
-| `v` | Filter by selected rows (if any) or current cell value |
-| `V` | Filter by expression (Polars expression syntax) |
-
-#### Sorting
-
-| Key | Action |
-|-----|--------|
-| `[` | Sort current column ascending |
-| `]` | Sort current column descending |
-
-#### Reordering
-
-| Key | Action |
-|-----|--------|
-| `Shift+↑` | Move current row up |
-| `Shift+↓` | Move current row down |
-| `Shift+←` | Move current column left |
-| `Shift+→` | Move current column right |
-
-#### Data Management
-
-| Key | Action |
-|-----|--------|
-| `f` | Freeze rows and columns |
-| `c` | Copy current cell to clipboard |
-| `Ctrl+S` | Save current tab to CSV/TSV file |
-| `u` | Undo last action |
-| `U` | Reset to original data |
-
-#### Modal Interactions
-
-**In Frequency Distribution Modal** (opened with `F`):
-- `[` / `]` - Sort frequency table
-- `v` - Filter main table to selected value
-- `"` - Highlight rows with selected value
-- `q` / `Escape` - Close modal
-
-**In Row Detail Modal** (opened with `Enter`):
-- `v` - Filter main table to selected column value
-- `"` - Highlight rows with selected column value
-- `q` / `Escape` - Close modal
-
-**Tip**: Press `?` or `h` to open the context-sensitive help panel which displays all available shortcuts based on your current focus.
-
-## Features in Detail
-
-### 1. Color-Coded Data Types
-
-Columns are automatically styled based on their data type:
-- **Int64** (Integers): Cyan text, right-aligned
-- **Float64** (Decimals): Magenta text, right-aligned
-- **String**: Green text, left-aligned
-- **Boolean**: Blue text, centered
-- **Date/Datetime**: Blue 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.
-
-**In the Row Detail Modal**:
-- Press `v` to **filter** the main table to show only rows with the selected column value
-- Press `"` to **highlight** all rows containing the selected column value
-- Press `q` or `Escape` to close the modal
-
-### 3. Search & Filtering
-
-**Column Search** (`|`):
-- Search for values in the current column
-- Case-insensitive substring matching
-- All matching rows are highlighted in red
-- Multiple searches accumulate selections
-
-**Global Search** (`/`):
-- Search for a term across all columns simultaneously
-- Cell-level highlighting in red for each matching cell
-- Useful for finding a value anywhere in the dataset
-- Automatically loads rows if matches extend beyond visible area
-- Type-aware matching: converts values to strings before comparing
-
-**Cell-Value Search** (`\`):
-- Automatically search using the current cell's value
-- Quick way to find all occurrences of a value
-
-**Row Filtering** (`"`):
-- Display only the selected (highlighted) rows
-- Other rows are hidden but preserved
-- Use undo (`u`) to restore
-
-### 4. Filter by Expression
-
-Press `f` to open a powerful filter expression dialog. This allows you to write complex filter conditions using a special syntax:
-
-**Column References:**
-- `$_` - Current column (based on cursor position)
-- `$1`, `$2`, etc. - Column by 1-based index
-- `$age`, `$salary` - Column by name
-
-**Operators:**
-- Comparison: `==`, `!=`, `<`, `>`, `<=`, `>=`
-- Logical: `&&` (AND), `||` (OR)
-- Arithmetic: `+`, `-`, `*`, `/`, `%`
-
-**Examples:**
-- `$_ > 50` - Current column greater than 50
-- `$salary >= 100000` - Salary at least 100,000
-- `$age < 30 && $status == 'active'` - Age less than 30 AND status is active
-- `$name == 'Alice' || $name == 'Bob'` - Name is Alice or Bob
-- `$salary / 1000 >= 50` - Salary divided by 1,000 is at least 50
-
-See [FILTER_EXPRESSION_GUIDE.md](FILTER_EXPRESSION_GUIDE.md) for comprehensive syntax documentation.
-
-### 5. 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 toggle direction
-- Frequency view (`F`) shows value distribution with optional sorting
-
-### 6. Frequency Distribution
-
-Press `F` to see how many times each value appears in the current column. The modal shows:
-- Value
-- Count
-- Percentage of total
-- **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 **highlight** all rows containing the selected value
-- Press `q` or `Escape` to close the frequency table
-
-This is useful for:
-- Understanding value distributions
-- Quickly filtering to specific values
-- Identifying rare or common values
-- Finding the most/least frequent entries
-
-### 7. Data Editing
-
-**Edit Cell** (`e`):
-- Opens modal for editing current cell
-- Validates input based on column data type
-- Shows column name and type
-- Integer, number, and text inputs available
-
-**Delete Row** (`d`):
-- Delete single row at cursor
-- Or delete all selected rows at once
-- Deleted rows are marked internally but kept for undo
-
-**Delete Column** (`-`):
-- Removes the entire column from view and dataframe
-- Cannot be undone directly (use undo feature)
-
-### 8. Column & Row Reordering
-
-**Move Columns**: `Shift+←` and `Shift+→`
-- Swaps adjacent columns
-- Reorder is preserved when saving
-
-**Move Rows**: `Shift+↑` and `Shift+↓`
-- Swaps adjacent rows
-- Visual reordering without affecting data
-
-### 9. Pin Rows and Columns
-
-Press `f` to open the pin dialog:
-- Enter number of fixed rows: keeps top rows visible while scrolling
-- Enter two numbers: `<rows> <columns>` (space-separated)
-- Example: `2 3` pins top 2 rows and left 3 columns
-
-### 10. Save to CSV
-
-Press `Ctrl+S` to save:
-- Save filtered, edited, or sorted data back to CSV
-- Choose filename in modal dialog
-- Confirm if file already exists
-- Automatic .tsv or .csv detection
-
-### 11. Undo/Redo
-
-Press `u` to undo:
-- Reverts last action with full state restoration
-- Works for edits, deletions, sorts, searches, etc.
-- Shows description of reverted action
-
-### 12. Cursor Type Cycling
-
-Press `C` 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
-
-Visual feedback shows which mode is active.
-
-### 13. Clipboard Operations
-
-Press `c` to copy:
-- Copies current cell value to system clipboard
-- Works on macOS (`pbcopy`) and Linux (`xclip`)
-- Shows confirmation notification
-
-## Data Type Support
-
-- **Int64, Int32, UInt32**: Integer values
-- **Float64, Float32**: Decimal numbers (shown with 4 significant figures)
-- **String**: Text data
-- **Boolean**: True/False values
-- **Date**: ISO date format (YYYY-MM-DD)
-- **Datetime**: ISO datetime format
-- **Null values**: Displayed as `-`
-
-## Examples
-
-### Single File Examples
-
-```bash
-# View Pokemon dataset
-python main.py pokemon.csv
-
-# View Titanic dataset with analysis
-python main.py titanic.csv
-
-# Filter and view specific columns
-cut -d',' -f1,2,3 pokemon.csv | python main.py
-
-# View with grep filter (then use | search in viewer)
-grep "Fire" pokemon.csv | python main.py
-
-# Chain with other commands
-cat data.csv | sort -t',' -k2 | python main.py
-```
-
-### Multi-File Examples
-
-```bash
-# Compare two versions of a dataset
-python main.py pokemon_v1.csv pokemon_v2.csv
-
-# Side-by-side analysis of related files
-python main.py sales_2022.csv sales_2023.csv forecast_2024.csv
-
-# Cross-reference datasets
-python main.py customers.csv orders.csv products.csv
-
-# Start with one file, open others using Ctrl+O
-python main.py initial_data.csv
-# Then press Ctrl+O to open more files interactively
-```
-
-### Advanced Workflows
-
-```bash
-# Start with a filtered file, compare with original
-grep "status=active" data.csv > filtered.csv
-python main.py data.csv filtered.csv
-# Now compare the full dataset with the filtered version in separate tabs
-
-# Multi-step analysis
-# 1. Open multiple related CSVs
-# 2. Use Ctrl+O to open additional files as you discover relationships
-# 3. Each tab maintains independent sort/filter/search state
-# 4. Use Ctrl+W to close tabs when done analyzing
-```
-
-## Performance
-
-- **Lazy loading**: Only loads visible rows + 10 rows ahead
-- **Efficient sorting**: Uses Polars' optimized sort algorithms
-- **Smooth scrolling**: No lag when paging through large files
-- **Memory efficient**: Handles datasets larger than RAM
-
-Tested with:
-- 10,000+ row CSV files
-- Wide datasets (100+ columns)
-- Various data types and sizes
-
-## Dependencies
-
-- **polars**: Fast DataFrame library for CSV processing
-- **textual**: Terminal UI framework
-- **rich**: Rich text and formatting in the terminal
-
-## Architecture Overview
-
-### Single-Table Design
-
-The core of the application is built around the `DataFrameTable` widget:
-
-- **Self-contained**: Each table instance maintains its own complete state (13 independent variables)
-- **Fully autonomous**: All operations (editing, sorting, filtering, searching) are handled within the table
-- **Event-driven**: Each table owns and handles its keyboard events
-- **Backward compatible**: Works identically in single-file mode
-
-### Multi-Table Design
-
-The `DataFrameApp` coordinates multiple independent `DataFrameTable` instances:
-
-- **Tab-based interface**: Uses Textual's `TabbedContent` for tab management
-- **Independent state**: Each tab has completely separate state (sort order, selections, history)
-- **Seamless switching**: Switch between files without losing context or state
-- **File management**: Open/close files dynamically without restarting the application
-
-### State Isolation
-
-Each `DataFrameTable` instance owns:
-- DataFrame (`self.df`)
-- Sorted columns (`self.sorted_columns`)
-- Selected rows (`self.selected_rows`)
-- Edit history (`self.histories`)
-- Cursor state (position, type)
-- Search/filter state
-- And 8 more internal state variables
-
-This ensures perfect isolation between tabs with zero cross-contamination.
-
-## Requirements
-
-- Python 3.11+
-- POSIX-compatible terminal (macOS, Linux, WSL)
-- Terminal supporting ANSI escape sequences and mouse events
-
-## Acknowledgments
-
-- Inspired by [VisiData](https://visidata.org/)
-- Built with [Textual](https://textual.textualize.io/), [Polars](https://www.pola.rs/), and [Rich](https://rich.readthedocs.io/)
-- All code created through iterative development

dataframe_textual-0.1.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-dataframe_viewer/__init__.py,sha256=uzB3bjlbm8JbsjxEgwqvPcYERktm3F9d9Op_6cWJ1sk,853
-dataframe_viewer/__main__.py,sha256=LPLyZcv4hAFfF3hUt1S2dtZOqaAZnlguicgwiDrtXgk,1349
-dataframe_viewer/common.py,sha256=3zzhI__F_hoOFDRe-wt-oTfMDFik1ohraIa6rXcVit8,6357
-dataframe_viewer/data_frame_help_panel.py,sha256=SQ2lulb1SPxItR9tMvIgOzzeCcW9SB1rRojAcwZ7Vis,2730
-dataframe_viewer/data_frame_table.py,sha256=u_gMc-U57efgIRoCfOR65clieK7M7FUg45jjUb06V_w,50079
-dataframe_viewer/data_frame_viewer.py,sha256=BP-pCYIG5bEDFkUmUyA3sxWc3z1zI_viClDZlT-s_uE,11715
-dataframe_viewer/table_screen.py,sha256=Pq6aM-vntDxLj1r5Uzke6_pzbuhO-VrX_V12ezwm3uM,10588
-dataframe_viewer/yes_no_screen.py,sha256=z7MEVTMepFuGWFIthhQlAT3m69D6lgIl4tb2_oJAWWQ,13207
-dataframe_textual-0.1.0.dist-info/METADATA,sha256=83coV75y1bb8xOM0FhcHWqLGEltMlMRfFuwLKJ4MFNY,16559
-dataframe_textual-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dataframe_textual-0.1.0.dist-info/entry_points.txt,sha256=KSovZ8BMRj1HTXuXh9aNF9Uw0TZiNSJgdg6EoPEdsmA,69
-dataframe_textual-0.1.0.dist-info/licenses/LICENSE,sha256=AVTg0gk1X-LHI-nnHlAMDQetrwuDZK4eypgSMDO46Yc,1069
-dataframe_textual-0.1.0.dist-info/RECORD,,

dataframe_textual-0.1.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-dataframe-textual = dataframe_viewer.__main__:main

dataframe_viewer/__main__.py

@@ -1,48 +0,0 @@
-"""Entry point for running DataFrameViewer as a module."""
-
-import argparse
-import sys
-from pathlib import Path
-
-from .data_frame_viewer import DataFrameViewer
-
-
-def main():
-    """Run the DataFrame Viewer application."""
-    parser = argparse.ArgumentParser(
-        description="Interactive CSV/Excel viewer for the terminal (Textual version)",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="Examples:\n"
-        "  dataframe-viewer data.csv\n"
-        "  dataframe-viewer file1.csv file2.csv file3.csv\n"
-        "  dataframe-viewer data.xlsx  (opens all sheets in tabs)\n"
-        "  cat data.csv | dataframe-viewer\n",
-    )
-    parser.add_argument(
-        "files", nargs="*", help="CSV or Excel files to view (or read from stdin)"
-    )
-
-    args = parser.parse_args()
-    filenames = []
-
-    # Check if reading from stdin (pipe or redirect)
-    if not sys.stdin.isatty():
-        filenames = ["-"]
-    elif args.files:
-        # Validate all files exist
-        for filename in args.files:
-            if not Path(filename).exists():
-                print(f"File not found: {filename}")
-                sys.exit(1)
-        filenames = args.files
-
-    if not filenames:
-        parser.print_help()
-        sys.exit(1)
-
-    app = DataFrameViewer(*filenames)
-    app.run()
-
-
-if __name__ == "__main__":
-    main()