daudre-vignier-charles / davi.org.zsh

ZZ, the most effective ZSH environment, for intensive shell user, easy to use and modify.

ZZ - ZSH framework

Warning: The ZZ framework is a beta version under development. Use it at your own risk.

Wiki

Index

• Introduction
• Feature presentation
• Install
• Dependency

Introduction

ZZ is a powerful ZSH framework. It is modularly designed to be debugged or modified as easily as possible. It comes with many aliases, functions, ZLE widgets or TUI tools using zsh/curses (zcurses) module. It also comes with a unit test module.

ZZ is designed to make the most of the possibilities of ZSH and to use at least external tools like grep or ls for example.

Feature presentation

ZLE widgets

ZZ comes with ZLE widgets. These are mainly code insertion widget (printf, while loop, conditional statement, etc), Git management widget, or widget enhancing ZLE by giving it IDE functionality (like automatic closing of parentheses, brackets, etc.).

Functions keys :

• F1 -> Help
• F2 -> Launcher
• F3 -> Go to davi.org.zsh git repository
• F4 -> Sync zsh files with davi.org.zsh git repository.
• F5 -> Refresh the shell (may generate some bugs)
• F6 -> Run unit test
• F10 -> Search

Git :

• alt + : + : -> git status
• alt + : + ; -> git add
• alt + : + ! -> git commit
• alt + : + l -> git pull $ORIGIN
• alt + : + * -> git push local/master master
• alt + : + t -> git tree

Code insertion :

• alt + ! + e --> printf
• alt + ! + i --> if
• alt + ! + w --> while
• alt + ! + f --> for
• alt + ! + c --> case
• alt + ! + ( --> function

Some of the widgets will open TUI interfaces like the widget for git add :

It also comes with a prompt graphically inspired by adam2 that supports Git repositories.

Prompt

It display :

• line 1 left : job(s), relative path
• line 1 right : date, tty, shlvl, user@host
• line 2 left : return of the last command, time of the last command
• line 2 right : if git repo : branch, status

Prompt while in Git repository :

ztest

ztest is a unittest module for ZSH :

Install

git clone https://github.com/DaudrVignieCharles/davi.org.zsh.git
cd davi.org.zsh
zsh ./init.zsh

The git clone is called the development version. This is used to make the changes that can then be sent to production with the zz.main.propage function.

Your old ZSH environment will be backed up and can be restored if ZZ was uninstalled.

Dependency

• rsync

davi.org.zsh's Issues

fix bug in zz.main.propage

move rsync exclude file outside script
OR
use standard fd files (/dev/stdin does not exist in Android and Solaris), maybe /dev/fd/0 or /proc/self/fd/0

check mod after init

on Windows Subsystem for Linux, rights are incorrectly configured, must check rights in init.zsh

Image set for davi.org.zsh readme and wiki

ztest

prompt without git

prompt with git

git-tui add

Bug in zc.inputbox

Bad zparseopts options, must ignore unknown options error while parsing

Security issues in zshenv

Do not use an eval, all tests must be hardcoded using an case/esac structure:

• better control on runtime - easiest debug

Security issue using eval for unnitests : Running unnitest may conduct to an arbitrary code execution.

Bug on Android and other system than Debian-like un sudo_overwrite

Do not define functions if not Debian

init.zsh use cp instead move

• add zshenv file
• move all old zsh files under the same directory

Bug in init.zsh line 6

local shell=$(ps -p $$ -ocomm=)

ps -p is not posix

image set for davi.org.zsh wiki