py-sparcli 0.3.0__py3-none-any.whl

py_sparcli-0.3.0.dist-info/METADATA

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: py-sparcli
+Version: 0.3.0
+Summary: Styled CLI output and interactive input widgets, dependency-free
+Project-URL: Homepage, https://github.com/cgroening/py-sparcli
+Project-URL: Repository, https://github.com/cgroening/py-sparcli
+Project-URL: Documentation, https://github.com/cgroening/py-sparcli#readme
+Project-URL: Changelog, https://github.com/cgroening/py-sparcli/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/cgroening/py-sparcli/issues
+Author: Corvin Gröning
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ansi,cli,color,prompt,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Terminals
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# sparcli
+
+[![PyPI version](https://img.shields.io/pypi/v/py-sparcli.svg)](https://pypi.org/project/py-sparcli/) [![Python versions](https://img.shields.io/pypi/pyversions/py-sparcli.svg)](https://pypi.org/project/py-sparcli/) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Typed](https://img.shields.io/badge/typed-yes-blue.svg)](https://peps.python.org/pep-0561/)
+
+Styled CLI output and interactive input widgets for Python, built directly on ANSI escape codes with no third-party dependencies.
+
+sparcli is a native Python port of the Rust library of the same name. It renders styled text, tables, panels, trees and progress bars, and drives single-input prompts (text, password, number, confirm, select, fuzzy, date and more) – all from the standard library alone. It is meant for small, lightweight CLI tools: a single accent color, muted defaults, rounded borders, and graceful behavior under `NO_COLOR` or when output is piped. Heavy, full-screen retained TUIs are out of scope.
+
+
+![sparcli output widgets](https://raw.githubusercontent.com/cgroening/py-sparcli/main/images/screenshot-1.png)
+
+![sparcli input widgets](https://raw.githubusercontent.com/cgroening/py-sparcli/main/images/screenshot-2.png)
+
+
+## Highlights
+
+- Output: styled text, inline markup, tables (colspan, rowspan, striping, wrapping, titles), panels, alerts, rules, lists, trees, key-value lists, badges, progress bars, spinners, multi-progress, diffs, columns, live in-place display, pager, and the composition helpers `align`, `pad` and `vstack`.
+- Input: confirm, text (validation, character filters, history, ghost autocomplete, dropdown), password, number (with a calculator), textarea, single and multi select, an inline fuzzy select, and a calendar date picker.
+- A unified `Theme` for input and output, set once and overridable per call.
+- Robust by design: prompts never raise on input, a RAII terminal guard restores the terminal, and results come back as values rather than exceptions.
+- Zero dependencies: pure Python, standard library only, typed under strict basedpyright.
+
+## Installation
+
+```bash
+pip install py-sparcli
+```
+
+The distribution is named `py-sparcli`, but the import package is `sparcli`:
+
+```python
+import sparcli
+from sparcli import Panel, Table, TextInput
+```
+
+sparcli requires Python 3.12 or newer.
+
+## Feature overview
+
+| Category | Components |
+| --- | --- |
+| Text and style | `Style`, `Color`, `Attribute`, `Span`, `Line`, `Text`, `markup` |
+| Framing and layout | `Panel`, `Rule`, `Columns`, `align`, `pad`, `vstack`, `BorderType`, `Align`, `Edges`, `Title` |
+| Data widgets | `Table` (`Column`, `Cell`), `List` (`Marker`), `Tree` (`TreeNode`), `KeyValue`, `Diff`, `Badge`, `Alert` (`AlertKind`) |
+| Progress and live | `Spinner` (`SpinnerStyle`), `ProgressBar` (`ProgressStyle`, `Thresholds`), `MultiProgress`, `Live`, `Pager` |
+| Input prompts | `TextInput`, `PasswordInput`, `NumberInput`, `Confirm`, `Select`, `FuzzySelect`, `DatePicker`, `Textarea` |
+| Prompt support | `Outcome`, `History`, `Shortcut`, `validate`, `event` |
+| Theming and terminal | `Theme`, `theme`, `set_theme`, `color_support`, `is_input_tty`, `is_output_tty`, `term_width` |
+
+## Output example
+
+Every output widget exposes `print()` to write to stdout, `print_to(writer)` to capture the result, and `render(max_width)` to lay it out as a composable block. When stdout is not a terminal (a pipe, a file, or with `NO_COLOR` set), no escape codes are emitted.
+
+```python
+from sparcli import Alert, Table
+
+Alert.success("Build finished.").print()
+
+Table().columns(["Name", "Status"]).row(["web-1", "online"]).row(
+    ["db-1", "online"]
+).striped(True).print()
+```
+
+```text
+╭───────────────────╮
+│ ✔ Build finished. │
+╰───────────────────╯
+╭───────┬────────╮
+│ Name  │ Status │
+├───────┼────────┤
+│ web-1 │ online │
+│ db-1  │ online │
+╰───────┴────────╯
+```
+
+A `Panel` frames content with a rounded border and an optional title. A left-aligned title reads as part of the frame: one connecting border glyph sits before it, never a flush corner - unless the title is too wide for the frame, in which case it is truncated into the border rather than widening the panel.
+
+```python
+from sparcli import Panel
+
+Panel("All systems nominal.").title("Status").print()
+```
+
+```text
+╭─ Status ─────────────╮
+│ All systems nominal. │
+╰──────────────────────╯
+```
+
+## Input example
+
+Prompts return an `Outcome` – a submitted value, a cancellation, or a fired shortcut – and never raise on input. They require an interactive terminal; without one, `run()` raises `NoTerminalError`. Each prompt also has a `frame()` method that renders its static opening frame without a TTY, which is how the previews below are produced.
+
+```python
+from sparcli import Select
+
+outcome = Select(
+    "Environment", options=["staging", "production", "local"]
+).run()
+if outcome.is_submitted:
+    print(f"selected option #{outcome.value}")
+```
+
+Its opening frame, with the cursor on the second row:
+
+```text
+Environment
+  staging
+‣ production
+  local
+```
+
+Text prompts chain validators and filters fluently:
+
+```python
+from sparcli import Confirm, TextInput
+from sparcli import validate
+
+name = TextInput("Your name?").validate(validate.non_empty()).run()
+if name.is_submitted:
+    if Confirm("Continue?").run().submitted_or(False):
+        print(f"Hello, {name.value}!")
+```
+
+## Theming
+
+A single process-wide theme drives both output widgets and input prompts. Set it once; per-call widget options still override individual values.
+
+```python
+from sparcli import Color, Theme, set_theme, theme
+
+set_theme(
+    Theme(
+        accent=Color.rgb(180, 142, 173),
+        unicode=True,  # set False for ASCII-only glyphs
+    )
+)
+
+# Read the active theme anywhere:
+active = theme()
+```
+
+## Output components
+
+The `output_readme.py` example composes a hero panel, a three-column dashboard and a progress bar:
+
+![sparcli output widgets: a hero panel, a status table, a numbered list, a file tree, a key-value block, colored status badges and a progress bar](https://raw.githubusercontent.com/cgroening/py-sparcli/main/images/screenshot-1.png)
+
+Captured with `NO_COLOR=1` the same collage renders as plain text:
+
+```text
+╭─────────────────────────────────  sparcli  ──────────────────────────────────╮
+│              A dependency-free Python library for styled output              │
+│              and input - panels, tables, trees, lists and more.              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+
+          Overview            │ 1. Compose widgets side by side │ host    localhost
+╭─────────┬────────┬────────╮ │ 2. Capture, pad and align them  │ port    8080
+│ Service │ Status │ Uptime │ │ 3. Render to any UTF-8 terminal │ scheme  https
+├─────────┼────────┼────────┤ │                                 │
+│ api     │   OK   │ 99.98% │ │ project/                        │ [ DONE ] [ INFO ]
+├─────────┼────────┼────────┤ │ ├── api/                        │
+│ auth    │   OK   │ 99.91% │ │ │   ├── routes.py               │ [ WARN ] [ FAIL ]
+├─────────┼────────┼────────┤ │ │   └── auth.py                 │
+│ billing │  WARN  │  97.4% │ │ └── worker.py                   │
+╰─────────┴────────┴────────╯ │                                 │
+
+Building [███████████████████████████░░]  92% (92/100)
+```
+
+## Input widgets
+
+The `prompt_readme.py` example stacks the static opening frame of every prompt into a single dashboard, produced entirely through `frame()` with no TTY:
+
+![sparcli input widgets: confirm, text, password, number, textarea, single and multi select, fuzzy select and a calendar date picker](https://raw.githubusercontent.com/cgroening/py-sparcli/main/images/screenshot-2.png)
+
+The same dashboard as plain text:
+
+```text
+╭─────────────────────  sparcli - input widgets  ─────────────────────╮
+│       Interactive prompts - confirm, select, text, password,        │
+│                  number, textarea, fuzzy and date.                  │
+╰─────────────────────────────────────────────────────────────────────╯
+
+Deploy to production? [Yes]  No  │ Environment  │ Release date
+                                 │   staging    │ May 2026
+Service api-gateway              │ ‣ production │ Mo Tu We Th Fr Sa Su
+Password *******                 │   local      │              1  2  3
+Replicas 3                       │              │  4  5  6  7  8  9 10
+Email  you@example.com           │ Targets      │ 11 12 13 14 15 16 17
+                                 │ ‣ ◉ web      │ 18 19 20 21 22 23 24
+Notes                            │   ◯ api      │ 25 26 27 28 29 30 31
+first line                       │   ◉ worker   │
+second line                      │   ◯ db       │ Language ru
+                                 │              │ ‣ Rust
+                                 │              │   Ruby
+```
+
+## Running the examples
+
+The `examples/` directory holds five runnable programs. The static ones are deterministic and pipe-friendly:
+
+```bash
+python examples/output_gallery.py   # every static output widget
+python examples/output_dynamic.py   # spinner, progress, multi-progress, live, pager
+python examples/prompts.py          # every interactive prompt (needs a real TTY)
+python examples/output_readme.py    # the output showcase collage
+python examples/prompt_readme.py    # the input showcase, via frame()
+```
+
+The `prompts.py` example needs an interactive terminal; run without one it prints a notice and exits. The `output_dynamic.py` animations collapse to a single final frame off a terminal, so it stays clean when piped or redirected.
+
+## NO_COLOR and non-terminal behavior
+
+sparcli honors the common terminal environment variables:
+
+- `NO_COLOR` disables all color: styled spans are written as plain text with no escape codes.
+- `CLICOLOR_FORCE` forces color even when output is not a terminal.
+- `SPARCLI_NO_TTY` forces "no terminal" behavior, used for deterministic captures and tests.
+
+When stdout is not a TTY (a pipe or a file), color is disabled automatically unless `CLICOLOR_FORCE` is set, and the in-place engines print only their final frame. Every text showcase in this README is real captured output, produced with `NO_COLOR=1 SPARCLI_NO_TTY=1`; the two screenshots are the same collages captured in color.
+
+## Documentation
+
+- `docs/DEVELOPMENT.md` covers building, testing, linting and contributing.
+- `CHANGELOG.md` records release notes.
+- Every public class and function carries a docstring; browse the source under `sparcli/` for the complete reference.
+
+## License
+
+MIT – see `LICENSE`.

py_sparcli-0.3.0.dist-info/RECORD

@@ -0,0 +1,61 @@
+sparcli/__init__.py,sha256=4l96WE29V9B2o1lnB1nTONFlFUaj85wMB2XabdB3p_w,3111
+sparcli/errors.py,sha256=J9oA_C2cabOS6WEfPyhggLpywC3QosheKvbquUTGExQ,1082
+sparcli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sparcli/core/__init__.py,sha256=eF_mAlmLpt_b57lnbUhX97ESnol-88gZu0oYan4TvCY,1901
+sparcli/core/border.py,sha256=auFHD2swLaWj9nSSHlA7MKUF8dlgpx-szikKeZrkP7w,3300
+sparcli/core/color.py,sha256=nHY84InmfblDQlofsmNNPqNP2dX374DvENXXAe3wM0I,9053
+sparcli/core/cursor.py,sha256=kQWnOckhl_1k678vJiPJJg_9WCXlsplC8KVYaHc6lUA,1559
+sparcli/core/geometry.py,sha256=1E6kEnYfvOQ7P7fkrnKOUG-Z2PV2xsfEeGMK6lgQhFQ,3847
+sparcli/core/markup.py,sha256=ike_O9UU6nVCVvT4hI3dSz7ABdkZVUsJhJv-Zhj0gJ8,6807
+sparcli/core/render.py,sha256=ZeGiJHIbw99nl3Kf25NIoifSR-MuxiaHwXrCHmmi1_U,7775
+sparcli/core/style.py,sha256=MhvgrgH9vqJKE6YlpGOGP_RUtFO_agzunEphYcgrYvA,3831
+sparcli/core/terminal.py,sha256=EuEXXVtlcFnNWPZnUOReHRk13aTtv-bjyHhVVOZBGn8,3576
+sparcli/core/text.py,sha256=phL6pselVJ2N3UteYC8TNi5CHoIK-qx4TBXiN7NPOQk,4281
+sparcli/core/theme.py,sha256=Cd0rJkiIaz8jU_omxBBBU-X635iYOezD0KGnT_z0Xho,3540
+sparcli/core/width.py,sha256=nD0vHRdnpB2KqdbVPX4kEwZ6HRflyP0MrNVjL6SfREw,6752
+sparcli/input/__init__.py,sha256=xqv2oLV2eGUr_zBGwe6cnjn56IGJVGJFgYN3VpRjg7o,1261
+sparcli/input/calc.py,sha256=LXdBOJpTpOnxecQpBPl2BVcdMMAKT15zn8p4qedGEWs,6029
+sparcli/input/confirm.py,sha256=npaEw0qbYL5MxTod3RWN8RZsbHIKXg_jsHKJmip1ntc,6056
+sparcli/input/datepicker.py,sha256=g6Qu_n3yx-5nw-55czv-semS94QR3r7ejteIiNpLQkc,9812
+sparcli/input/editor.py,sha256=hW5Evx3jbRfq_pbbKxmqPKedV0DZ58rxILUjFnbFJ-0,5618
+sparcli/input/event.py,sha256=PnYKrLkwqNLp0tjoqZT16ycmN5-T0k9DP7eD7QX2uRc,16395
+sparcli/input/field.py,sha256=FqYwS0mFzihawBod5v-abGERfUCPv9b402KTBda8HuU,2762
+sparcli/input/fuzzy.py,sha256=i8ntXjtyw64KelpElpe1_elCT_HuH0iLZsHAUfZkNRc,13939
+sparcli/input/guard.py,sha256=OMR4IoBj37ExS4y11WDAnPcj4aG7xpV_ljH7Hln7x54,3379
+sparcli/input/history.py,sha256=BX85aRf3vGIs1_wJUT6SuABkvkD5xwbyWZ8QEUuA5IY,4974
+sparcli/input/line_edit.py,sha256=-g5n9mJsaqszpNQSHP6RSlw2mNVFCdpRTLpdaGnHcTM,8063
+sparcli/input/number.py,sha256=d7h4_Tl9GWr1esR12Dh8WydgE6aOie-xmlXfK50riz0,7892
+sparcli/input/outcome.py,sha256=VhjJrkb7g_VBaYI99tA8v9jJN_Ydiys0S54fl0cIamA,3139
+sparcli/input/password.py,sha256=Z0JIq2esHn_xZ01xu5DBeesOBBfOSXTSwcmghZbw1fY,8041
+sparcli/input/prompt.py,sha256=BxoqD9V2H8HvQObbMOfztmq5x23iP4z8mfv-juQ4jM4,4128
+sparcli/input/select.py,sha256=UIVvukpIY7bFMvatpYfwGENa1x0QzkqCADCcQhgQisA,11582
+sparcli/input/shortcut.py,sha256=3T05n-j8GXJ2ZZ7BBW3ddOMAjNwsGO0xWM9GGXaL_ik,3572
+sparcli/input/text.py,sha256=cfafZnHJeHYtndjzEqFn09LHNMlhp3xoArVYrh1dkVk,20173
+sparcli/input/textarea.py,sha256=4oMfdbM02mWS80zk_EsiI9fYFYr1jFZcqRTEe3MyV0I,8130
+sparcli/input/validate.py,sha256=Icu1bsfe-TY4ktIH6i1s5HWtm1N-gjs-gHzRngSmG8M,1956
+sparcli/output/__init__.py,sha256=1fKmxfM_3CG8z8dYGPoPh6NbSkz4prZsxMZkeuVfJhE,1467
+sparcli/output/alert.py,sha256=0zyvtiJu9x0A8jRAsr3rIKNXufkRWjnCfzuiCqk8DAQ,3310
+sparcli/output/badge.py,sha256=5BneIDDEjJqPDDsm2zXURfZseD9cH7_adM7WQfirw6M,2543
+sparcli/output/box.py,sha256=wdPzlntqyPQ_DdF9EJsd-io43d0YBs35ipHJlSnyecU,6891
+sparcli/output/columns.py,sha256=-nSQdYy-vX4ZXXnhJv29-Gy5g-V8c5NU8lnANIRBgJQ,5334
+sparcli/output/compose.py,sha256=JTIPXW2Rs1lh3sWMoYXq17OnU4W4m1HETj9TsUHyJEg,3140
+sparcli/output/diff.py,sha256=3MAYcwE2ppilFvtRzF-x71bFAwn2tXvw_ED6rPR5708,7333
+sparcli/output/kv.py,sha256=z7TdjzoatKev2TKHKuL0-EMSTMy2eHNIel0FcYohbYU,6011
+sparcli/output/layout.py,sha256=HhGeXSwnJgsn7-375aprkcLNJSked9LWZpmCvH_iSD8,2179
+sparcli/output/list.py,sha256=6etUeKwgneFocWFDin0ROSyxS2QK99r0ahoBxev89h0,8939
+sparcli/output/live.py,sha256=XD22DZUtJZsBoUu_xGAkq8S5WQ8ZbpFhReQ2kDl7Y2w,4379
+sparcli/output/multiprogress.py,sha256=mgazp4o954QlF64MrdUvt7M5UG9ivAXR_P8ERAp9PIE,2403
+sparcli/output/pager.py,sha256=einC15rM_Ub0qvw3dxkZpgLK-yuJaEADmpBjx3pf1QE,2554
+sparcli/output/panel.py,sha256=BhvX8ibw0Sh3HsPPpEBY006E6orCrl7v0XmTAIwNo0Y,4184
+sparcli/output/progress.py,sha256=7J_gzehD4Geyke1VyyirzgndePxP7GzCWdogpmG8aSA,7508
+sparcli/output/rule.py,sha256=_XTNBV3F5WEOyLA7P4enyPBVUHdG9NvmJv-eE8DWxRA,4703
+sparcli/output/spinner.py,sha256=-Sqe6LXUQrrSc2OMQL7HZdgQP6brnl_oI6bxUxNIDHM,4359
+sparcli/output/tree.py,sha256=VgCrGtGm1i06nk9O6vjkvR-1J8H1Tc7mpgJuigqjpiY,5169
+sparcli/output/table/__init__.py,sha256=aW7WOp7VWtsKgz1qdoCDfHN4adr9lDaWLO8OlUxpsGs,535
+sparcli/output/table/plan.py,sha256=CZITOVJL8RlBpw3lgWcVmp65O25dOOwGXP3Bqq6Prjg,6206
+sparcli/output/table/render.py,sha256=lwNAltYtylOmMTJOAoiT7K1CL_Eq3ZZ5dmNM2ZYig2s,11113
+sparcli/output/table/table.py,sha256=0S9L3U7DuXtJ24YFle5YbCGNbCLRXMGa5wSYnmL8Eac,11234
+py_sparcli-0.3.0.dist-info/METADATA,sha256=H-lnH5wYUKq2T8nMX3Ms44fF6T331-OWE7SaVBAlTfY,13008
+py_sparcli-0.3.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+py_sparcli-0.3.0.dist-info/licenses/LICENSE,sha256=KGU4zmBB5SJOxn_dfYTxKVB-tRV94wl3vVLe8HiQ_X8,1072
+py_sparcli-0.3.0.dist-info/RECORD,,

py_sparcli-0.3.0.dist-info/WHEEL

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

py_sparcli-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Corvin Gröning
+
+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.

sparcli/__init__.py

@@ -0,0 +1,184 @@
+"""
+sparcli
+=======
+
+Styled CLI output and interactive input widgets, built directly on ANSI escape
+codes with no third-party dependencies.
+
+The public API is re-exported flat from this package: import widgets and types
+directly (``from sparcli import Panel, TextInput``). Grouped helpers stay
+reachable as submodules (``sparcli.width``, ``sparcli.terminal``,
+``sparcli.markup``).
+"""
+
+from sparcli.core import (
+    DEFAULT_ACCENT,
+    Align,
+    Attribute,
+    BorderChars,
+    BorderType,
+    Color,
+    ColorName,
+    ColorSupport,
+    Edges,
+    Line,
+    Modifier,
+    Position,
+    Renderable,
+    Rendered,
+    Span,
+    Style,
+    Text,
+    Theme,
+    Title,
+    VAlign,
+    color_support,
+    into_line,
+    into_span,
+    into_text,
+    is_input_tty,
+    is_output_tty,
+    set_theme,
+    term_height,
+    term_width,
+    terminal_size,
+    theme,
+)
+from sparcli.core import markup as markup
+from sparcli.core import terminal as terminal
+from sparcli.core import width as width
+from sparcli.errors import (
+    ConfigError,
+    NoTerminalError,
+    SparcliError,
+    TerminalError,
+)
+from sparcli.input import (
+    Confirm,
+    DatePicker,
+    FuzzySelect,
+    History,
+    NumberInput,
+    Outcome,
+    OutcomeKind,
+    PasswordInput,
+    Select,
+    Shortcut,
+    Textarea,
+    TextInput,
+    edit_file,
+)
+from sparcli.input import event as event
+from sparcli.input import shortcut as shortcut
+from sparcli.input import validate as validate
+from sparcli.output import (
+    Alert,
+    AlertKind,
+    Badge,
+    Cell,
+    Column,
+    Columns,
+    Diff,
+    KeyValue,
+    List,
+    Live,
+    Marker,
+    MultiProgress,
+    Pager,
+    Panel,
+    ProgressBar,
+    ProgressStyle,
+    Rule,
+    Spinner,
+    SpinnerStyle,
+    Table,
+    Thresholds,
+    Tree,
+    TreeNode,
+    align,
+    pad,
+    vstack,
+)
+
+__all__ = [
+    "DEFAULT_ACCENT",
+    "Alert",
+    "AlertKind",
+    "Align",
+    "Attribute",
+    "Badge",
+    "BorderChars",
+    "BorderType",
+    "Cell",
+    "Color",
+    "ColorName",
+    "ColorSupport",
+    "Column",
+    "Columns",
+    "Confirm",
+    "ConfigError",
+    "DatePicker",
+    "Diff",
+    "Edges",
+    "FuzzySelect",
+    "History",
+    "KeyValue",
+    "Line",
+    "List",
+    "Live",
+    "Marker",
+    "Modifier",
+    "MultiProgress",
+    "NoTerminalError",
+    "NumberInput",
+    "Outcome",
+    "OutcomeKind",
+    "Pager",
+    "Panel",
+    "PasswordInput",
+    "Position",
+    "ProgressBar",
+    "ProgressStyle",
+    "Rendered",
+    "Renderable",
+    "Rule",
+    "Select",
+    "Shortcut",
+    "Span",
+    "SparcliError",
+    "Spinner",
+    "SpinnerStyle",
+    "Style",
+    "Table",
+    "TerminalError",
+    "Text",
+    "TextInput",
+    "Textarea",
+    "Theme",
+    "Thresholds",
+    "Title",
+    "Tree",
+    "TreeNode",
+    "VAlign",
+    "align",
+    "color_support",
+    "edit_file",
+    "event",
+    "into_line",
+    "into_span",
+    "into_text",
+    "is_input_tty",
+    "is_output_tty",
+    "markup",
+    "pad",
+    "set_theme",
+    "shortcut",
+    "term_height",
+    "term_width",
+    "terminal",
+    "terminal_size",
+    "theme",
+    "validate",
+    "vstack",
+    "width",
+]

sparcli/core/__init__.py

@@ -0,0 +1,92 @@
+"""
+sparcli.core
+============
+
+The foundation layer: styling, text, rendering, geometry, borders, theming,
+width math, terminal capabilities and inline markup.
+
+Nothing in this package depends on the widget layers; ``output`` and ``input``
+build on top of it.
+"""
+
+from sparcli.core.border import BorderChars, BorderType
+from sparcli.core.color import Color, ColorName
+from sparcli.core.geometry import Align, Edges, Position, Title, VAlign
+from sparcli.core.markup import markup_print, markup_println, parse
+from sparcli.core.render import (
+    Renderable,
+    Rendered,
+    SupportsWrite,
+    write_line,
+    write_rendered,
+)
+from sparcli.core.style import Attribute, Modifier, Style
+from sparcli.core.terminal import (
+    ColorSupport,
+    color_support,
+    is_input_tty,
+    is_output_tty,
+    term_height,
+    term_width,
+    terminal_size,
+)
+from sparcli.core.text import (
+    IntoLine,
+    IntoSpan,
+    IntoText,
+    Line,
+    Span,
+    Text,
+    into_line,
+    into_span,
+    into_text,
+)
+from sparcli.core.theme import DEFAULT_ACCENT, Theme, set_theme, theme
+from sparcli.core.width import strip_ansi, truncate, visible_width, wrap
+
+__all__ = [
+    "DEFAULT_ACCENT",
+    "Align",
+    "Attribute",
+    "BorderChars",
+    "BorderType",
+    "Color",
+    "ColorName",
+    "ColorSupport",
+    "Edges",
+    "IntoLine",
+    "IntoSpan",
+    "IntoText",
+    "Line",
+    "Modifier",
+    "Position",
+    "Rendered",
+    "Renderable",
+    "Span",
+    "Style",
+    "SupportsWrite",
+    "Text",
+    "Theme",
+    "Title",
+    "VAlign",
+    "color_support",
+    "into_line",
+    "into_span",
+    "into_text",
+    "is_input_tty",
+    "is_output_tty",
+    "markup_print",
+    "markup_println",
+    "parse",
+    "set_theme",
+    "strip_ansi",
+    "term_height",
+    "term_width",
+    "terminal_size",
+    "theme",
+    "truncate",
+    "visible_width",
+    "wrap",
+    "write_line",
+    "write_rendered",
+]