dataframe-textual 0.1.0__tar.gz → 0.3.0__tar.gz

{dataframe_textual-0.1.0 → dataframe_textual-0.3.0}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: dataframe-textual
-Version: 0.1.0
+Version: 0.3.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
+Project-URL: Homepage, https://github.com/need47/dataframe-textual
+Project-URL: Repository, https://github.com/need47/dataframe-textual.git
+Project-URL: Documentation, https://github.com/need47/dataframe-textual#readme
+Project-URL: Bug Tracker, https://github.com/need47/dataframe-textual/issues
 Author-email: Tiejun Cheng <need47@gmail.com>
 License: MIT
 License-File: LICENSE
-Keywords: csv,data-analysis,interactive,polars,terminal,textual,tui,viewer
+Keywords: csv,data-analysis,excel,interactive,polars,terminal,textual,tui,viewer
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -29,7 +29,6 @@ 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'
@@ -38,11 +37,11 @@ Requires-Dist: fastexcel>=0.16.0; extra == 'excel'
 Requires-Dist: xlsxwriter>=3.2.9; extra == 'excel'
 Description-Content-Type: text/markdown
 
-# DataFrame Viewer
+# DataFrame Viewer/Editor
 
-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**!
+A powerful, interactive terminal-based CSV/Excel viewer/editor built with Python, Polars, and Textual. Inspired by VisiData, this tool provides smooth keyboard navigation, data manipulation, and a clean interface for exploring tabular 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)
+![Screenshot](https://raw.githubusercontent.com/need47/dataframe-textual/refs/heads/main/screenshot.png)
 
 ## Features
 
@@ -68,21 +67,48 @@ A powerful, interactive terminal-based CSV viewer built with Python, Polars, and
 
 ## Installation
 
-### Using uv (recommended)
+### Using pip
+
+```bash
+# Install from PyPI
+pip install dataframe-textual
+
+# With Excel support (fastexcel, xlsxwriter)
+pip install dataframe-textual[excel]
+```
+
+Then run:
+```bash
+dataframe-textual <csv_file>
+```
+
+### Using uv
 
 ```bash
+# Quick run using uvx without installation
+uvx https://github.com/need47/dataframe-textual.git <csvfile>
+
 # Clone or download the project
-cd dataframe-viewer
+cd dataframe-textual
 
 # Run directly with uv
 uv run python main.py <csv_file>
+
+#
 ```
 
-### Using pip
+### Development installation
 
 ```bash
-pip install polars textual
-python main.py <csv_file>
+# Clone the repository
+git clone https://github.com/need47/dataframe-textual.git
+cd dataframe-textual
+
+# Install from local source
+pip install -e .
+
+# Or with development dependencies
+pip install -e ".[excel,dev]"
 ```
 
 ## Usage
@@ -90,31 +116,31 @@ python main.py <csv_file>
 ### Basic Usage - Single File
 
 ```bash
-# View a CSV file
+# After pip install dataframe-textual
+dataframe-textual pokemon.csv
+
+# Or if running from source
 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
+cat data.csv | dataframe-textual
+dataframe-textual < data.csv
 ```
 
 ### Multi-File Usage - Multiple Tabs
 
 ```bash
 # Open multiple files in tabs
-python main.py file1.csv file2.csv file3.csv
+dataframe-textual 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
+dataframe-textual file.xlsx
 
 # Mix files and stdin (file opens first, then read from stdin)
-python main.py data1.csv < data2.csv
+dataframe-textual data1.csv < data2.csv
 ```
 
 When multiple files are opened:
@@ -411,35 +437,35 @@ Press `c` to copy:
 
 ```bash
 # View Pokemon dataset
-python main.py pokemon.csv
+dataframe-textual pokemon.csv
 
 # View Titanic dataset with analysis
-python main.py titanic.csv
+dataframe-textual titanic.csv
 
 # Filter and view specific columns
-cut -d',' -f1,2,3 pokemon.csv | python main.py
+cut -d',' -f1,2,3 pokemon.csv | dataframe-textual
 
 # View with grep filter (then use | search in viewer)
-grep "Fire" pokemon.csv | python main.py
+grep "Fire" pokemon.csv | dataframe-textual
 
 # Chain with other commands
-cat data.csv | sort -t',' -k2 | python main.py
+cat data.csv | sort -t',' -k2 | dataframe-textual
 ```
 
 ### Multi-File Examples
 
 ```bash
 # Compare two versions of a dataset
-python main.py pokemon_v1.csv pokemon_v2.csv
+dataframe-textual 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
+dataframe-textual sales_2022.csv sales_2023.csv forecast_2024.csv
 
 # Cross-reference datasets
-python main.py customers.csv orders.csv products.csv
+dataframe-textual customers.csv orders.csv products.csv
 
 # Start with one file, open others using Ctrl+O
-python main.py initial_data.csv
+dataframe-textual initial_data.csv
 # Then press Ctrl+O to open more files interactively
 ```
 
@@ -448,7 +474,7 @@ python main.py initial_data.csv
 ```bash
 # Start with a filtered file, compare with original
 grep "status=active" data.csv > filtered.csv
-python main.py data.csv filtered.csv
+dataframe-textual data.csv filtered.csv
 # Now compare the full dataset with the filtered version in separate tabs
 
 # Multi-step analysis

{dataframe_textual-0.1.0 → dataframe_textual-0.3.0}/README.md

@@ -1,8 +1,8 @@
-# DataFrame Viewer
+# DataFrame Viewer/Editor
 
-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**!
+A powerful, interactive terminal-based CSV/Excel viewer/editor built with Python, Polars, and Textual. Inspired by VisiData, this tool provides smooth keyboard navigation, data manipulation, and a clean interface for exploring tabular 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)
+![Screenshot](https://raw.githubusercontent.com/need47/dataframe-textual/refs/heads/main/screenshot.png)
 
 ## Features
 
@@ -28,21 +28,48 @@ A powerful, interactive terminal-based CSV viewer built with Python, Polars, and
 
 ## Installation
 
-### Using uv (recommended)
+### Using pip
+
+```bash
+# Install from PyPI
+pip install dataframe-textual
+
+# With Excel support (fastexcel, xlsxwriter)
+pip install dataframe-textual[excel]
+```
+
+Then run:
+```bash
+dataframe-textual <csv_file>
+```
+
+### Using uv
 
 ```bash
+# Quick run using uvx without installation
+uvx https://github.com/need47/dataframe-textual.git <csvfile>
+
 # Clone or download the project
-cd dataframe-viewer
+cd dataframe-textual
 
 # Run directly with uv
 uv run python main.py <csv_file>
+
+#
 ```
 
-### Using pip
+### Development installation
 
 ```bash
-pip install polars textual
-python main.py <csv_file>
+# Clone the repository
+git clone https://github.com/need47/dataframe-textual.git
+cd dataframe-textual
+
+# Install from local source
+pip install -e .
+
+# Or with development dependencies
+pip install -e ".[excel,dev]"
 ```
 
 ## Usage
@@ -50,31 +77,31 @@ python main.py <csv_file>
 ### Basic Usage - Single File
 
 ```bash
-# View a CSV file
+# After pip install dataframe-textual
+dataframe-textual pokemon.csv
+
+# Or if running from source
 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
+cat data.csv | dataframe-textual
+dataframe-textual < data.csv
 ```
 
 ### Multi-File Usage - Multiple Tabs
 
 ```bash
 # Open multiple files in tabs
-python main.py file1.csv file2.csv file3.csv
+dataframe-textual 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
+dataframe-textual file.xlsx
 
 # Mix files and stdin (file opens first, then read from stdin)
-python main.py data1.csv < data2.csv
+dataframe-textual data1.csv < data2.csv
 ```
 
 When multiple files are opened:
@@ -371,35 +398,35 @@ Press `c` to copy:
 
 ```bash
 # View Pokemon dataset
-python main.py pokemon.csv
+dataframe-textual pokemon.csv
 
 # View Titanic dataset with analysis
-python main.py titanic.csv
+dataframe-textual titanic.csv
 
 # Filter and view specific columns
-cut -d',' -f1,2,3 pokemon.csv | python main.py
+cut -d',' -f1,2,3 pokemon.csv | dataframe-textual
 
 # View with grep filter (then use | search in viewer)
-grep "Fire" pokemon.csv | python main.py
+grep "Fire" pokemon.csv | dataframe-textual
 
 # Chain with other commands
-cat data.csv | sort -t',' -k2 | python main.py
+cat data.csv | sort -t',' -k2 | dataframe-textual
 ```
 
 ### Multi-File Examples
 
 ```bash
 # Compare two versions of a dataset
-python main.py pokemon_v1.csv pokemon_v2.csv
+dataframe-textual 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
+dataframe-textual sales_2022.csv sales_2023.csv forecast_2024.csv
 
 # Cross-reference datasets
-python main.py customers.csv orders.csv products.csv
+dataframe-textual customers.csv orders.csv products.csv
 
 # Start with one file, open others using Ctrl+O
-python main.py initial_data.csv
+dataframe-textual initial_data.csv
 # Then press Ctrl+O to open more files interactively
 ```
 
@@ -408,7 +435,7 @@ python main.py initial_data.csv
 ```bash
 # Start with a filtered file, compare with original
 grep "status=active" data.csv > filtered.csv
-python main.py data.csv filtered.csv
+dataframe-textual data.csv filtered.csv
 # Now compare the full dataset with the filtered version in separate tabs
 
 # Multi-step analysis

{dataframe_textual-0.1.0 → dataframe_textual-0.3.0}/main.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 """Entry point for DataFrameViewer."""
 
-from dataframe_viewer.__main__ import main
+from dataframe_textual.__main__ import main
 
 if __name__ == "__main__":
     main()

{dataframe_textual-0.1.0 → dataframe_textual-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dataframe-textual"
-version = "0.1.0"
+version = "0.3.0"
 description = "Interactive CSV/Excel viewer for the terminal (Textual TUI)"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -12,7 +12,7 @@ license = {text = "MIT"}
 authors = [
     {name = "Tiejun Cheng", email = "need47@gmail.com"}
 ]
-keywords = ["csv", "viewer", "terminal", "tui", "textual", "data-analysis", "polars", "interactive"]
+keywords = ["csv", "excel", "viewer", "terminal", "tui", "textual", "data-analysis", "polars", "interactive"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Environment :: Console",
@@ -34,15 +34,14 @@ classifiers = [
 ]
 dependencies = [
     "polars>=1.34.0",
-    "rich>=14.2.0",
     "textual>=1.0.0",
 ]
 
 [project.urls]
-Homepage = "https://github.com/need47/dataframe-viewer"
-Repository = "https://github.com/need47/dataframe-viewer.git"
-Documentation = "https://github.com/need47/dataframe-viewer#readme"
-"Bug Tracker" = "https://github.com/need47/dataframe-viewer/issues"
+Homepage = "https://github.com/need47/dataframe-textual"
+Repository = "https://github.com/need47/dataframe-textual.git"
+Documentation = "https://github.com/need47/dataframe-textual#readme"
+"Bug Tracker" = "https://github.com/need47/dataframe-textual/issues"
 
 [project.optional-dependencies]
 excel = [
@@ -54,7 +53,12 @@ dev = [
 ]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/dataframe_viewer"]
+packages = ["src/dataframe_textual"]
+
+[dependency-groups]
+dev = [
+    "textual-dev>=1.8.0",
+]
 
 [project.scripts]
-dataframe-textual = "dataframe_viewer.__main__:main"
+dataframe-textual = "dataframe_textual.__main__:main"

{dataframe_textual-0.1.0/src/dataframe_viewer → dataframe_textual-0.3.0/src/dataframe_textual}/table_screen.py

@@ -6,6 +6,7 @@ import polars as pl
 from rich.text import Text
 from textual.app import ComposeResult
 from textual.coordinate import Coordinate
+from textual.renderables.bar import Bar
 from textual.screen import ModalScreen
 from textual.widgets import DataTable
 
@@ -136,6 +137,8 @@ class RowDetailScreen(TableScreen):
                 *_format_row([col, val], [None, dtype], apply_justify=False)
             )
 
+        self.table.cursor_type = "row"
+
     def on_key(self, event):
         if event.key == "v":
             # Filter the main table by the selected value
@@ -188,6 +191,7 @@ class FrequencyScreen(TableScreen):
         self.table.add_column(Text(column, justify=dc.justify), key=column)
         self.table.add_column(Text("Count", justify="right"), key="Count")
         self.table.add_column(Text("%", justify="right"), key="%")
+        self.table.add_column(Text("Histogram", justify="left"), key="Histogram")
 
         # Get style config for Int64 and Float64
         ds_int = DtypeConfig("Int64")
@@ -204,16 +208,16 @@ class FrequencyScreen(TableScreen):
                     style=dc.style,
                     justify=dc.justify,
                 ),
-                Text(
-                    str(count),
-                    style=ds_int.style,
-                    justify=ds_int.justify,
-                ),
+                Text(str(count), style=ds_int.style, justify=ds_int.justify),
                 Text(
                     f"{percentage:.2f}",
                     style=ds_float.style,
                     justify=ds_float.justify,
                 ),
+                Bar(
+                    highlight_range=(0.0, percentage / 100 * 10),
+                    width=10,
+                ),
                 key=str(row_idx + 1),
             )
 

{dataframe_textual-0.1.0 → dataframe_textual-0.3.0}/uv.lock

@@ -170,12 +170,11 @@ wheels = [
 ]
 
 [[package]]
-name = "dataframe-viewer"
-version = "0.1.0"
+name = "dataframe-textual"
+version = "0.3.0"
 source = { editable = "." }
 dependencies = [
     { name = "polars" },
-    { name = "rich" },
     { name = "textual" },
 ]
 
@@ -188,17 +187,24 @@ excel = [
     { name = "xlsxwriter" },
 ]
 
+[package.dev-dependencies]
+dev = [
+    { name = "textual-dev" },
+]
+
 [package.metadata]
 requires-dist = [
     { name = "fastexcel", marker = "extra == 'excel'", specifier = ">=0.16.0" },
     { name = "polars", specifier = ">=1.34.0" },
-    { name = "rich", specifier = ">=14.2.0" },
     { name = "textual", specifier = ">=1.0.0" },
     { name = "textual-dev", marker = "extra == 'dev'", specifier = ">=1.8.0" },
     { name = "xlsxwriter", marker = "extra == 'excel'", specifier = ">=3.2.9" },
 ]
 provides-extras = ["excel", "dev"]
 
+[package.metadata.requires-dev]
+dev = [{ name = "textual-dev", specifier = ">=1.8.0" }]
+
 [[package]]
 name = "fastexcel"
 version = "0.16.0"