1 ## oils_failures_allowed: 0
2
3 #### Open proc (any number of args)
4 shopt --set parse_proc
5
6 proc f {
7 var x = 42
8 return $x
9 }
10 # this gets called with 3 args then?
11 f a b c
12 echo status=$?
13 ## STDOUT:
14 status=42
15 ## END
16
17 #### Closed proc with no args, passed too many
18 shopt --set parse_proc
19
20 proc f() {
21 return 42
22 }
23 f
24 echo status=$?
25
26 f a b # status 2
27
28 ## status: 3
29 ## STDOUT:
30 status=42
31 ## END
32
33 #### Open proc has ARGV
34 shopt -s ysh:all
35 proc foo {
36 echo ARGV @ARGV
37 # do we care about this? I think we want to syntactically remove it from YSH
38 # but it can still be used for legacy
39 echo dollar-at "$@"
40 }
41 builtin set -- a b c
42 foo x y z
43 ## STDOUT:
44 ARGV x y z
45 dollar-at a b c
46 ## END
47
48 #### Closed proc has empty "$@" or ARGV
49 shopt -s ysh:all
50
51 proc foo(d, e, f) {
52 write params $d $e $f
53 argv.py dollar-at "$@"
54 argv.py ARGV @ARGV
55 }
56 builtin set -- a b c
57 foo x y z
58 ## STDOUT:
59 params
60 x
61 y
62 z
63 ['dollar-at', 'a', 'b', 'c']
64 ['ARGV']
65 ## END
66
67 #### Proc with default args
68 shopt --set parse_proc
69
70 proc f(x='foo') {
71 echo x=$x
72 }
73 f
74 ## STDOUT:
75 x=foo
76 ## END
77
78 #### Proc with word params
79 shopt --set parse_proc
80
81 # doesn't require ysh:all
82 proc f(x, y, z) {
83 echo $x $y $z
84 var ret = 42
85 return $ret
86 }
87 # this gets called with 3 args then?
88 f a b c
89 echo status=$?
90 ## STDOUT:
91 a b c
92 status=42
93 ## END
94
95 #### Proc with ... "rest" word params
96
97 # TODO: opts goes with this
98 # var opt = grep_opts.parse(ARGV)
99 #
100 # func(**opt) # Assumes keyword args match?
101 # parse :grep_opts :opt @ARGV
102
103 shopt -s ysh:all
104
105 proc f(...names) {
106 write names: @names
107 }
108 # this gets called with 3 args then?
109 f a b c
110 echo status=$?
111 ## STDOUT:
112 names:
113 a
114 b
115 c
116 status=0
117 ## END
118
119 #### word rest params 2
120 shopt --set ysh:all
121
122 proc f(first, ...rest) { # @ means "the rest of the arguments"
123 write --sep ' ' -- $first
124 write --sep ' ' -- @rest # @ means "splice this array"
125 }
126 f a b c
127 ## STDOUT:
128 a
129 b c
130 ## END
131
132 #### proc with typed args
133 shopt --set ysh:upgrade
134
135 # TODO: duplicate param names aren't allowed
136 proc p (a; mylist, mydict; opt Int = 42) {
137 pp test_ (a)
138 pp test_ (mylist)
139 pp test_ (mydict)
140 #pp test_ (opt)
141 }
142
143 p WORD ([1,2,3], {name: 'bob'})
144
145 echo ---
146
147 p x (:| a b |, {bob: 42}, a = 5)
148
149 ## STDOUT:
150 (Str) "WORD"
151 (List) [1,2,3]
152 (Dict) {"name":"bob"}
153 ---
154 (Str) "x"
155 (List) ["a","b"]
156 (Dict) {"bob":42}
157 ## END
158
159 #### Proc name-with-hyphen
160 shopt --set parse_proc parse_at
161
162 proc name-with-hyphen {
163 echo @ARGV
164 }
165 name-with-hyphen x y z
166 ## STDOUT:
167 x y z
168 ## END
169
170 #### Proc with block arg
171 shopt --set ysh:upgrade
172
173 # TODO: Test more of this
174 proc f(x, y ; ; ; block) {
175 echo f word $x $y
176
177 if (block) {
178 call io->eval(block)
179 }
180 }
181 f a b { echo FFF }
182
183 # With varargs and block
184 shopt --set parse_proc
185
186 proc g(x, y, ...rest ; ; ; block) {
187 echo g word $x $y
188 echo g rest @rest
189
190 if (block) {
191 call io->eval(block)
192 }
193 }
194 g a b c d {
195 echo GGG
196 }
197
198 ## STDOUT:
199 f word a b
200 FFF
201 g word a b
202 g rest c d
203 GGG
204 ## END
205
206 #### proc returning wrong type
207 shopt --set parse_proc
208
209 # this should print an error message
210 proc f {
211 var a = %(one two)
212 return $a
213 }
214 f
215 ## status: 3
216 ## STDOUT:
217 ## END
218
219 #### proc returning invalid string
220 shopt --set parse_proc
221
222 # this should print an error message
223 proc f {
224 var s = 'not an integer status'
225 return $s
226 }
227 f
228 ## status: 1
229 ## STDOUT:
230 ## END
231
232 #### 'return' doesn't accept expressions
233 proc p {
234 return 1 + 2
235 }
236 p
237 ## status: 2
238 ## STDOUT:
239 ## END
240
241 #### procs are in same namespace as variables
242 shopt --set parse_proc
243
244 proc myproc {
245 echo hi
246 }
247
248 echo "myproc is a $[type(myproc)]"
249
250 ## STDOUT:
251 myproc is a Proc
252 ## END
253
254 #### Nested proc is allowed
255 shopt --set parse_proc
256
257 proc f {
258 proc g {
259 echo 'G'
260 }
261 g
262 }
263 f
264 g # g is defined in the local scope of f
265 ## status: 127
266 ## STDOUT:
267 G
268 ## END
269
270 #### Procs defined inside compound statements (with redefine_proc)
271
272 shopt --set ysh:upgrade
273 shopt --set redefine_proc_func
274
275 for x in 1 2 {
276 proc p {
277 echo 'loop'
278 }
279 }
280 p
281
282 {
283 proc p {
284 echo 'brace'
285 }
286 }
287 p
288
289 ## STDOUT:
290 loop
291 brace
292 ## END
293
294 #### Block can be passed literally, or as expression in third arg group
295 shopt --set ysh:upgrade
296
297 proc p ( ; ; ; block) {
298 call io->eval(block)
299 }
300
301 p { echo literal }
302
303 var block = ^(echo expression)
304 p (; ; block)
305
306 ## STDOUT:
307 literal
308 expression
309 ## END
310
311 #### Pass through all 4 kinds of args
312
313 shopt --set ysh:upgrade
314
315 proc p2 (...words; ...typed; ...named; block) {
316 pp test_ (words)
317 pp test_ (typed)
318 pp test_ (named)
319 #pp test_ (block)
320 # To avoid <Block 0x??> - could change pp test_
321 echo $[type(block)]
322 }
323
324 proc p1 (...words; ...typed; ...named; block) {
325 p2 @words (...typed; ...named; block)
326 }
327
328 p2 a b ('c', 'd', n=99) {
329 echo literal
330 }
331 echo
332
333 # Same thing
334 var block = ^(echo expression)
335
336 # Note: you need the second explicit ;
337
338 p2 a b ('c', 'd'; n=99; block)
339 echo
340
341 # what happens when you do this?
342 p2 a b ('c', 'd'; n=99; block) {
343 echo duplicate
344 }
345
346 ## status: 1
347 ## STDOUT:
348 (List) ["a","b"]
349 (List) ["c","d"]
350 (Dict) {"n":99}
351 Block
352
353 (List) ["a","b"]
354 (List) ["c","d"]
355 (Dict) {"n":99}
356 Command
357
358 ## END
359
360 #### Global and local ARGV, like "$@"
361 shopt -s parse_at
362 argv.py "$@"
363 argv.py @ARGV
364 #argv.py "${ARGV[@]}" # not useful, but it works!
365
366 set -- 'a b' c
367 argv.py "$@"
368 argv.py @ARGV # separate from the argv stack
369
370 f() {
371 argv.py "$@"
372 argv.py @ARGV # separate from the argv stack
373 }
374 f 1 '2 3'
375 ## STDOUT:
376 []
377 []
378 ['a b', 'c']
379 []
380 ['1', '2 3']
381 []
382 ## END
383
384
385 #### Mutating global ARGV
386
387 $SH -c '
388 shopt -s ysh:upgrade
389
390 argv.py global @ARGV
391
392 # should not be ignored
393 call ARGV->append("GG")
394
395 argv.py global @ARGV
396 '
397 ## STDOUT:
398 ['global']
399 ['global', 'GG']
400 ## END
401
402 #### Mutating local ARGV
403
404 $SH -c '
405 shopt -s ysh:upgrade
406
407 argv.py global @ARGV
408
409 proc p {
410 argv.py @ARGV
411 call ARGV->append("LL")
412 argv.py @ARGV
413 }
414
415 p local @ARGV
416
417 argv.py global @ARGV
418
419 ' dummy0 'a b' c
420
421 ## STDOUT:
422 ['global', 'a b', 'c']
423 ['local', 'a b', 'c']
424 ['local', 'a b', 'c', 'LL']
425 ['global', 'a b', 'c']
426 ## END
427
428
429 #### typed proc allows all kinds of args
430 shopt -s ysh:upgrade
431
432 typed proc p (w; t; n; block) {
433 pp test_ (w)
434 pp test_ (t)
435 pp test_ (n)
436 echo $[type(block)]
437 }
438
439 p word (42, n=99) {
440 echo block
441 }
442
443
444 ## STDOUT:
445 (Str) "word"
446 (Int) 42
447 (Int) 99
448 Block
449 ## END
450
451 #### can unset procs without -f
452 shopt -s ysh:upgrade
453
454 proc foo() {
455 echo bar
456 }
457
458 try { foo }
459 echo status=$[_error.code]
460
461 pp test_ (foo)
462 unset foo
463 #pp test_ (foo)
464
465 try { foo }
466 echo status=$[_error.code]
467
468 ## STDOUT:
469 bar
470 status=0
471 <Proc>
472 status=127
473 ## END
474
475 #### procs shadow sh-funcs
476 shopt -s ysh:upgrade redefine_proc_func
477
478 f() {
479 echo sh-func
480 }
481
482 proc f {
483 echo proc
484 }
485
486 f
487 ## STDOUT:
488 proc
489 ## END
490
491 #### first word skips non-proc variables
492 shopt -s ysh:upgrade
493
494 grep() {
495 echo 'sh-func grep'
496 }
497
498 var grep = 'variable grep'
499
500 grep
501
502 # We first find `var grep`, but it's a Str not a Proc, so we skip it and then
503 # find `function grep`.
504
505 ## STDOUT:
506 sh-func grep
507 ## END
508
509 #### proc resolution changes with the local scope
510 shopt -s ysh:upgrade
511
512 proc foo {
513 echo foo
514 }
515
516 proc bar {
517 echo bar
518 }
519
520 proc inner {
521 var foo = bar
522 foo # Will now reference `proc bar`
523 }
524
525 foo
526 inner
527 foo # Back to the global scope, foo still references `proc foo`
528
529 # Without this behavior, features like `eval(b, vars={ flag: __flag })`, needed
530 # by parseArgs, will not work. `eval` with `vars` adds a new frame to the end of
531 # `mem.var_stack` with a local `flag` set to `proc __flag`. However, then we
532 # cannot resolve `flag` by only checking `mem.var_stack[0]` like we could with
533 # a proc declared normally, so we must search `mem.var_stack` from last to first.
534
535 ## STDOUT:
536 foo
537 bar
538 foo
539 ## END
540
541
542 #### procs are defined in local scope
543 shopt -s ysh:upgrade
544
545 proc gen-proc {
546 eval 'proc localproc { echo hi }'
547 pp frame_vars_
548
549 }
550
551 gen-proc
552
553 # can't suppress 'grep' failure
554 if false {
555 try {
556 pp frame_vars_ | grep localproc
557 }
558 pp test_ (_pipeline_status)
559 #pp test_ (PIPESTATUS)
560 }
561
562 ## STDOUT:
563 [frame_vars_] ARGV localproc
564 ## END
565
566
567 #### declare -f -F only prints shell functions
568 shopt --set parse_proc
569
570 myfunc() {
571 echo hi
572 }
573
574 proc myproc {
575 echo hi
576 }
577
578 declare -F
579 echo ---
580
581 declare -F myproc
582 echo status=$?
583
584 declare -f myproc
585 echo status=$?
586
587 ## status: 0
588 ## STDOUT:
589 declare -f myfunc
590 ---
591 status=1
592 status=1
593 ## END
594
595 #### compgen -A function shows user-defined invokables - shell funcs, Proc, Obj
596 shopt --set ysh:upgrade
597
598 my-shell-func() {
599 echo hi
600 }
601
602 proc myproc {
603 echo hi
604 }
605
606 compgen -A function
607
608 echo ---
609
610 proc define-inner {
611 eval 'proc inner { echo inner }'
612 #eval 'proc myproc { echo inner }' # shadowed name
613 compgen -A function
614 }
615 define-inner
616
617 echo ---
618
619 proc myinvoke (w; self) {
620 pp test_ ([w, self])
621 }
622
623 var methods = Object(null, {__invoke__: myinvoke})
624 var myobj = Object(methods, {})
625
626 compgen -A function
627
628 ## STDOUT:
629 my-shell-func
630 myproc
631 ---
632 define-inner
633 inner
634 my-shell-func
635 myproc
636 ---
637 define-inner
638 my-shell-func
639 myinvoke
640 myobj
641 myproc
642 ## END
643
644 #### type / type -a builtin on invokables - shell func, proc, invokable
645 shopt --set ysh:upgrade
646
647 my-shell-func() {
648 echo hi
649 }
650
651 proc myproc {
652 echo hi
653 }
654
655 proc boundProc(; self) {
656 echo hi
657 }
658
659 var methods = Object(null, {__invoke__: boundProc})
660 var invokable = Object(methods, {})
661
662 type -t my-shell-func
663 type -t myproc
664 type -t invokable
665 try {
666 type -t methods # not invokable!
667 }
668 echo $[_error.code]
669
670 echo ---
671
672 type my-shell-func
673 type myproc
674 type invokable
675 try {
676 type methods # not invokable!
677 }
678 echo $[_error.code]
679
680 echo ---
681
682 type -a my-shell-func
683 type -a myproc
684 type -a invokable
685
686 echo ---
687
688 if false { # can't redefine right now
689 invokable() {
690 echo sh-func
691 }
692 type -a invokable
693 }
694
695 ## STDOUT:
696 function
697 proc
698 invokable
699 1
700 ---
701 my-shell-func is a shell function
702 myproc is a YSH proc
703 invokable is a YSH invokable
704 1
705 ---
706 my-shell-func is a shell function
707 myproc is a YSH proc
708 invokable is a YSH invokable
709 ---
710 ## END
711
712 #### invokable Obj that doesn't declare self
713 shopt --set ysh:upgrade
714
715 proc boundProc(no_self; ) {
716 echo 'bad'
717 }
718
719 var methods = Object(null, {__invoke__: boundProc})
720 var invokable = Object(methods, {x: 3, y: 5})
721
722 invokable no_self
723
724 ## status: 3
725 ## STDOUT:
726 ## END
727
728 #### invokable Obj is called with self
729 shopt --set ysh:upgrade
730
731 proc boundProc(; self) {
732 echo "sum = $[self.x + self.y]"
733 }
734
735 var methods = Object(null, {__invoke__: boundProc})
736 var invokable = Object(methods, {x: 3, y: 5})
737
738 invokable
739
740 ## STDOUT:
741 sum = 8
742 ## END
743
744
745 #### invokable Obj with more typed args
746 shopt --set ysh:upgrade
747
748 proc myInvoke (word1, word2; self, int1, int2) {
749 echo "sum = $[self.x + self.y]"
750 pp test_ (self)
751 pp test_ ([word1, word2, int1, int2])
752 }
753
754 # call it directly with 'self'
755 myInvoke a b ({x: 0, y: 1}, 42, 43)
756 echo
757
758 var methods = Object(null, {__invoke__: myInvoke})
759
760 var callable = Object(methods, {x: 2, y: 3})
761
762 # call it through the obj
763 callable a b (44, 45)
764
765 ## STDOUT:
766 sum = 1
767 (Dict) {"x":0,"y":1}
768 (List) ["a","b",42,43]
769
770 sum = 5
771 (Obj) ("x":2,"y":3) --> ("__invoke__":<Proc>)
772 (List) ["a","b",44,45]
773 ## END
774
775 #### two different objects can share the same __invoke__
776 shopt --set ysh:upgrade
777
778 proc boundProc(; self, more) {
779 echo "sum = $[self.x + self.y + more]"
780 }
781
782 var methods = Object(null, {__invoke__: boundProc})
783
784 var i1 = Object(methods, {x: 3, y: 5})
785 var i2 = Object(methods, {x: 10, y: 42})
786
787 i1 (1)
788 i2 (1)
789
790 ## STDOUT:
791 sum = 9
792 sum = 53
793 ## END
794
795
796 #### Stateful proc with counter
797 shopt --set ysh:upgrade
798 proc invokeCounter(; self, inc) {
799 setvar self.i += inc
800 echo "counter = $[self.i]"
801 }
802
803 var methods = Object(null, {__invoke__: invokeCounter})
804 var counter = Object(methods, {i: 0})
805
806 counter (1)
807 counter (2)
808 counter (3)
809
810 ## STDOUT:
811 counter = 1
812 counter = 3
813 counter = 6
814 ## END