Related: How Interactive Shells Work - https://github.com/akinomyoga/ble.sh

This is issue #653, in particular the list of tasks in this comment.

Bugs Found by Running Ble.sh

• [X] Zulip 49. BUG \return 0 doesn't work (Refs: #2228)
• [ ] #1069 53. BUG: a[1 + 1]=2, etc. fails

Features Needed to Run Ble.sh

• [ ] #647 NYI: declare -p, etc.
  • [x] declare, declare -p (#671)
  • [ ] declare -f, type function ★
  • [ ] trap, trap -p
• [ ] #653 16. NYI: read -t timeout / builtin sleep #684
• [ ] #680 trap -l
• [ ] #653 19. NYI: let (#622)
• [ ] #653 28. NYI: declare -iluc and flags iluc in ${var@a}
• [ ] #653 32. NYI: LC_CTYPE (or Binary manipulations) (#527 and #529)
• [ ] #1069 39. NYI: EPOCHREALTIME, SECONDS, and other dynamic variables
• [ ] #1069 40. BUG: a=(declare v); "${a[@]}" fails
• [ ] #1069 59. Assigning Str to BashArray/BashAssoc removes BashArray/BashAssoc

Others

• [ ] #654 DOC: redefinable builtins?
• [ ] #653 24. COMPAT/ERRMSG: Oil tries to execute the first path in PATH for an empty command (#690)
• [ ] #653 35. COMPAT: Oil session closed by exec non-existent-command

Completed

• [x] #2197, #2299, #2306 bind -x to get user input.
• [x] #1069 52. BUG: \builtin local v=1 fails (Refs: Zulip)
• [x] #1069 56. BUG: declare -p unset does not print any error message
• [x] #1069 57. BUG: variable v is invisible after IFS= eval 'local v=...'
• [x] Zulip 45. NYI sparse array (List of related pull requests)
• [x] #1069 54. BUG: shopt -u expand_aliases fails and stops execution (fix 24146f4b)
• [x] #1069 55. BUG: 1.1 GB memory use with eval_unsafe_arith (#2263, Fix: #2268)
• [x] #653 22. COMPAT: builtin declare doesn't work (#654)
• [x] #1069 58. BUG: mapfile -t stops reading the input with an empty line (#2287, fix 6431d76)
• [x] #652 CONSISTENCY: Check declare -A d=([k]=v) (became irrelevant since InitializerList is implemented in #2279)

Bugs

• [x] #653 29. BUG: Cannot parse ${arr[@]::}
  • Fix #725 (Rejected)
  • #nix > if (( )); then token can't be used in prefix position - Oils - Zulip
  • #oil-discuss > ${arr[@]::} in bash - is it documented? - Oils - Zulip
  • b8ec0f72, 2b679882, 986a39e0
• [x] #1069 38. Regression ${var@a} with compat_array (Fix 9559c8ad)
• [x] #1069 41. BUG: [ -c /dev/null ](--c-/dev/null-.html) fails in C++ version (fix #1618)
• [x] #1069 42. BUG: osh -c 'read -d :' fails in the C++ osh (not in the Python osh) (Fix #1629)
• [x] #1069 43. BUG: shopt -u expand_aliases fails in scripts sourced with arguments (Fix #1628)
• [x] Zulip 46. BUG(c++) ((1<<32)) fails (Fix c84c4054)
• [x] Zulip 47. BUG(c++) printf %d $((1<<31)) fails (Fix c26d3202)
• [x] Zulip 48. BUG osh -c 'echo $((arr[0]))' fails (Fix 435acd16)
• [x] Zulip 50. BUG local in eval doesn't work (Fix c3eee5fd)
• [x] Zulip 51. BUG option -i in declare -i v=1+2+3+4 is silently ignored

NYI

• [x] read -t 0 (Or select/poll-like feature)
  • what C function do we want to wrap? select() on the terminal?
• [x] #146 NYI: mapfile / readarray ★ (tests #666)
• [x] #701 44. NYI nocasematch (Fix #1718)

Bugs Found by Running Ble.sh

• [x] #653 30. BUG: ${arr[@]::0} prints all the elements
• [x] #653 33. BUG: Redirection of 2 is persistent after : 2>/dev/null >&30 (Fix #723)
• [x] #653 37. BUG: {fd}>&- does not close the fd (Fix #723)
• [x] #724 BUG: Digits in $((base#num)) are reversed
• [x] #726 BUG: ${#BASH_SOURCE} and ${BASH_SOURCE:offset:length} count array elements.
• [x] #729 BUG: Result of IFS= read -n 1 char disappears
• [x] #731 BUG: declare -a arr removes existing arrays

Features Needed to Run Ble.sh

• [x] #653 26. NYI: Dynamic unset (#706 Tests #718) ★
• [x] #653 31. COMPAT: shopt for $ARRAY? ★ (Fix #728)
• [x] #653 34. NYI: $BASHPID (or Current subshell PID)
• [x] #727 NYI 1?a=1:1 (Ref #712)
• [x] #728 NYI: shopt for $ARRAY? ★ (Additional fix #733)
• [x] #730 NYI: printf %d \' for NUL

• [x] #620 NYI: return 2>/dev/null
• [x] #637 CONSISTENCY: type return
• [x] #537 NYI: test -k (#649)
• [x] #640 NYI: ((${prefix}a=${prefix}b)) (cf #644 #670) ★★
• [x] #651 NYI: unset -v 'a[0]' ★★
• [x] #653 1. CONSISTENCY: default [ -o emacs ](--o-emacs-.html) in interactive sessions ★
  • [ ] #659 set +o emacs
• [x] #653 2. NYI: $FUNCNAME / $BASH_LINENO (#656)
• [x] #653 3. BUG: ${*:offset} (#658)
• [x] #653 4. BUG: ${!prefix@} self-rewrites (#657)
• [x] #653 5. CONSISTENCY: declare -A dict=() (#661) ★★
• [x] #653 6. NYI: exec 5<> a.pipe (cf #223 #667 #672)
• [x] #653 7. NYI: exec {fd}> a.txt (cf #223 #672)
• [x] #653 8. NYI: exec 5>&- (cf #223 #667 #672)
• [x] #653 9. NYI: read -d '' (#356 #665) ★
• [x] #653 10. ERRMSG: builtin read
• [x] #653 11. NYI: trap -- ... / eval -- ... (#662) ★★
• [x] #653 12. NYI: printf '%()T' (cf #650 #668)
• [x] #653 13. BUG: ${var=x}
• [x] #653 14. DOC: Bash/Oil diff
  • [x] #648 recursive arithmetic evaluation ☆ (tests #686)
  • [x] #664 ERRMSG: error inside $((a))
• [x] #653 15. NEWFEAT: OIL_VERSION / OIL_VERSINFO? #683
• [x] #653 17. BUG: ${arr[0]=x} (#660) ★
• [x] #653 18. BUG? An empty variable in recursive arithmetic evaluation produces fatal error (e379b61)
• [x] #653 20. BUG ${!prefix@} fails when prefix matches with an array name (daab1d6)
• [x] #653 21. BUG ${x/^} crashes (dbf9e00)
• [x] #653 23. BUG: declare -F funcname doesn't accept non-alphanumeric characters in funcname ★★ (ec62c8a)
• [x] #653 25. NYI: Attributes ${var@a} (#689)
• [x] #653 27. NYI: flags rx in ${var@a} (14548dc)
• [x] #653 36. BUG: read fails on empty lines (#705) ★★

Try out ble.sh with OSH

Currently, ble.sh does not fully work on Oil. Only a part can be run for testing purpose.

Clone ble.osh

$ git clone --recursive http://github.com/akinomyoga/ble.sh -b osh ble.osh
$ cd ble.osh
$ make

Update ble.osh

The branch osh is occasionally force-pushed so need to be forcibly updated by git reset --hard or git checkout -B. Please be careful not to have your own commits in osh branch or edits in the working tree before running the following commands. They will be lost. You need to save your changes in another branch.

$ cd ble.osh
$ git fetch origin
$ git checkout -B osh origin/osh
$ make

Try unit tests for ble/util

$ cd ble.osh
$ osh --rcfile oshrc.test-util

Try read -e by ble.sh

The builtin read -e (read with line editor) is emulated by ble.sh. Minimal initialization for testing read -e is available with oshrc.read in osh branch of ble.sh.

$ cd ble.osh
$ osh --rcfile oshrc.read
$ read -e

Specify prompt (-p) and initial contents (-i):

$ read -e -p '[\u@\h \W]\$ ' -i 'echo hello'

Related: Running Package Builds with OSH