A full-featured console (xterm et al.) user interface library
Project description
Urwid
About
Urwid is a console user interface library for Python on Linux, OSX, Cygwin or other unix-like OS and partially supports Windows OS (see below).
It includes many features useful for text console application developers including:
Applications resize quickly and smoothly
Automatic, programmable text alignment and wrapping
Simple markup for setting text attributes within blocks of text
Powerful list box with programmable content for scrolling all widget types
Your choice of event loops: Twisted, Glib, Tornado, asyncio, trio, ZeroMQ or select-based loop
Pre-built widgets include edit boxes, buttons, check boxes and radio buttons
Display modules include raw, curses, and experimental LCD and web displays
Support for UTF-8, simple 8-bit and CJK encodings
24-bit (true color), 256 color, and 88 color mode support
Compatible with Python 3.7+ and PyPy
- Home Page:
Installation
To install using pip
pip install urwid
For advanced functionality extra requirements need to be installed. Example for ZeroMQ event loop and LCD display:
pip install urwid[serial,zmq]
Alternatively if you are on Debian or Ubuntu
apt-get install python3-urwid
Windows support notes
Not supported:
Terminal widget and all related render API (TermCanvas, TermCharset, TermModes, TermScroller)
Any file descriptors except sockets (Windows OS limitation)
ZMQEventLoop.
Special requirements:
Extra libraries required for curses display support:
pip install urwid[curses]
CursesDisplay incorrectly handles mouse input in case of fast actions.
Only UTF-8 mode is supported.
Testing
To run tests locally, install & run tox. You must have appropriate Python versions installed to run tox for each of them.
To test code in all Python versions:
tox # Test all versions specified in tox.ini:
tox -e py39 # Test Python 3.9 only
tox -e py39,py10,pypy3 # Test Python 3.9, Python 3.10 & pypy3
Supported Python versions
3.7
3.8
3.9
3.10
3.11
3.12
3.13
pypy3
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file urwid-2.6.16.tar.gz
.
File metadata
- Download URL: urwid-2.6.16.tar.gz
- Upload date:
- Size: 848.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 93ad239939e44c385e64aa00027878b9e5c486d59e855ec8ab5b1e1adcdb32a2 |
|
MD5 | 214f9cea321ccae131cecfaef2a4aa9a |
|
BLAKE2b-256 | 9821ad23c9e961b2d36d57c63686a6f86768dd945d406323fb58c84f09478530 |
Provenance
File details
Details for the file urwid-2.6.16-py3-none-any.whl
.
File metadata
- Download URL: urwid-2.6.16-py3-none-any.whl
- Upload date:
- Size: 297.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | de14896c6df9eb759ed1fd93e0384a5279e51e0dde8f621e4083f7a8368c0797 |
|
MD5 | 0342de197cc9fa3804dc1dd9e4fa7c26 |
|
BLAKE2b-256 | 54cb271a4f5a1bf4208dbdc96d85b9eae744cf4e5e11ac73eda76dc98c8fd2d7 |