Cj!SSKJr SSKrSSKJr SSKrSrSSKJ r SSK J r SSK J r JrJr SS KJr SS KJr SS KJrJrJrJrJr S rS rSrSrSr"SS\5r"SS\SS9r "SS\5r!g!\a SrNef=f)) annotationsN)versionTF)work) ComposeResult) HorizontalVerticalVerticalScroll) PageScreen)reactive) CollapsibleDigitsFooterLabelMarkdownu# What is Textual? Snappy, keyboard-centric, applications that run in the terminal and [the web](https://github.com/Textualize/textual-web). 🐍 All you need is Python! uP## Welcome keyboard warriors! This is a Textual app. Here's what you need to know: * **enter** `toggle this collapsible widget` * **tab** `focus the next widget` * **shift+tab** `focus the previous widget` * **ctrl+p** `summon the command palette` 👇 Also see the footer below. `Or… click away with the mouse (no judgement).` uThe retro look is not just an aesthetic choice! Textual apps have some unique properties that make them preferable for many tasks. ## Textual interfaces are *snappy* Even the most modern of web apps can leave the user waiting hundreds of milliseconds or more for a response. Given their low graphical requirements, Textual interfaces can be far more responsive — no waiting required. ## Reward repeated use Use the mouse to explore, but Textual apps are keyboard-centric and reward repeated use. An experienced user can operate a Textual app far faster than their web / GUI counterparts. ## Command palette A builtin command palette with fuzzy searching puts powerful commands at your fingertips. **Try it:** Press **ctrl+p** now. aA modern Python API from the developer of [Rich](https://github.com/Textualize/rich). ```python # Start building! from textual.app import App, ComposeResult from textual.widgets import Label class MyApp(App): def compose(self) -> ComposeResult: yield Label("Hello, World!") MyApp().run() ``` * Intuitive, batteries-included, API. * Well documented: See the [tutorial](https://textual.textualize.io/tutorial/), [guide](https://textual.textualize.io/guide/app/), and [reference](https://textual.textualize.io/reference/). * Fully typed, with modern type annotations. * Accessible to Python developers of all skill levels. **Hint:** press **C** to view the code for this page. ## Built on Rich With over 3.1 *billion* downloads, Rich is the most popular terminal library out there. Textual builds on Rich to add interactivity, and is fully-compatible with Rich renderables. ## Re-usable widgets Textual's widgets are self-contained and re-usable across projects. Virtually all aspects of a widget's look and feel can be customized to your requirements. ## Builtin widgets A large [library of builtin widgets](https://textual.textualize.io/widget_gallery/), and a growing ecosystem of third party widgets on PyPI (this content is generated by the builtin [Markdown](https://textual.textualize.io/widget_gallery/#markdown) widget). ## Reactive variables [Reactivity](https://textual.textualize.io/guide/reactivity/) using Python idioms, keeps your logic separate from display code. ## Async support Built on asyncio, you can easily integrate async libraries while keeping your UI responsive. ## Concurrency Textual's [Workers](https://textual.textualize.io/guide/workers/) provide a far-less error prone interface to concurrency: both async and threads. ## Testing With a comprehensive [testing framework](https://textual.textualize.io/guide/testing/), you can release reliable software, that can be maintained indefinitely. ## Docs Textual has [amazing docs](https://textual.textualize.io/)! aTextual apps have extremely low system requirements, and will run on virtually any OS and hardware; locally or remotely via SSH. There are a number of ways to deploy and share Textual apps. ## As a Python library Textual apps may be pip installed, via tools such as `pipx` or `uvx`, and other package managers. ## As a web application It takes two lines of code to [serve your Textual app](https://github.com/Textualize/textual-serve) as a web application. ## Managed web application With [Textual web](https://github.com/Textualize/textual-web) you can serve multiple Textual apps on the web, with zero configuration. Even behind a firewall. cf\rSrSrSrSr\"SSS9r\"SSS9r\ S5r SS jr SS jr SS jr S rg ) StarCountz,Widget to get and display GitHub star count.a StarCount { dock: top; height: 6; border-bottom: hkey $background; border-top: hkey $background; layout: horizontal; background: $boost; padding: 0 1; color: $text-warning; #stars { align: center top; } #forks { align: right top; } Label { text-style: bold; color: $foreground; } LoadingIndicator { background: transparent !important; } Digits { width: auto; margin-right: 1; } Label { margin-right: 1; } align: center top; &>Horizontal { max-width: 100;} &:ansi { color: $accent; border-bottom: hkey $accent; border-top: hkey $accent; } } iT) recomposeiTc# [(dURSSS9 gSUl[R"S5IShvN [ R "5IShvN nURS5IShvN R5nSSS5IShvN WSUl US Ul SUlgNuNYNBN&!,IShvN (df  N;=f![a URS S S S 9 NGf=f7f)z$Worker to get stars from GitHub API.zNInstall httpx to update stars from the GitHub API. $ [b]pip install httpx[/b]z GitHub StarstitleNTz/https://api.github.com/repos/textualize/textualstargazers_countforksz0Unable to update star count (maybe rate-limited)z GitHub starserror)rseverityF) HTTPX_AVAILABLEnotifyloadingasynciosleephttpx AsyncClientgetjsonstarsr Exception)selfclientrepository_jsons c/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/demo/home.py get_starsStarCount.get_starss KKb$     --" " "((**f **%VWW$& +*));7B:8B> CB<C.C96C8C:B><C>CC  CCC63C95C66C9c## [5 [SS9 [S5v [[ S55v SSS5 [SS9 [S5v UR S- SS 3n[U5R UR S 35v SSS5 [S S9 [S 5v [[UR55R URS 35v SSS5 SSS5 g!,(df  N=f!,(df  N=f!,(df  N9=f!,(df  g=f7f)Nr)idVersiontextualr&u GitHub ★iz.1fKz GitHub starsrForksz Forks) rrrr rr& with_tooltipstrr)r(r&s r+composeStarCount.composes \Y'I&&WY/00(W%L))::,S13Um00DJJ<}1MNN&W%Gn$S_-::djj\;PQQ&\''&%&%\sd E D5$DD5 A DD5'A D$1D59 E D D5 D! D5$ D2 .D55 E?Ec2SUlUR5 g)NzClick to refresh)tooltipr,r(s r+on_mountStarCount.on_mounts)  c$UR5 g)N)r,r:s r+on_clickStarCount.on_clicks  r=)rrr&r9Nreturnr)rBNone)__name__ __module__ __qualname____firstlineno____doc__ DEFAULT_CSSr r&rrr,r6r;r?__static_attributes__r=r+rrsH6K2 Ud +E TT *E  2 Rr=rc\rSrSrSrSrg)ContentzNon focusable vertical scroll.rKN)rDrErFrGrHrJrKr=r+rMrMs(r=rM) can_focusc"\rSrSrSrSSjrSrg) HomeScreena HomeScreen { Content { align-horizontal: center; margin: 0 1; overflow-y: auto; height: 1fr; MarkdownFence { height: auto; max-height: initial; } Collapsible { margin: 0 2; Contents { padding: 1 0 0 0; MarkdownHeader { margin: 0 0 1 0; } } } Markdown{ margin-right: 1; } } } c#H# [5v [5 [[5v [ SSS9 [[ 5v SSS5 [ SS9 [[ 5v SSS5 [ SS9 [[5v SSS5 [ SS9 [[5v SSS5 SSS5 [5v g!,(df  N=f!,(df  Nz=f!,(df  Nh=f!,(df  NV=f!,(df  N_=f7f)NWelcomeF)r collapsedzTextual Interfacesrz Textual APIzDeploying Textual apps) rrMrWHAT_IS_TEXTUAL_MDr WELCOME_MDABOUT_MDAPI_MD DEPLOY_MDrr:s r+r6HomeScreen.composesk Y-. .9>z**?#78x((9=1v&&2#;<y))=h?>8811<<Ys{D"DC DC*D;C/ DD0D8D" C D C, (D/ C= 9D D D DD"rKNrA)rDrErFrGrIr6rJrKr=r+rQrQsK: r=rQ)" __future__rr importlib.metadatarr"r ImportErrorr1r textual.apprtextual.containersrrr textual.demo.pager textual.reactiver textual.widgetsr r rrrrVrWrXrYrZrrMrQrKr=r+rds"&O%CC(%HH " $: x  (KK\)n)**qOsA33A>=A>