ecstacy-tui 0.1.1__tar.gz

ecstacy_tui-0.1.1/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+dist/
+build/
+*.egg-info/
+.DS_Store

ecstacy_tui-0.1.1/.python-version

@@ -0,0 +1 @@
+3.13

ecstacy_tui-0.1.1/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-07-27
+
+### Fixed
+- README images now use absolute GitHub URLs so they render on PyPI.
+
+## [0.1.0] - 2026-07-27
+
+### Added
+- First public release.
+- Textual TUI for terminal data visualization.
+- Sources: file (CSV, TSV, JSON, NDJSON, Parquet, log), REST, SQL (DuckDB),
+  WebSocket.
+- Visualizations: table (sortable and searchable), line, bar, histogram,
+  scatter, sparkline, gauge, heatmap, JSON tree.
+- Multi-panel dashboards from YAML with grid and single-panel layouts (`m` to
+  toggle) and live refresh.
+- Layered configuration: defaults, user YAML, project YAML, environment
+  variables, CLI overrides (validated with Pydantic).
+- Two built-in themes (ecstacy-dark, ecstacy-light) with `t` to toggle.
+- Splash screen, home screen, help screen.
+- `--max-rows` CLI option to cap rows loaded from file and REST sources.
+- Config validation with Pydantic, friendly error messages via `SourceError`,
+  `ConfigError`, `TransformError`.
+- Plugin registry for sources and visualizations.
+
+### Known limitations
+- No export to file yet (CSV/JSON/Markdown/PNG).
+- No Excel, SQLite, clipboard, or stdin source yet.
+- Live refresh applies to dashboards only (not single-source views).

ecstacy_tui-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abhishek Dobliyal
+
+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.

ecstacy_tui-0.1.1/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: ecstacy-tui
+Version: 0.1.1
+Summary: A Textual TUI for beautiful terminal data visualization from files, REST endpoints and more.
+Project-URL: Homepage, https://github.com/Abhishek-Dobliyal/ecstacy
+Project-URL: Repository, https://github.com/Abhishek-Dobliyal/ecstacy
+Project-URL: Issues, https://github.com/Abhishek-Dobliyal/ecstacy/issues
+Project-URL: Changelog, https://github.com/Abhishek-Dobliyal/ecstacy/blob/main/CHANGELOG.md
+Author-email: Abhishek Dobliyal <abhishek.dobliyal1512@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: charts,csv,data,dataframe,duckdb,sql,terminal,textual,tui,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Console :: Curses
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Terminals
+Classifier: Topic :: Terminals :: Terminal Emulators/X Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: duckdb<2,>=1.0.0
+Requires-Dist: httpx<1,>=0.27.0
+Requires-Dist: numpy<3,>=1.26.0
+Requires-Dist: orjson<4,>=3.10.0
+Requires-Dist: pandas<3,>=2.2.0
+Requires-Dist: plotext<6,>=5.2.8
+Requires-Dist: pyarrow<20,>=15.0.0
+Requires-Dist: pydantic<3,>=2.0.0
+Requires-Dist: pyfiglet<2,>=1.0.2
+Requires-Dist: pyyaml<7,>=6.0.2
+Requires-Dist: textual-plotext<2,>=1.0.1
+Requires-Dist: textual<1,>=0.86.2
+Requires-Dist: typer<1,>=0.12.0
+Requires-Dist: websockets<15,>=12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.5.0; extra == 'dev'
+Requires-Dist: textual-dev>=1.5.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Ecstacy
+
+Beautiful data, right in your terminal.
+
+Ecstacy is a Textual TUI for visualizing data from local files, REST endpoints,
+SQL, and WebSockets -- with charts, tables, sparklines, gauges, heatmaps and a
+JSON explorer. Any source feeds any visualization through a typed `DataSet`
+contract, and dashboards compose multiple panels from a single YAML file.
+
+<table>
+<tr>
+  <td align="center" width="50%"><b>Splash screen</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/splash.png" alt="Splash screen"></td>
+  <td align="center" width="50%"><b>Home screen</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/home.png" alt="Home screen"></td>
+</tr>
+<tr>
+  <td align="center" width="50%"><b>Sparkline chart</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/sparkline.png" alt="Sparkline chart"></td>
+  <td align="center" width="50%"><b>JSON explorer</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/json.png" alt="JSON explorer"></td>
+</tr>
+</table>
+
+## Install
+
+```
+pip install ecstacy
+```
+
+Then launch it:
+
+```
+ecstacy
+```
+
+You can also run it directly with [uv](https://docs.astral.sh/uv/) from a clone
+of this repo:
+
+```
+uv sync
+uv run ecstacy
+```
+
+## Quick start
+
+Open a file directly:
+
+```
+ecstacy file sample.csv --chart line
+ecstacy file data.csv --chart bar --x region --y value
+ecstacy file metrics.parquet --chart table --max-rows 1000
+```
+
+Query a REST endpoint:
+
+```
+ecstacy rest https://api.example.com/items --json-path data.items --chart table
+```
+
+Run a DuckDB SQL query:
+
+```
+ecstacy sql "select 1 as a, 2 as b" --chart table
+ecstacy sql "select * from 'data.csv'" --db :memory: --chart line
+```
+
+Stream from a WebSocket:
+
+```
+ecstacy socket ws://localhost:8765 --chart table
+```
+
+Open a multi-panel dashboard:
+
+```
+ecstacy dashboard ops.yaml
+```
+
+Inspect available themes, charts, or your config path:
+
+```
+ecstacy themes
+ecstacy charts
+ecstacy config path
+```
+
+## Sources
+
+| Source   | Formats / protocol                              |
+|----------|-------------------------------------------------|
+| file     | CSV, TSV, JSON, NDJSON, Parquet, log/text       |
+| rest     | HTTP/HTTPS JSON endpoints with dotted json-path |
+| sql      | DuckDB queries (in-memory or file-backed)       |
+| socket   | WebSocket streaming JSON records                |
+
+## Visualizations
+
+table (sortable and searchable), line, bar, histogram, scatter, sparkline,
+gauge, heatmap (correlation matrix), json tree.
+
+## Keys
+
+Home: `o` open, `d` dashboard, `t` theme, `?` help, `q` quit.
+Chart: `n`/`right` next chart, `p`/`left` previous chart, `t` theme, `esc` back.
+Table: `s` sort by column, `/` focus search, type to filter, `esc` clear.
+Dashboard: `m` toggle grid/single layout, `n`/`p` cycle panels, `esc` back.
+
+## Configuration
+
+Ecstacy layers configuration in this order (later wins):
+
+1. Built-in defaults.
+2. User config: `$XDG_CONFIG_HOME/ecstacy/config.yaml` (or `~/.config/ecstacy/config.yaml`).
+3. Project config: `./ecstacy.yaml` in the current directory.
+4. Environment variables prefixed `ECSTACY_` (e.g. `ECSTACY_THEME=ecstacy-light`).
+5. CLI flags.
+
+Example `config.yaml`:
+
+```yaml
+theme: ecstacy-dark
+refresh: 0s
+splash: true
+max_rows: 1000
+```
+
+## Dashboards
+
+A dashboard YAML describes sources and panels. Each panel binds a source to a
+visualization with an optional column mapping. Source paths are resolved
+relative to the dashboard file, so dashboards are portable.
+
+```yaml
+theme: ecstacy-dark
+refresh: 5s
+sources:
+  - id: metrics
+    kind: file
+    path: ./sample.csv
+panels:
+  - source: metrics
+    viz: line
+    x: timestamp
+    y: [revenue, margin]
+  - source: metrics
+    viz: bar
+    category: region
+    value: revenue
+```
+
+When `refresh` is set, dashboard panels re-fetch on that interval. Press `m` to
+switch between grid and single-panel layouts.
+
+## Architecture
+
+- `core` -- `DataSet` contract, plugin registry, transforms, store, scheduler.
+- `sources` -- file, rest, sql, socket -- all registered plugins.
+- `widgets` -- visualization widgets, registered plugins.
+- `screens` -- splash, home, chart, dashboard, modal, help.
+- `config` -- defaults, Pydantic schema, layered config loader.
+- `theming` -- Textual themes and the global stylesheet.
+
+Sources resolve to a typed `DataSet` (DataFrame + schema + meta). Widgets bind
+to a `DataSet` and a column mapping, so any source can feed any visualization.
+
+## Extending
+
+Add a source by subclassing `Source` and decorating it with
+`@registry.sources.register("name")`. Add a visualization by creating a widget
+with a `set_data(dataset, mapping)` method and decorating it with
+`@registry.viz.register("name")`.
+
+## Known limitations
+
+- No export to file yet (CSV/JSON/Markdown/PNG).
+- No Excel, SQLite, clipboard, or stdin source yet.
+- Live refresh applies to dashboards only (not single-source views).
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).

ecstacy_tui-0.1.1/README.md

@@ -0,0 +1,182 @@
+# Ecstacy
+
+Beautiful data, right in your terminal.
+
+Ecstacy is a Textual TUI for visualizing data from local files, REST endpoints,
+SQL, and WebSockets -- with charts, tables, sparklines, gauges, heatmaps and a
+JSON explorer. Any source feeds any visualization through a typed `DataSet`
+contract, and dashboards compose multiple panels from a single YAML file.
+
+<table>
+<tr>
+  <td align="center" width="50%"><b>Splash screen</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/splash.png" alt="Splash screen"></td>
+  <td align="center" width="50%"><b>Home screen</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/home.png" alt="Home screen"></td>
+</tr>
+<tr>
+  <td align="center" width="50%"><b>Sparkline chart</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/sparkline.png" alt="Sparkline chart"></td>
+  <td align="center" width="50%"><b>JSON explorer</b><br><br><img src="https://raw.githubusercontent.com/Abhishek-Dobliyal/ecstacy/main/assets/json.png" alt="JSON explorer"></td>
+</tr>
+</table>
+
+## Install
+
+```
+pip install ecstacy
+```
+
+Then launch it:
+
+```
+ecstacy
+```
+
+You can also run it directly with [uv](https://docs.astral.sh/uv/) from a clone
+of this repo:
+
+```
+uv sync
+uv run ecstacy
+```
+
+## Quick start
+
+Open a file directly:
+
+```
+ecstacy file sample.csv --chart line
+ecstacy file data.csv --chart bar --x region --y value
+ecstacy file metrics.parquet --chart table --max-rows 1000
+```
+
+Query a REST endpoint:
+
+```
+ecstacy rest https://api.example.com/items --json-path data.items --chart table
+```
+
+Run a DuckDB SQL query:
+
+```
+ecstacy sql "select 1 as a, 2 as b" --chart table
+ecstacy sql "select * from 'data.csv'" --db :memory: --chart line
+```
+
+Stream from a WebSocket:
+
+```
+ecstacy socket ws://localhost:8765 --chart table
+```
+
+Open a multi-panel dashboard:
+
+```
+ecstacy dashboard ops.yaml
+```
+
+Inspect available themes, charts, or your config path:
+
+```
+ecstacy themes
+ecstacy charts
+ecstacy config path
+```
+
+## Sources
+
+| Source   | Formats / protocol                              |
+|----------|-------------------------------------------------|
+| file     | CSV, TSV, JSON, NDJSON, Parquet, log/text       |
+| rest     | HTTP/HTTPS JSON endpoints with dotted json-path |
+| sql      | DuckDB queries (in-memory or file-backed)       |
+| socket   | WebSocket streaming JSON records                |
+
+## Visualizations
+
+table (sortable and searchable), line, bar, histogram, scatter, sparkline,
+gauge, heatmap (correlation matrix), json tree.
+
+## Keys
+
+Home: `o` open, `d` dashboard, `t` theme, `?` help, `q` quit.
+Chart: `n`/`right` next chart, `p`/`left` previous chart, `t` theme, `esc` back.
+Table: `s` sort by column, `/` focus search, type to filter, `esc` clear.
+Dashboard: `m` toggle grid/single layout, `n`/`p` cycle panels, `esc` back.
+
+## Configuration
+
+Ecstacy layers configuration in this order (later wins):
+
+1. Built-in defaults.
+2. User config: `$XDG_CONFIG_HOME/ecstacy/config.yaml` (or `~/.config/ecstacy/config.yaml`).
+3. Project config: `./ecstacy.yaml` in the current directory.
+4. Environment variables prefixed `ECSTACY_` (e.g. `ECSTACY_THEME=ecstacy-light`).
+5. CLI flags.
+
+Example `config.yaml`:
+
+```yaml
+theme: ecstacy-dark
+refresh: 0s
+splash: true
+max_rows: 1000
+```
+
+## Dashboards
+
+A dashboard YAML describes sources and panels. Each panel binds a source to a
+visualization with an optional column mapping. Source paths are resolved
+relative to the dashboard file, so dashboards are portable.
+
+```yaml
+theme: ecstacy-dark
+refresh: 5s
+sources:
+  - id: metrics
+    kind: file
+    path: ./sample.csv
+panels:
+  - source: metrics
+    viz: line
+    x: timestamp
+    y: [revenue, margin]
+  - source: metrics
+    viz: bar
+    category: region
+    value: revenue
+```
+
+When `refresh` is set, dashboard panels re-fetch on that interval. Press `m` to
+switch between grid and single-panel layouts.
+
+## Architecture
+
+- `core` -- `DataSet` contract, plugin registry, transforms, store, scheduler.
+- `sources` -- file, rest, sql, socket -- all registered plugins.
+- `widgets` -- visualization widgets, registered plugins.
+- `screens` -- splash, home, chart, dashboard, modal, help.
+- `config` -- defaults, Pydantic schema, layered config loader.
+- `theming` -- Textual themes and the global stylesheet.
+
+Sources resolve to a typed `DataSet` (DataFrame + schema + meta). Widgets bind
+to a `DataSet` and a column mapping, so any source can feed any visualization.
+
+## Extending
+
+Add a source by subclassing `Source` and decorating it with
+`@registry.sources.register("name")`. Add a visualization by creating a widget
+with a `set_data(dataset, mapping)` method and decorating it with
+`@registry.viz.register("name")`.
+
+## Known limitations
+
+- No export to file yet (CSV/JSON/Markdown/PNG).
+- No Excel, SQLite, clipboard, or stdin source yet.
+- Live refresh applies to dashboards only (not single-source views).
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).

ecstacy_tui-0.1.1/dashboards/ops.yaml

@@ -0,0 +1,15 @@
+theme: ecstacy-dark
+refresh: 5s
+sources:
+  - id: metrics
+    kind: file
+    path: ./dashboards/sample.csv
+panels:
+  - source: metrics
+    viz: line
+    x: timestamp
+    y: [revenue, margin]
+  - source: metrics
+    viz: bar
+    category: region
+    value: revenue