AHj ddlmZddlZddlmZ ddlZdZddlm Z ddl m Z ddl m Z mZmZdd lmZdd lmZdd lmZmZmZmZmZd Zd ZdZdZdZGddeZGddedZ GddeZ!y#e$rdZYgwxYw)) 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. cdeZdZdZdZeddZeddZedZ d dZ d d Z d d Z y ) StarCountz,Widget to get and display GitHub star count.aX 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;} } ibT) recomposeicKts|jddyd|_ tjdd{t j 4d{}|jdd{j}dddd{d|_ |d |_ d|_y7t7Y7B7&#1d{7swY6xYw#t$r|jd d d Yd|_ywxYww)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 I/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/demo/home.py get_starszStarCount.get_starss KKb$     --" " "((*  f **%VWW$&   )); * { max-width: 100; } margin: 0 1; overflow-y: auto; height: 1fr; scrollbar-gutter: stable; MarkdownFence { height: auto; max-height: initial; } Collapsible { padding-right: 0; &.-collapsed { padding-bottom: 1; } } Markdown { margin-right: 1; padding-right: 1; background: transparent; } } } c#.Ktt5ttt dd5tt dddt d5tt dddt d5ttdddt d5ttddddddty#1swYxYw#1swYvxYw#1swY\xYw#1swYBxYw#1swYFxYww)NWelcomeF)r collapsedzTextual Interfacesrz Textual APIzDeploying Textual apps) rrFrWHAT_IS_TEXTUAL_MDr WELCOME_MDABOUT_MDAPI_MD DEPLOY_MDrr7s r*r4zHomeScreen.composesk Y *-. .9> +z** +#78 )x(( )=1 'v&& '#;< *y)) * *h + + ) ) ' ' * * * *s{DD C D C%0D C1D *C=<D DC" D %C. *D 1C: 6D =D D  DDNr<)r?r@rArCr4rDr9r*rIrIsK: r9rI)" __future__rrimportlib.metadatarr!r ImportErrorr/r textual.apprtextual.containersrrr textual.demo.pager textual.reactiver textual.widgetsr r rrrrMrNrOrPrQrrFrIrDr9r*rZs"&O%CC(%HH " $: x  (FFR)n)**gOsA66B?B