csvpeek 0.9.0__py3-none-any.whl

csvpeek-0.9.0.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: csvpeek
+Version: 0.9.0
+Summary: A snappy CSV viewer TUI - peek at your data fast
+Project-URL: Homepage, https://github.com/giantatwork/csvpeek
+Project-URL: Repository, https://github.com/giantatwork/csvpeek
+Project-URL: Issues, https://github.com/giantatwork/csvpeek/issues
+Author-email: Giant at Work <info@giantatwork.nl>
+License: MIT
+License-File: LICENSE
+Keywords: csv,data,duckdb,terminal,tui,urwid,viewer
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: duckdb>=1.1.0
+Requires-Dist: pyperclip>=1.8.0
+Requires-Dist: urwid>=2.1.0
+Description-Content-Type: text/markdown
+
+# csvpeek
+
+> A fast CSV viewer in your terminal - peek at your data instantly ⚡
+
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Python](https://img.shields.io/badge/python-3.10+-blue.svg)
+
+**Csvpeek** is a snappy, memory-efficient CSV viewer built for speed. Powered by [DuckDB](https://duckdb.org/) for fast SQL-backed querying and [Urwid](https://urwid.org/) for a lean terminal UI.
+
+## Features
+
+- **Fast** - DuckDB streaming with LIMIT/OFFSET keeps startup instant, even with huge files
+- **Large File Support** - Pagination handles millions of rows without breaking a sweat
+- **Cell Selection** - Select and copy ranges with keyboard shortcuts
+- **Column Sorting** - Sort by any column instantly
+- **Keyboard-First** - Every action is a keystroke away
+
+## Quick Start
+
+### Installation
+
+```bash
+uv tool install csvpeek
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/giantatwork/csvpeek.git
+cd csvpeek
+pip install -e .
+```
+
+#### Windows
+
+Install the [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist) to ensure DuckDB works on Windows
+
+### Usage
+
+```bash
+csvpeek your_data.csv
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `/` | Open filter dialog |
+| `r` | Reset all filters |
+| `Ctrl+D` | Next page |
+| `Ctrl+U` | Previous page |
+| `s` | Sort current column |
+| `c` | Copy selection to clipboard |
+| `w` | Save selection to file |
+| `Shift+Arrow` | Select cells |
+| `Arrow Keys` | Navigate (clears selection) |
+| `q` | Quit |
+
+## Usage Examples
+
+### Basic Viewing
+Open any CSV file and start navigating immediately:
+```bash
+csvpeek data.csv
+```
+
+### Filtering
+1. Press `/` to open the filter dialog
+2. Enter filter values for any columns
+3. Press `Enter` to apply
+4. Filter matches are highlighted in red
+
+**Filter modes:**
+- **Literal mode**: Case-insensitive substring search (e.g., `scranton` matches "Scranton")
+- **Regex mode**: Start with `/` for regex patterns (e.g., `/^J` matches names starting with J)
+  - `/\d+` - Contains digits
+  - `/sales|eng` - Contains "sales" OR "eng"
+  - `/^test$` - Exactly "test"
+  - All regex patterns are case-insensitive
+
+### Sorting
+1. Navigate to any column
+2. Press `s` to sort by that column
+3. Press `s` again to toggle ascending/descending
+
+### Selection & Copy
+1. Position cursor on starting cell
+2. Hold `Shift` and use arrow keys to select a range
+3. Press `c` to copy selection as tab-separated values
+4. Paste anywhere with `Ctrl+V`
+
+
+
+## Requirements
+- Python 3.12+
+- DuckDB >= 1.1.0
+- Urwid >= 2.1.0
+- Pyperclip >= 1.9.0
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Acknowledgments
+
+Built with amazing open-source tools:
+- [DuckDB](https://duckdb.org/) - Embedded analytics database
+- [Urwid](https://urwid.org/) - Lightweight terminal UI toolkit
+
+## Contact
+
+Found a bug? Have a feature request? [Open an issue](https://github.com/giantatwork/csvpeek/issues)!
+
+

csvpeek-0.9.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+csvpeek/__init__.py,sha256=yzoqUeeOO6MqhrBCknbwXZTShDPoqaAid05zgkzhEF0,64
+csvpeek/csvpeek.py,sha256=ueGXoo-EDsUkJ6z_8drn2CWyB49q29n6p13p5wk4wos,20371
+csvpeek/duck.py,sha256=Ir87uoqTw_-bnBysm7e2D74IOyszbaAW1WemEbKzBdc,3079
+csvpeek/filters.py,sha256=9A1S8ntEjQP38NZr_flFQAKhsRRGHXl0dJu9EpWLuWs,1340
+csvpeek/main.py,sha256=xadEh3QdS6weEWoVzwINo6uBt1ZA326VanSIm0J_Xcw,1558
+csvpeek/screen_buffer.py,sha256=hFc3pkWZFvI9Pj3WT5F0Oqrm2geVV1n5ZDDLig4geOw,1525
+csvpeek/selection_utils.py,sha256=I31Ghv7l-QVJDbWY0a8SHHdewgUO3plKNzUPbKs71cA,4201
+csvpeek/ui.py,sha256=5Ab_dM4FlQa_qH3sA59wEsaiLCoDMFeS9CDD5sRXgy4,13014
+csvpeek-0.9.0.dist-info/METADATA,sha256=1Sfqg3C0xSlqH0e9vFTqarkGC42R84IcJxqdKLp5m2s,4053
+csvpeek-0.9.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+csvpeek-0.9.0.dist-info/entry_points.txt,sha256=B0K-LkElbkL0EaGUJyfjBQ8Oc28Xq9Y9PS-o6hMVQIk,46
+csvpeek-0.9.0.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
+csvpeek-0.9.0.dist-info/RECORD,,

csvpeek-0.9.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

csvpeek-0.9.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+csvpeek = csvpeek.main:main

csvpeek-0.9.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.