textual-forms 0.1.2

Dynamic forms for Textual TUI Framework

Textual Forms

Dynamic forms for Textual TUI framework.

Note: This library is still very much WIP 🧪

About

Textual Forms aims to make it easy to add forms to your Textual-powered applications.

Install

pip install textual-forms

Form Field Schema

Key	Type	Required	Options
id	str	X
type	str		string, number, integer
value	str, number
required	bool
placeholder	str
rules	dict

Type Rules

string

• min_length
• max_length

integer

• min
• max

number

• N/A

Example

from rich.table import Table
from textual.app import App, ComposeResult
from textual.widgets import Static

from textual_forms.forms import TextualForm

FORM_DATA = [
    {
        'id': 'name',
        'required': True,
        'placeholder': 'name...',
        'rules': {
            'min_length': 3,
        }
    },
    {
        'id': 'age',
        'type': 'integer',
        'required': True,
        'placeholder': 'age...',
        'rules': {
            'min': 18,
            'max': 65
        }
    },
    {
        'id': 'email',
        'required': False,
        'placeholder': '[e-mail]',
    },
]


class BasicTextualForm(App):
    def compose(self) -> ComposeResult:
        yield Static(id='submitted-data')
        yield TextualForm(FORM_DATA)

    def on_textual_form_submit(self, message: TextualForm.Submit) -> None:
        table = Table(*message.data.keys())
        table.add_row(*message.data.values())
        self.query_one('#submitted-data').update(table)


if __name__ == '__main__':
    BasicTextualForm().run()

---

The above form data produces the below form

Contributing

TBD