shrub/pkg/arvo/tests/run/hints.hoon

::  Test that these hints do not crash the runtime
::    there is no need to include a test for dynamic %bout
::    since all hoon tests exersize dynamic %bout
|%
::  test that these trace hints
::  are safe to run or ignore
++  test-12-hilt-hela
  ~>  %hela
  ~
++  test-11-hint-hela
  ~>  %hela.[1 leaf+"test-11-hint-hela ~"]
  ~
++  test-10-hilt-nara
  ~>  %nara
  ~
++  test-09-hint-nara
  ~>  %nara.[1 leaf+"test-09-hint-nara ~"]
  ~
::  test that these memory-report hints
::  are safe to run or ignore
++  test-08-hilt-meme
  ~>  %meme
  ~
++  test-07-hint-meme
  ~>  %meme.[1 leaf+"test-07-hint-meme ~"]
  ~
::  test that theses bytecode-report hints
::  are safe to run or ignore
++  test-06-hilt-xray
  ~>  %xray
  ~
++  test-05-hint-xray
  ~>  %xray.[1 leaf+"test-05-hint-xray ~"]
  ~
:::: these tests show, but don't prove, if xray reads all internal bytecode
::++  test-04-hint-xray-add
::  ~>  %xray.[1 leaf+"(add 1 2)"]
::  (add 1 2)
++  test-03-hint-xray-meme
  ~>  %xray.[1 leaf+"(meme)"]
  ~>  %meme
  ~
++  test-02-hint-xray-combo
  ^-  @ud
  ~>  %xray
  ~>(%meme (mul 1 2))
::::  test that the hilt bout hint
::::  is safe to run or ignore
++  test-01-hilt-bout
  ~>  %bout
  ~
--
vere: add %nara %hela hints, add a hoon test module for hints nara: swedish for near, provides a trace from the start of the nearest virtualization to the statement wrapped by the nara hint. hela: swedish for whole, provides a trace from the start of the event to the statement wrapped by the hela hint. The eventual goal is to present these traces in a way that is most salient & useful to developers and in a way that is aesthetically pleasing as the bout hint is useful and nice looking. For this pull request the goal is to provide the actual functionality in code that we can feel safe and comfortable adding to the master branch. To this end, I've added a trivial set of tests for nara and hela in pkg/arvo/tests/run/hints.hoon - they only prove that invoking these hints will not crash the runtime, but I'm open to ideas for how I can test these hints further. 2021-12-08 22:17:29 +03:00			`:: Test that these hints do not crash the runtime`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`:: there is no need to include a test for dynamic %bout`
vere: add %nara %hela hints, add a hoon test module for hints nara: swedish for near, provides a trace from the start of the nearest virtualization to the statement wrapped by the nara hint. hela: swedish for whole, provides a trace from the start of the event to the statement wrapped by the hela hint. The eventual goal is to present these traces in a way that is most salient & useful to developers and in a way that is aesthetically pleasing as the bout hint is useful and nice looking. For this pull request the goal is to provide the actual functionality in code that we can feel safe and comfortable adding to the master branch. To this end, I've added a trivial set of tests for nara and hela in pkg/arvo/tests/run/hints.hoon - they only prove that invoking these hints will not crash the runtime, but I'm open to ideas for how I can test these hints further. 2021-12-08 22:17:29 +03:00			`:: since all hoon tests exersize dynamic %bout`
			`\|%`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`:: test that these trace hints`
changes in response to code review 2022-02-24 13:52:56 +03:00			`:: are safe to run or ignore`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-12-hilt-hela`
changes in response to code review 2022-02-24 13:52:56 +03:00			`~> %hela`
vere: add %nara %hela hints, add a hoon test module for hints nara: swedish for near, provides a trace from the start of the nearest virtualization to the statement wrapped by the nara hint. hela: swedish for whole, provides a trace from the start of the event to the statement wrapped by the hela hint. The eventual goal is to present these traces in a way that is most salient & useful to developers and in a way that is aesthetically pleasing as the bout hint is useful and nice looking. For this pull request the goal is to provide the actual functionality in code that we can feel safe and comfortable adding to the master branch. To this end, I've added a trivial set of tests for nara and hela in pkg/arvo/tests/run/hints.hoon - they only prove that invoking these hints will not crash the runtime, but I'm open to ideas for how I can test these hints further. 2021-12-08 22:17:29 +03:00			`~`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-11-hint-hela`
			`~> %hela.[1 leaf+"test-11-hint-hela ~"]`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`~`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-10-hilt-nara`
changes in response to code review 2022-02-24 13:52:56 +03:00			`~> %nara`
			`~`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-09-hint-nara`
			`~> %nara.[1 leaf+"test-09-hint-nara ~"]`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`~`
			`:: test that these memory-report hints`
			`:: are safe to run or ignore`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-08-hilt-meme`
Adds %meme and %xray hints. %meme reports mem usage at callsite. %xray prints the vere bytecode of the hoon tree wrapped by the hint. 2022-03-18 12:10:57 +03:00			`~> %meme`
			`~`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-07-hint-meme`
			`~> %meme.[1 leaf+"test-07-hint-meme ~"]`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`~`
			`:: test that theses bytecode-report hints`
changes in response to code review 2022-02-24 13:52:56 +03:00			`:: are safe to run or ignore`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-06-hilt-xray`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`~> %xray`
changes in response to code review 2022-02-24 13:52:56 +03:00			`~`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`++ test-05-hint-xray`
			`~> %xray.[1 leaf+"test-05-hint-xray ~"]`
			`~`
			`:::: these tests show, but don't prove, if xray reads all internal bytecode`
			`::++ test-04-hint-xray-add`
			`:: ~> %xray.[1 leaf+"(add 1 2)"]`
			`:: (add 1 2)`
more xray debugs via ~master-morzod 2022-06-15 22:18:24 +03:00			`++ test-03-hint-xray-meme`
			`~> %xray.[1 leaf+"(meme)"]`
			`~> %meme`
			`~`
			`++ test-02-hint-xray-combo`
			`^- @ud`
			`~> %xray`
			`~>(%meme (mul 1 2))`
more notes and debugging for xray 2022-06-15 18:06:56 +03:00			`:::: test that the hilt bout hint`
			`:::: is safe to run or ignore`
adds xray test, reorders tests, fixes sanity checks 2022-06-08 13:20:24 +03:00			`++ test-01-hilt-bout`
			`~> %bout`
Adds %meme and %xray hints. %meme reports mem usage at callsite. %xray prints the vere bytecode of the hoon tree wrapped by the hint. 2022-03-18 12:10:57 +03:00			`~`
vere: add %nara %hela hints, add a hoon test module for hints nara: swedish for near, provides a trace from the start of the nearest virtualization to the statement wrapped by the nara hint. hela: swedish for whole, provides a trace from the start of the event to the statement wrapped by the hela hint. The eventual goal is to present these traces in a way that is most salient & useful to developers and in a way that is aesthetically pleasing as the bout hint is useful and nice looking. For this pull request the goal is to provide the actual functionality in code that we can feel safe and comfortable adding to the master branch. To this end, I've added a trivial set of tests for nara and hela in pkg/arvo/tests/run/hints.hoon - they only prove that invoking these hints will not crash the runtime, but I'm open to ideas for how I can test these hints further. 2021-12-08 22:17:29 +03:00			`--`