Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/as400jplpc/zig_termcurs
Terminal access function Zig-Lang and Generator
https://github.com/as400jplpc/zig_termcurs
curses-library generator linux terminal zig zig-lang
Last synced: about 1 month ago
JSON representation
Terminal access function Zig-Lang and Generator
- Host: GitHub
- URL: https://github.com/as400jplpc/zig_termcurs
- Owner: AS400JPLPC
- License: mit
- Created: 2023-06-09T18:49:27.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-01T17:02:32.000Z (3 months ago)
- Last Synced: 2024-10-14T02:40:37.507Z (about 1 month ago)
- Topics: curses-library, generator, linux, terminal, zig, zig-lang
- Language: Zig
- Homepage:
- Size: 23.7 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# zig_TermCurs
terminal access function
**zig 0.14.DEV**
**TESTING**
*look at the bottom of the testing page*
**os linux**
Normally should work POSIX
**the termcurs library, does what ncurse does (hopefully).
it manages the interface between the terminal and the user.
as does the 5250 of the OS400 with PC sauce.
Panel, window, field, grid, menu etc.
this can be used with a terminal with some editing eg: F10 etc. for convenience.
the easiest way is to make your own terminal with libvte of which I provide an example in the src-c folder.
this produces very lightweight programs for doing utilities or intensive typing for business management.
Currently everything is not operational and the goal is to make a screen generator to simplify development, considering that this is only secondary and that the heart of the problem is the program itself and not the interface.
**
** I use the gencurs program to thoroughly test the termcurs lib.
**
Thank you
a little more : XYAMAN
Resumption of the project https://github.com/xyaman/mibu
Thank you
https://zig.news/
https://zig.news/lhp/want-to-create-a-tui-application-the-basics-of-uncooked-terminal-io-17gm
thank you for your valuable explanations David Vanderson
https://zig.news/david_vanderson
Structure the complex build
https://zig.news/xq/zig-build-explained-part-3-1ima
thank you for your valuable explanations Sam Atman
https://github.com/mnemnion/mvzr/
extra..., to follow and have a history
https://github.com/kissy24/zig-logger/
**In the example, some errors are introduced such as the mail, all of this is voluntary and allows you to see the default interaction of the input control.
**
---
| Field | Regex | Text | Type |
| ---------------------- | -------------- | ---------- | ---------------------------------------- |
| TEXT_FREE | Y | Y | Free |
| TEXT_FULL | Y | Y | Letter Digit Char-special |
| ALPHA | Y | Y | Letter |
| ALPHA_UPPER | Y | Y | Letter |
| ALPHA_NUMERIC | Y | Y | Letter Digit espace - |
| ALPHA_NUMERICT_UPPER | Y | Y | Letter Digit espace - |
| PASSWORD | N | Y | Letter Digit and normaliz char-special |
| YES_NO | N | Y | 'y' or 'Y' / 'o' or 'O' |
| UDIGIT | N | Y | Digit unsigned |
| DIGIT | N | Y | Digit signed |
| UDECIMAL | N | Y | Decimal unsigned |
| DECIMAL | N | Y | Decimal signed |
| DATE_ISO | DEFAULT | Y | YYYY/MM/DD |
| DATE_FR | DEFAULT | Y | DD/MM/YYYY |
| DATE_US | DEFAULT | Y | MM/DD/YYYY |
| TELEPHONE | Y OR DEFAULT | Y | +(033) 6 00 01 00 02 |
| MAIL_ISO | DEFAULT | Y | normalize mail regex |
| SWITCH | N | N / BOOL | CTRUE CFALSE |
| FUNC | N | y | **dynamic function call** |
| TASK | N | y | **dynamic function call ex: control** |
| CALL | N | y | **dynamic call exter |
| | | | |
MOUSE
| Type | up | down | left | Middle | right | X/Y |
| -------- | ---- | ------ | ------ | -------- | ------- | ----- |
| Menu | Y | Y | Y | Y | Y | N |
| GRID | Y | Y | Y | Y | Y | N |
| FIELD | Y | Y | Y | Y | Y | N |
| getKEY | Y | Y | Y | Y | Y | Y |
|
| | | | | | |
FIELD
| KEY | text |
| ----------- | ---------------------------------------------|
| MOUSE | mouse array reference |
| escape | Restores the original area |
| ctrl-H | Show help |
| ctrl-P | exec program extern |
| home | Position at start of area |
| end | Position at end of area |
| right | Position + 1 of area |
| tab | Position + 1 of area |
| left | Position - 1 of area |
| shift tab | Position - 1 of area |
| bacspace | Position -1 of area and delete char |
| bacspace | Position of area and delete char |
| insert | Position of area change cursor |
| enter | Control valide update origine next field |
| up | Control valide update origine prior field |
| down | Control valide update origine next field |
| char | Treatment of the character of the area |
| func | Interactive function linked to the input area. |
| task | Task executed after input in the zone. |
| call | Interactive function exec program extern |
GRID
| KEY | text |
| ---------- | -------------- |
| MOUSE | active |
| escape | return key |
| F12 | return key |
| enter | return ligne |
| up | prior ligne |
| down | next ligne |
| pageUp | prior page |
| pageDown | next page |
| return | Arg |
COMBO
| KEY | text |
| ---------- | ------------------------ |
| CellPos | Position start display |
| MOUSE | active |
| escape | return key |
| enter | return field |
| up | prior ligne |
| down | next ligne |
| pageUp | prior page |
| pageDown | next page |
|
| |
---Organization-project------------------------------------------
→ folder deps: Filing of files zig including reference sources
→ folder library: zig source files
→ folder src_c: C/C++ source files
→ folder src_zig: ZIG-lang source files
→ folder lib: src xx.H source files
→ build: build+source-name ex: buildexemple
→ makefile
**LIBRARY**
--peculiarity-------------------------------------------------
test alt-ctrl ctrshift... etc for
But it is no longer transportable.
another way is to use IOCTL but again, there is a good chance of being forced to use root.
Anyway, to make management applications or Terminal type tools are more than enough.
ctrl or alt combinations plus Fn(1..36) TAB Backspace home end insert delete pageup pagedown enter escape alt ctrl left rigth up down altgr mouse
and the utf8 keyboard is a lot.
--styling-------------------------------------------------
make it compatible as close as possible to IBM 400 ex:
ex: pub const AtrLabel : stl.ZONATRB = .{
.styled=[_]i32{@enumToInt(stl.Style.styleBright),
@enumToInt(stl.Style.styleItalic),
@enumToInt(stl.Style.notstyle),
@enumToInt(stl.Style.notstyle)},
.backgr = stl.BackgroundColor.bgBlack,
.backBright = false,
.foregr = stl.ForegroundColor.fgGreen,
.foreBright = true
};
-------Current treatments------------------------------------
→ forms.zig
→ fram / panel / label /button / Menu / Grid / Combo / dynamic function Exec ** OK
→ Preparation of "Field" processing as well as keyboard input.
Please wait, if there are bugs everything is not fixed.
-------TESTING------------------------------------
→ *Use the gtk Term.c terminal, it's much simpler terminals ex: exf4-terminal*
-------To write and think--------------------------------
→ inspiration `
`
* [nim-termcurs](https://github.com/AS400JPLPC)
---------------------------------------------------------
| for information|
→ 2023-02-28
Hello, it is now possible to use a terminal without leaving a trace, I added in "curse" the "reset" function,
on the other hand, i included in the cls function the underlying cleanup of the terminal, i put here the terminal start function for, you help ( xfce4-terminal --hide-menubar --hide-scrollbar --hide -toolbar --geometry="158x42" --font="DejaVu Sans Mono 12" just add -e ./...program
→ 2023-02-28
**Applications no longer need lib-GTK VTE**
in general to debug well, to use the console, it is advisable to deactivate preferences F10 and ALT... ,
then compile with SMALL and to ensure violation of ALT-F4 use the cpp program gtk-vte an example is there.
But in terminal mode the application is viable (to do with the commit data-base)
→ 2023-02-05 Doc version 0.11.1 "view use TermCurs"
[READ-DOCS](http://htmlpreview.github.io/?https://github.com/AS400JPLPC/zig_TermCurs/blob/master/Docs_Exemples/index.html)
les news:
→ 2024-01-04
LINUX
Should it work with MAC?
TRADUCTOR chatgpt
Hello, there are very significant changes, why?
Firstly, for better memory management.
Greater coherence.
All modules have their own allocators.
Avoiding back-and-forth between modules.
"CURSED" (named in memory of "NCURSEW"):
Encompasses everything needed for writing to a terminal, including reading keyboard codes, mouse management, cursor handling, UTF8 work. I may introduce the "termios" concept for META codes. I took advantage of the restructuring to bring clarification.
"FORMS":
Includes management for:
LABEL - BUTTON - LINEV - LINEH - FIELD - FRAME - PANEL
Works with a matrix corresponding to the terminal surface so that the window can be restored. The FORMS allocator is designed for Fields and panel initialization. FORMS no longer includes GRID management, which is autonomous, nor MENU, which is autonomous
"GRID":
Functions similarly to forms, allowing the display and retrieval of arguments either from a database or working as a combo. It is autonomous, but you must consider that it should be included in your Panel, as it positions itself within the terminal window.
"MENU":
Operates like GRID but is much simplified; the returned argument is usize.which doesn't work with the matrix but directly with the terminal.
"UTILS": (various tools and functions)
Contains various functions to manage the control needs of FIELD or STRING management ([] u8 const).
The Example program demonstrates how to manage and use these functions. A tip: the first Panel can serve as the definition of the terminal window.
"MATCH": (regex MVZR pur zig)
"LOGGER":
Allows for a written record of variables or waypoints.
"CALLPGM": Executes in Zig mode, manages the call and the wait.
→ PANEL
Adding the 'mdlPanel' function.
- F2 : view panel
- F6 : Choix panel for update
- F9 : Create Panel
- F11 : Update Panel
- F12 : return
→ FORMS
Adding the 'mdlForms' function.
- F1 : help
- F11 : update and return
- F12 : return
- Alt-T: Create Title
- Alt-L: Create Label
- Alt-F: Create Field
- Alt-U: Update Field
- Alt-H: Creat Line Horizontal
- Alt-V: Creat Line Vertical
- Alt-W: Tools menu (View , Order , Remove )
→ GRID
Adding the 'mdlGrid' function.
- F1 : help
- F11 : update and return
- F12 : return
- Alt-G: Create GRID definition
- Alt-C: Create text columns
- Alt-R: Remove GRID
- Alt-W: Tools menu (View GRID, View Cell, Order Cell, Remove Cell)
→ MENU
Added MENU definition function
you have to understand the menu option as a fixed combo with constant values
- F1 : help
- F11 : update and return
- F12 : return
- Alt-M: Create MENU definition
- Alt-C: Create / UPDATE text columns
- Alt-W: Tools menu (View MENU, Remove MENU)
- Alt-X: Fixed display menu
- Alt-R: Fefresh terminal
→ Gensrc
Added Gensrc definition Programme
- Dspf : choix du model
- Control : list control
- List : List of the DSPF nomencalature
- Link-Combo : combo assignment CtrlV validation
- outSrc : ????
- Clear *all : Cleaning arraylist buffers
- Exit : Exit
→ 2024-08-20
- Test programme Gensrc. It remains to determine the folders of the lists and the source output
- To see how it works dspf/ntest
→ 2024-08-25
- Improved isMatch regex from forms function
- watch the program exemple.zig
→ 2024-09-01
- be careful from branch 0.14. dev 1391 there are changes ex: @typeInfo(EnumTag).@"enum".fields (before .enum.fields)
- delete -> setClod(true)
- add Alt-X function display menu
- add Alt-R function display terminal actif
- x,y menu positioning fix
------------------------------------------------------------------
Now that the entire designer allows for saving and restoring the code, this has allowed me to test my functions, and especially to take a little tour of the Zig language. I opted for working and writing with maximum use of the Zig language, so I don't use addressing or hex code; everything is in Zig.
PAUSE
In the current state, one could very well use JSON files and encapsulate them in the program, and why not make the forms in the project dynamic... I did this on the AS400.