4S y@s dZddlmZmZmZddlZddlZddlZddlmZm Z m Z m Z m Z m Z mZdmZdpZdqZdrZdsZidtd6ZGdddZGd d d eZGd d d eZGd ddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZiej d6ej!d6ej"d6ej#d 6ej$d!6ej%d"6ej&d#6ej'd$6ej(d%6ej)d&6ej*d'6ej+d(6ej,d)6ej-d*6ej.d+6ej/d,6ej0d-6ej1d.6e2d/d/6Z3x(e4e3j5D]Z6e6e3e3e6d76ej?d86ej@d96ejAd:6ejBd;6ejCd<6ejDd=6ejEd>6ejFd?6ejGd@6ejHdA6ejIdB6ejJdC6ejKdD6ejLdE6ejMdF6ejNdG6ejOdH6ejPdI6ejQdJ6ejRdK6ejSdL6ZTGdMdNdNZUdOdOdPdQZVGdRdSdSeZWGdTdUdUe<ZXGdVdWdWe<ZYGdXdYdYe<ZZGdZd[d[eZZ[Gd\d]d]eZ\dud`ddvdddadbZ]d^d_gd`ddddcddZ^dd`ded^d_gddfdgZ_Gdhdidie<Z`djdkZadS)wa This module provides the NEWT Windowing toolkit API for Python This is a lightweight text-mode windowing library, based on slang. Classes: - Widget - Button - CompactButton - Checkbox - SingleRadioButton - Listbox - Textbox - TextboxReflowed - Label - Scale - Entry - Form - Grid - SnackScreen - RadioGroup - RadioBar - ButtonBar - GridFormHelp - GridForm - CheckboxTree - Clistbox Functions: - ListboxChoiceWindow - ButtonChoiceWindow - EntryWindow )absolute_importprint_functionunicode_literalsN) FLAG_DISABLED FLAGS_SET FLAGS_RESET FLAGS_TOGGLEFD_READFD_WRITE FD_EXCEPTappendc@s1eZdZdZdddZddZdS)WidgetzBase class for NEWT toolkit - Do not use directly methods: - Widget(self) - setCallback(self, obj, data = None) : The callback for when object activated. data is passed to obj. NcCs0|r|jj||n|jj|dS)N)w setCallback)selfobjdatar'/usr/lib/python3/dist-packages/snack.pyrDszWidget.setCallbackcCs tdS)N)NotImplementedError)rrrr__init__JszWidget.__init__)__name__ __module__ __qualname____doc__rrrrrrr:s rc@s"eZdZdZddZdS)ButtonzqBasic button class, takes button text as parameter method: - Button(self, text): returns a button cCstj||_dS)N)_snackbuttonr)rtextrrrrTszButton.__init__N)rrrrrrrrrrMs rc@s"eZdZdZddZdS) CompactButtonzCompact Button class (less frilly button decoration). methods: - CompactButton(self,text) : create button, with text. cCstj||_dS)N)rZ compactbuttonr)rrrrrr^szCompactButton.__init__N)rrrrrrrrrr Ws r c@sUeZdZdZddZddZddZdd Zd d d Zd S)CheckboxaA checkbox. methods: - Checkbox(self, text, isOn = 0) : text, and boolean as to default value - setValue(self) : set value - value(self, value) : return checkbox value - selected(self) : returns boolean - setFlags(self, flag, sense) : set flags flags: FLAG_DISABLED, FLAGS_SET, FLAGS_RESET cCs |jjS)N)r checkboxValue)rrrrvaluenszCheckbox.valuecCs|jjdkS)Nr)rr")rrrrselectedqszCheckbox.selectedcCs|jj||S)N)rZcheckboxSetFlags)rflagsenserrrsetFlagstszCheckbox.setFlagscCs|jj|S)N)rZcheckboxSetValue)rr#rrrsetValuexszCheckbox.setValuercCstj|||_dS)N)rZcheckboxr)rrisOnrrrr{szCheckbox.__init__N) rrrrr#r$r'r(rrrrrr!as     r!c@s1eZdZdZddZdddZdS)SingleRadioButtonzSingle Radio Button. methods: - SingleRadioButton(text, group, isOn = 0) : create button - selected(self) : returns bool, whether or not is selected. cCs|jj|jjkS)N)rkeyZ radioValue)rrrrr$szSingleRadioButton.selectedrcCs@|r$tj||j||_ntj|d||_dS)N)rZ radiobuttonr)rrgroupr)rrrrszSingleRadioButton.__init__N)rrrrr$rrrrrr*~s  r*c@seZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddddddddZ dS)ListboxaListbox class. methods: - Listbox(self, height, scroll = 0, returnExit = 0, width = 0, showCursor = 0, multiple = 0, border = 0) - insert(self, text, item, before) : insert element; before = key to item to insert before, or None. - delete(self, item) : delete item from list. - replace(self, text,item) : Replace a given item's text - current(self) : returns currently selected item - getSelection(self) : returns a list of selected items - setCurrent(self,i tem) : select current. - clear(self) : clear listbox cCs0|jj|}||j|<||j|g}|jj}x"|D]}|j|j|qW|S)N)rZlistboxGetSelectionr r.)r selectionlistr+rrr getSelections  zListbox.getSelectioncCs|jj|j|dS)N)rZlistboxSetCurrentr/)rr0rrr setCurrentszListbox.setCurrentcCs#i|_i|_|jjdS)N)r.r/rZ listboxClear)rrrrclears  z Listbox.clearrcCsPtj|||||||_i|_i|_|rL|jj|ndS)N)rlistboxrr.r/ZlistboxSetWidth)rheightscroll returnExitwidthZ showCursorZmultipleZborderrrrrs !  zListbox.__init__N) rrrrr r3r5r6r7r:r;r<rrrrrr-s         r-c@s@eZdZdZddZddZddddZd S) TextboxaTextbox, container for text. methods: - Textbox(self, width, height, scroll = 0, wrap = 0): scroll, wrap are flags include scroll bars, or text wrap. - setText(text) : set text. - setHeight(height): set height. cCs|jj|dS)N)rZ textboxText)rrrrrsetTextszTextbox.setTextcCs|jj|dS)N)rZ textboxHeight)rr>rrr setHeightszTextbox.setHeightrcCs"tj||||||_dS)N)rZtextboxr)rrAr>rr?ZwraprrrrszTextbox.__init__N)rrrrrCrDrrrrrrBs   rBc@s%eZdZdddddZdS)TextboxReflowed r cCsot||||\}}}|dkrR||krRtj||||dntj||||ddS)Nr r)reflowrBr)rrArflexDownflexUp maxHeightZnewtextr>rrrrszTextboxReflowed.__init__NrH)rrrrrrrrrEs rEc@s:eZdZdZddZddZddZdS) LabelzA Label (simple text). methods: - Label(self,text) : create label - setText(self,text) : change text. - setColors(self, colorset) : change individual colors cCs|jj|dS)N)rZ labelText)rrrrrrCsz Label.setTextcCstj||_dS)N)rlabelr)rrrrrrszLabel.__init__cCs|jj|dS)N)rZlabelSetColors)rcolorsetrrr setColorsszLabel.setColorsN)rrrrrCrrPrrrrrMs   rMc@s.eZdZdZddZddZdS)ScalezA Scale (progress bar). methods: - Scale(self,width, total) : create scale; width: size on screen, fullamount: integer. - set(self,amount) : set amount to integer. cCs|jj|dS)N)rZscaleSet)rZamountrrrsetsz Scale.setcCstj|||_dS)N)rZscaler)rrAZtotalrrrr szScale.__init__N)rrrrrRrrrrrrQs  rQc@sXeZdZdZddZdddZddZd d d dd d d Zd S)EntryaEntry widget. methods: - Entry(self, width, text = "", hidden = 0, password = 0, scroll = 1, returnExit = 0) constructor. hidden doesn't show text, password stars it out, scroll includes scroll bars; if returnExit is set, return from Form when exiting this element, else proceed to next entry widget. - value(self): return value. - set(text, cursorAtEnd = 1) : set the text - setFlags (flag, sense) : flags can be FLAG_DISABLED, FLAGS_SET, FLAGS_RESET, FLAGS_TOGGLE cCs |jjS)N)rZ entryValue)rrrrr#sz Entry.valuer cCs|jj||S)N)rZ entrySetValue)rrZ cursorAtEndrrrrRsz Entry.setcCs|jj||S)N)rZ entrySetFlags)rr%r&rrrr'"szEntry.setFlagsrcCs%tj|||||||_dS)N)rentryr)rrArZhiddenZpasswordr?r@rrrr%szEntry.__init__N)rrrrr#rRr'rrrrrrSs    rSZF1ZF2ZF3ZF4ZF5ZF6ZF7ZF8ZF9ZF10ZF11ZF12ZESCZENTERZSUSPENDZ BACKSPACEZDELETEZINSERT cCs"g|]}t||fqSr)ord).0crrr 7s rZc@syeZdZdZddZddZddZdd Zd d d Zd dZ ddZ ddZ d S)Forma Base Form class, from which Grid, etc. inherit methods: - Form(self, helpArg = None) : constructor. - addHotKey(self, keyname) : keynames of form "F1" through "F12", "ESC" - add(self, widget) : Add a widget - run(self): run a form, expecting input - draw(self): draw form. - setTimer(self, timer) : add a timer - watchFile(self, file, flags) : watch a named file - setCurrent (self, co): Set a given widget as the current focus cCs|jjt|dS)N)rZ addhotkeyhotkeys)rkeynamerrr addHotKeyIszForm.addHotKeycCsd|jkr9x'|jjD]}|j|qWnd|jkrlxV|jD]}|j|qRWn5d|jkr||j|jj<|jj|jSdS)Nr\ gridmembersr) __dict__r\keysr^r_addtransrr+)rwidgetr+rrrrrbLszForm.addcCsd|jj\}}|tjkr/|j|S|tjkrBdS|tjkr\|j|St|S)NZTIMER) rrunrZFORM_EXIT_WIDGETrcZFORM_EXIT_TIMERZFORM_EXIT_FDREADYfilemapr\)rwhatZwhichrrrreYs  zForm.runcCs|jjdS)N)rdraw)rrrrrhds z Form.drawNcCs1i|_i|_tj||_||_dS)N)rcrfrformrhelpArg)rrjrrrrhs  z Form.__init__cCs|jj|jdS)N)rZ setcurrent)rcorrrr;oszForm.setCurrentcCs|jj|dS)N)rZsettimer)rZtimerrrrsetTimerrsz Form.setTimercCs0||j|j<|jj|j|dS)N)rffilenorZwatchfd)rfileflagsrrr watchFileuszForm.watchFile) rrrrr^rbrerhrr;rlrprrrrr[;s     r[c @sOeZdZdZddZd ddddddddZddZd S) GridayGrid class. methods: - place(self,x,y): Return what is placed at (x,y) - setField(self, what, col, row, padding = (0, 0, 0, 0), anchorLeft = 0, anchorTop = 0, anchorRight = 0, anchorBottom = 0, growx = 0, growy = 0): used to add widget 'what' to grid. - Grid(self, *args): eg. g = Grid(2,3) for 2x3 grid cCs|jj||S)N)gplace)rxyrrrrssz Grid.placerc Cs|jj|d} |r(tj} n|r:tj} n|rP| tjB} n|rf| tjB} nd} | r~tj} n| r| tjB} nd|j kr|j j |||j || | S|j j |||j || SdS)Nrrr) r_r rZ ANCHOR_LEFTZ ANCHOR_RIGHTZ ANCHOR_TOPZ ANCHOR_BOTTOMZ GRID_GROWXZ GRID_GROWYr`rrZsetfieldr) rrgcolrowpadding anchorLeft anchorTop anchorRight anchorBottomgrowxgrowyZ anchorFlagsZ gridFlagsrrrsetFields&   z Grid.setFieldcGstj||_g|_dS)N)rgridrrr_)rargsrrrrsz Grid.__init__N)rrrr)rrrrrsrrrrrrrqys   rqZROOTZBORDERZWINDOWZSHADOWZTITLEZBUTTONZ ACTBUTTONZCHECKBOXZ ACTCHECKBOXZENTRYZLABELZLISTBOXZ ACTLISTBOXZTEXTBOXZ ACTTEXTBOXZHELPLINEZROOTTEXTZ EMPTYSCALEZ FULLSCALEZDISENTRYZ COMPACTBUTTONZ ACTSELLISTBOXZ SELLISTBOXc@seZdZdZddZddZddZdd Zd d Zd d Z dddZ ddZ ddZ ddZ ddZddZddddZdddZd d!Zd"d#ZdS)$ SnackScreena A Screen; methods: - Screen(self) : constructor - finish(self) - resume(self) - suspend(self) - doHelpCallback(self,arg) call callback with arg - helpCallback(self,cb): Set help callback - suspendcallback(self,cb, data=None) : set callback. data=data to pass to cb. - openWindow(self,left, top, width, height, title): Open a window. - pushHelpLine(self,text): put help line on screen. Returns current help line if text=None - setColor(self, colorset, fg, bg): Set foreground and background colors; colorset = key from snack.colorsets, fg & bg = english color names defined by S-Lang (ref: S-Lang Library C Programmer's Guide section: 8.4.4. Setting Character Attributes) cCs3tjtj\|_|_|jddS)N)rZinitsizerAr> pushHelpLine)rrrrrs zSnackScreen.__init__cCs tjS)N)rfinish)rrrrrszSnackScreen.finishcCstjdS)N)rresume)rrrrrszSnackScreen.resumecCstjdS)N)rsuspend)rrrrrszSnackScreen.suspendcCs|j||dS)N)helpCb)rargrrrdoHelpCallbackszSnackScreen.doHelpCallbackcCs||_tj|jS)N)rrZ helpcallbackr)rcbrrr helpCallbacks zSnackScreen.helpCallbackNcCs#|rtj||Stj|S)N)rZsuspendcallback)rrrrrrsuspendCallbackszSnackScreen.suspendCallbackcCstj|||||S)N)rZ openwindow)rlefttoprAr>titlerrr openWindowszSnackScreen.openWindowcCs$|stjdStj|SdS)Nz *default*)rZ pushhelpline)rrrrrrs zSnackScreen.pushHelpLinecCs tjS)N)rZ pophelpline)rrrr popHelpLineszSnackScreen.popHelpLinecCstj|||S)N)rZ drawroottext)rrrrrrr drawRootTextszSnackScreen.drawRootTextcCstj|||S)N)rZcenteredwindow)rrAr>rrrrcenteredWindowszSnackScreen.centeredWindowcCs8|r%|r%tj|j|||Stj|j|S)N)rZgridwrappedwindowrr)rrrrtrurrrgridWrappedWindows zSnackScreen.gridWrappedWindowTcCs|rtjStjS)N)rZ popwindowZpopwindownorefresh)rrefreshrrr popWindows zSnackScreen.popWindowcCs tjS)N)rr)rrrrr szSnackScreen.refreshcCs:|tkr#tjt|||Stj|||SdS)N) colorsetsrZsetcolor)rrOZfgZbgrrrsetColor s zSnackScreen.setColor)rrrrrrrrrrrrrrrrrrrrrrrrrs"             rrFcCstj||||S)zR returns a tuple of the wrapped text, the actual width, and the actual height )rrI)rrArJrKrrrrIsrIc@s=eZdZdZddZdddZddZdS) RadioGroupz Combo widget: Group of Radio buttons methods: - RadioGroup(self): constructor. - add(self,title, value, default = None): add a button. Returns button. - getSelection(self) : returns value of selected button | None cCsd|_g|_dS)N)prev buttonlist)rrrrr$s zRadioGroup.__init__NcCsW|j r|dkrd}nt||j|}||_|jj||f|S)Nr )rr*rr )rrr#defaultbrrrrb(s   zRadioGroup.addcCs.x'|jD]\}}|jr |Sq WdS)N)rr$)rrr#rrrr:2s zRadioGroup.getSelection)rrrrrrbr:rrrrrs   rc@s.eZdZdZddZddZdS)RadioBarz Bar of Radio buttons, based on Grid. methods: - RadioBar(self, screen, buttonlist) : constructor. - getSelection(self): return value of selected button cCsg|_d|_t|_tj|dt|xq|D]i\}}}|jj|||}|jj||f|j |d|jdd|jd|_q>WdS)Nrr ry) r9r0rr,rqrlenrbr r)rscreenrrr#rrrrrrAs   zRadioBar.__init__cCs |jjS)N)r,r:)rrrrr:LszRadioBar.getSelectionN)rrrrrr:rrrrr8s  rc@s1eZdZdZdddZddZdS) ButtonBara Bar of buttons, based on grid. methods: - ButtonBar(screen, buttonlist,buttonlist, compact = 0): - buttonPressed(self, result): Takes the widget returned by Form.run and looks to see if it was one of the widgets in the ButtonBar. rc Csg|_i|_d|_tj|t|dx|D]}t|tjdkr\t nt rz|}|j }n=t|dkr|\}}n|\}}}||j|<|rt |}n t |}|jj||f|j||jdd|jd|_q;WdS)Nrr 3)r rr r)r9r\r0rqrr isinstancesysversionstr basestringlowerr rr r) rrrZcompactZblistrr#Zhotkeyrrrrr[s$    $  zButtonBar.__init__cCsH||jkr|j|Sx'|jD]\}}||kr$|Sq$WdS)N)r\r9)rresultrr#rrr buttonPressedrs   zButtonBar.buttonPressedN)rrrrrrrrrrrRs rc @seZdZdZddZdddddddddZdddd Zd d Zd d ZddddZ ddddZ ddZ ddZ ddZ dS) GridFormHelpa= Subclass of Grid, for the help form text. methods: - GridFormHelp(self, screen, title, help, *args) : - add (self, widget, col, row, padding = (0, 0, 0, 0), anchorLeft = 0, anchorTop = 0, anchorRight = 0, anchorBottom = 0, growx = 0, growy = 0): - runOnce(self, x = None, y = None): pop up the help window - addHotKey(self, keyname): - setTimer(self, keyname): - create(self, x = None, y = None): - run(self, x = None, y = None): - draw(self): - runPopup(self): - setCurrent (self, co): cGsi||_||_t||_g|_d|_t|}|g|ddr?rAZ hide_checkboxZ unselectablerrrrs   zCheckboxTree.__init__cCs>g}|jj}x"|D]}|j|j|qW|S)N)rZcheckboxtreeGetSelectionr r.)rr8r9r+rrrr:s  zCheckboxTree.getSelectioncCs|jj|j||dS)N)rZcheckboxtreeSetEntryr/)rr0rrrrsetEntryszCheckboxTree.setEntrycCs|jj|j|dS)N)rZcheckboxtreeSetCurrentr/)rr0rrrr;szCheckboxTree.setCurrentr cCs|jj|j||dS)N)rZcheckboxtreeSetEntryValuer/)rr0r$rrr setEntryValueszCheckboxTree.setEntryValuecCs|jj|j|S)N)rZcheckboxtreeGetEntryValuer/)rr0rrr getEntryValueszCheckboxTree.getEntryValue) rrrrr rrrr:rr;rrrrrrrs     rOkCancel(c  Csw|d krt|}nt||} t||} t|d|dd} d} x|D]w}t|tkr|\}}n |}| }|| kr|}n||kr|}n| j||| d} q^W|dkr| j|nt||| dd}|j | dd|j | dddd |j | ddd d|j }| j || j fS) z - ListboxChoiceWindow(screen, title, text, items, buttons = ('Ok', 'Cancel'), width = 40, scroll = 0, height = -1, default = None, help = None): r r?r@rNrxrr}rH)rr rr ) rrrEr-typerr r;rrbrrr7)rrritemsbuttonsrAr?r>rrbbtlcountr0r+rrrcrrrListboxChoiceWindows2        rc Cst||}t||d|jd} t|||dd} | j| dddd| j|dddd|j| j||S) z - ButtonChoiceWindow(screen, title, text, buttons = [ 'Ok', 'Cancel' ], width = 40, x = None, y = None, help = None): rL r rrrxr})rrrr )rrEr>rrbrr) rrrrrArtrurrrrrrrrButtonChoiceWindow3s rc  Cst||} t||} d} x|D]} | d} q+Wtd| } d} g}x|D]} t| tkr| \} }t|tjdkrtnt rt ||}qn t |}| j t | d| dd dd| j |d| dd| d} |j |qaWt|||dd}|j| dddd |j| dddd |j| dddd|j}g}d} x/|D]'} |j || j| d} qW| j|t|fS) z EntryWindow(screen, title, text, prompts, allowCancel = 1, width = 40, entryWidth = 20, buttons = [ 'Ok', 'Cancel' ], help = None): rr rrrxryrr})rrr r)rrrr )rrrr )rrErqrrrrrrrrSrrMr rrbrr#r)rrrZpromptsZ allowCancelrAZ entryWidthrrrrrnZsgZ entryListerrrZ entryValuesrrr EntryWindowCs:   $ %   rc @seZdZdZddddddddddZddddZdd d Zdd d Zd dZdddZ ddZ ddZ ddZ dS)CListboxapClistbox convenience class. methods: - Clistbox(self, height, cols, cols_widths, scroll = 0) : constructor - colFormText(self, col_text, align = None, adjust_width = 0) : column text. - append(self, col_text, item, col_text_align = None) : - insert(self, col_text, item, before, col_text_align = None) - delete(self, item) - replace(self, col_text, item, col_text_align = None) - current(self) : returns current item - setCurrent(self, item): sets an item as current - clear(self): clear the listbox Alignments may be LEFT, RIGHT, CENTER, None rr Nc Cs||_|dd|_||_||_| dkrtj|ddd} |j| | d| } t| |_|j |jddddntj|ddd} t |||||_ |j |j d| dddS)Nr r adjust_widthrryr{) cols col_widthscol_padcol_text_alignrqr colFormTextrMrNrr-r=)rr>rrr?r@rArrZ col_labelsZcol_label_alignrZbox_yZlstrrrrrs     zCListbox.__init__c Csd}d}t|}xl||jkr||kr||}tj|}|j||kr|rx||j|(s   4   A ! * >.                       U*I 9 ) -s