tkterminal 0.1.0

Description:

tkterminal 0.1.0

tkterminal





This library gives Terminal widget support to the Tkinter library. Perform almost all the operations of a terminal with tkterminal.




Installation
Use the package manager pip to install with the following command:
pip install tkterminal

If you would like to get the latest master or branch from GitHub, you could also:
pip install git+https://github.com/Saadmairaj/tkterminal

Or even select a specific revision (branch/tag/commit):
pip install git+https://github.com/Saadmairaj/tkterminal@master

Usage
Terminal widget is easy to use. Type the commands just like you type in the terminal.
import tkinter as tk
from tkterminal import Terminal

root = tk.Tk()
terminal = Terminal(pady=5, padx=5)
terminal.pack(expand=True, fill='both')
root.mainloop()






Enable shell (shell=True)
If the shell is True, the specified command will be executed through the shell. This can be useful if you are using Python primarily for the enhanced control flow it offers over most system shells and still want convenient access to other shell features such as shell pipes, filename wildcards, environment variable expansion, and expansion of ~ to a user’s home directory. However, note that Python itself offers implementations of many shell-like features (in particular, glob, fnmatch, os.walk(), os.path.expandvars(), os.path.expanduser(), and shutil).
To have shell enabled terminal then set the shell to true like so
terminal = Terminal()
terminal.shell = True



Enable line number bar for the terminal (linebar=True)
If linebar is True, the terminal will have a line number bar on the left side which tells the number of the line by numbering each line of the terminal. Clicking on any number will select the specific line in the terminal. The line with the insert will be highlighted in the number bar.
To have line number bar enabled terminal then set linebar to true like so.
terminal = Terminal()
terminal.linebar = True






Command that requires input.
The tkterminal is using subprocess python module where the input can only be passed before running the command and cannot be passed after the command has ran. So the input can be pass with methods:


Through run_command(cmd, give_input=None) method.
Input can be passed directly to the parameter give_input of run_command method along with the actual command.
Example:
import tkinter as tk
from tkterminal import Terminal

root = tk.Tk()
terminal = Terminal(pady=5, padx=5)
terminal.shell = True
terminal.linebar = True
terminal.pack(expand=True, fill='both')
b1 = tk.Button(
root, text="Uninstall tkterminal", fg="Black",
command=lambda: terminal.run_command('pip uninstall tkterminal', 'y'))
b1.pack()
root.mainloop()



Directly typing into the Terminal window.
We can directly pass input into the terminal after typing the command between these HTML tags <input> ... </input> these tags are just to read user input from the command.
Example:
pip uninstall tkterminal <input>y</input>





Documentation
Terminal widget is created from the Tkinter Text widget class that makes it support all the options of a Text widget.


Configurable options for a Terminal widget. Syntax: Terminal(root, options=value, ...)



Options
Description




background
The default background color of the terminal widget.


borderwidth
The width of the border around the terminal widget. Default is 2 pixels.


cursor
The cursor that will appear when the mouse is over the terminal widget.


exportselection
Normally, text selected within a terminal widget is exported to be the selection in the window manager. Set exportselection=0 if you don't want that behavior.


font
The default font for text inserted into the widget.


foreground
The color used for text within the widget. You can change the color for tagged regions; this option is just the default.


height
The height of the widget in lines (not pixels!), measured according to the current font size.


highlightbackground
The color of the focus highlight when the terminal widget does not have focus.


highlightcolor
The color of the focus highlight when the terminal widget has the focus.


highlightthickness
The thickness of the focus highlight. Default is 0.


insertbackground
The color of the insertion cursor. Default is black.


insertborderwidth
Size of the 3-D border around the insertion cursor. Default is 0.


insertofftime
The number of milliseconds the insertion cursor is off during its blink cycle. Set this option to zero to suppress blinking. Default is 300.


insertontime
The number of milliseconds the insertion cursor is on during its blink cycle. Default is 600.


insertwidth
Width of the insertion cursor (its height is determined by the tallest item in its line). Default is 2 pixels.


padx
The size of the internal padding added to the left and right of the text area. Default is one pixel.


pady
The size of the internal padding added above and below the text area. Default is one pixel.


relief
The 3-D appearance of the terminal widget. Default is relief=SUNKEN.


selectbackground
The background color to use displaying selected text.


selectborderwidth
The width of the border to use around selected text.


spacing1
This option specifies how much extra vertical space to add between displayed lines of text when a logical line wraps. Default is 0.


spacing2
This option specifies how much extra vertical space to add between displayed lines of text when a logical line wraps. Default is 0.


spacing3
This option specifies how much extra vertical space is added below each line of text. If a line wraps, this space is added only after the last line it occupies on the display. Default is 0.


state
Normally, terminal widgets respond to keyboard and mouse events; set state=NORMAL to get this behavior. If you set state=DISABLED, the terminal widget will not respond, and you won't be able to pass commands into the terminal.


tabs
This option controls how tab characters position text.


width
The width of the widget in characters (not pixels!), measured according to the current font size.


wrap
This option controls the display of lines that are too wide. Set wrap=WORD and it will break the line after the last word that will fit. With the default behavior, wrap=CHAR, any line that gets too long will be broken at any character.


xscrollcommand
To make the terminal widget horizontally scrollable, set this option to the set() method of the horizontal scrollbar.


yscrollcommand
To make the terminal widget vertically scrollable, set this option to the set() method of the vertical scrollbar.





Methods on Terminal widget objects:



Methods
Description




.clear()
Clears the console completely.


.get_output()
Get the output of the recently run command. Returns None if no command has run else the function will return a dictionary of error and output.


.run_command(cmd, give_input=None)
Run the command into the terminal.


.tag_config(tagname, option=value...)
You can use this method to configure the tag properties, which include:- - background- foreground- font- justify (center, left, or right), - tabs (this property has the same functionality of the Text widget tabs's property)- underline (used to underline the tagged text).





Properties on Terminal widget objects:



Properties
Description




terminal.basename
Change the basename of the terminal. Default is tkterminal$


terminal.linebar
Line number bar tells the number of the line by numbering each line of the terminal. Clicking on any number will select the specific line in the terminal. The line with the insert will be highlighted in the number bar. Default is False.





Configure output, error, basename and linebar:

All output text have tag name output which can be configured with terminal.tag_config("output", option=value...) method.
All error text also have a tag name error which can be configured with terminal.tag_config("error", option=value...) method.
The basename also have a tag name basename configured with terminal.tag_config("basename", option=value...) method.
The linebar is an object of Tkinter Canvas widget which can be configured with terminal.linebar.configure(option=value ...). And each number line is a canvas item whose tag name is the number itself that can be configured with terminal.linebar.itemconfigure('item', options...).