Skip to main content

Add forms to your terminal applications

Project description

TerminalForms

Add forms to your terminal applications


Installation

pip install terminal forms

note: Depending on your python installation, the command mayt vary. For example, if you are using python3, you may need to use pip3 instead of pip.

Usage

from terminalforms import Form, Field, Checkbox, Radio, Select, Text, Password, Submit

form = Form(
    title="Example Form",
    description="Please fill out the following information:",
    content=[
        Text("Welcome to the example form!"),
        Field("Name"),
        Checkbox("Agreement", "Do you agree to the terms and conditions?"),
        Select("Fruit", "Select your favorite fruit:", ["Apple", "Banana", "Orange"]),
        Radio("Gender", "Select your gender:", ["Male", "Female", "Other"]),
        Password("Password"),
        Submit("Submit")
    ]
)

form.show()
answers = form.get_all()
print(answers)
name = form.get("Name")
print(name)

Documentation

Form

Parameters
  • title - The title of the form
  • description - The description of the form
  • content - The content of the form
Methods
  • show() - Show the form
  • get(name) - Get the value of a field
  • get_all() - Get all the values of the fields
  • set(name, value) - Set the value of a field
  • clear() - Clear all the values of the fields

Field

Parameters
  • name - The name of the field
  • value - The value of the field
Methods
  • ask() - Ask the user for the value of the field

Text

Parameters
  • text - The text of the text
Methods
  • text() - Show the text

Checkbox

Parameters
  • name - The name of the checkbox
  • question - The question of the checkbox
Methods
  • ask() - Ask the user for the value of the checkbox

Radio

Parameters
  • name - The name of the radio
  • question - The question of the radio
  • options - The options of the radio
Methods
  • ask() - Ask the user for the value of the radio

Select

Parameters
  • name - The name of the select
  • question - The question of the select
  • options - The options of the select
Methods
  • ask() - Ask the user for the value of the select

Password

Parameters
  • name - The name of the password
  • value - The value of the password
  • mask - The mask of the password
Methods
  • ask() - Ask the user for the value of the password

Submit

Parameters
  • name - The name of the submit
Methods
  • ask() - Ask the user for the value of the submit

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

terminalforms-1.2.tar.gz (3.7 kB view hashes)

Uploaded Source

Built Distribution

terminalforms-1.2-py3-none-any.whl (4.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page