Metadata-Version: 2.4
Name: datasette-horizontal-scroll
Version: 0.1.1
Summary: A Datasette plugin that adds a fixed horizontal scrollbar at the bottom of the viewport for wide result tables.
Author: Ray Voelker
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/chimpy-me/datasette-horizontal-scroll
Project-URL: Changelog, https://github.com/chimpy-me/datasette-horizontal-scroll/releases
Project-URL: Issues, https://github.com/chimpy-me/datasette-horizontal-scroll/issues
Project-URL: CI, https://github.com/chimpy-me/datasette-horizontal-scroll/actions
Classifier: Framework :: Datasette
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Database
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: datasette>=0.58
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Dynamic: license-file

# datasette-horizontal-scroll

[![PyPI](https://img.shields.io/pypi/v/datasette-horizontal-scroll.svg)](https://pypi.org/project/datasette-horizontal-scroll/)
[![Changelog](https://img.shields.io/github/v/release/chimpy-me/datasette-horizontal-scroll?include_prereleases&label=changelog)](https://github.com/chimpy-me/datasette-horizontal-scroll/releases)
[![Tests](https://github.com/chimpy-me/datasette-horizontal-scroll/actions/workflows/test.yml/badge.svg)](https://github.com/chimpy-me/datasette-horizontal-scroll/actions/workflows/test.yml)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/chimpy-me/datasette-horizontal-scroll/blob/main/LICENSE)

A Datasette plugin that adds a fixed horizontal scrollbar at the bottom of the viewport when a visible results table is wider than the screen. This makes it easier to horizontally navigate wide tables without needing to hit the native scrollbar on the table itself.

![View port with horizontal scroll](image.png)

## Installation

Install this plugin in the same environment as Datasette:

```bash
datasette install datasette-horizontal-scroll
```

This plugin depends on Datasette 0.58+ (it uses `datasette.urls.static_plugins()` for serving static assets).

## Usage

Install the plugin and reload Datasette. On table, query, database, and row views, a bottom-of-viewport scrollbar will appear when the active table overflows horizontally.

This plugin serves its assets as packaged static files (CSS/JS) under Datasette's `/-/static-plugins/` mechanism.

## Development

Clone the repository and run the tests:

```bash
pip install -e ".[dev]"
pytest
```

If you use `uv`, you can equivalently run:

```bash
uv run pytest
```

## Releasing / publishing to PyPI

This repository includes a GitHub Actions workflow that can publish releases to PyPI using Trusted Publishing.

Typical release flow:

1. Bump the version in `pyproject.toml`
2. Create and push a git tag (for example: `v0.1`)
3. Create a GitHub Release for that tag (the publish workflow is triggered on `release: published`)
