| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| README | 2010-07-18 | 2.5 kB | |
| sform.conf | 2010-07-18 | 14.7 kB | |
| sform | 2010-07-18 | 59.4 kB | |
| Totals: 3 Items | 76.6 kB | 0 | |
Introduction ------------ Welcome to the sform project page ! sform is a Perl utility made for developpers that likes unix text consoles, and need to build user interfaces there. Unix developpers used to build user interfaces with the famous and very good "dialog" utility (or one of the numerous variant), but all these utilities are not so easy to use as programmer, especially when you need to handle multiple fields forms. My wish for sform was to develop a simple utility for the programmer. It's actually designed to work in 3 simple steps as follows : - you put all the forms you want in a sform.conf flat file, describing all the fields and their attributes. - you run sform in a single command line (ie : sform "myform1" sform.conf) - you get a flat and easy to parse file that contains the result (what the user did and the values for each fields of the form) Features -------- - auto-draw : you just put fields in the order you want them to be displayed and that's it. The layout is handled automatically by sform. - auto-adjust to console screen size. It means also there's no limitation regarding the size of the form, because both horizontal and vertical scrolling are featured, - magic keys (F2, F3, F4) to abort, validate or reset the form, - compatible with numerous fields types like : text and password fields, and dropdown, radio and checkbox fields and also "hidden" fields, - programmable fields names, initial values and independent displayed values for each fields and form buttons - comments allowed in sform.conf file (starting with #) - a text file is automatically generated and contains numerous informations like start and end date of user input, the form ID, title and how the process was terminated (abort or validate). Then each fields are recalled with the values they had upon program exit (or a checked/unchecked mark for relevant fields). The format of this result file is made to be "grep" friendly, at least easy to parse for a regular Unix developper. Requirements ------------ - tested successfully under cygwin rxvt console and mandriva VT100 console - of course, Perl5 is a mandatory, because sform is written in that language Known bugs ---------- - Actually, looks like certain VT100 terminals do not send the same codes for functions keys. I have to investigate to make function keys working in a great number of configurations. Project history --------------- 2010, july, 18th : Publication on SourceForge 2010, may, 5th : First release of the sform utility, after 3 full-time weeks of work
