Quick
index
main
eev
eepitch
maths
angg
blogme
dednat6
littlelangs
PURO
(C2,C3,C4,
 λ,ES,
 GA,MD,
 Caepro,
 textos,
 Chapa 1)

emacs
lua
(la)tex
maxima
git
agda
forth
squeak
icon
tcl
tikz
fvwm
debian
irc
contact

Using test blocks in eev

This was my original video on test blocks, recorded in jan/2021.
My presentation at the EmacsConf2021 in nov/2021 was about test blocks too,
and it was far better than this! Please see it instead! =)



This video is about how I've been documenting complex functions and data structures by putting chunks of executable code in comments (in "test blocks", see below), and how I execute these chunks line by line with eepitch. The "line by line" trick lets me follow what each line does without having to add any comments.

Links to the video (4m45s long):
http://angg.twu.net/eev-videos/2021-test-blocks.mp4
http://www.youtube.com/watch?v=fpsF_M55W4o

Links to documentation:
(find-eepitch-intro "3. Test blocks")
(find-eepitch-intro "3.2. Test blocks as documentation")

More videos about eev:
http://angg.twu.net/emacsconf2020.html#more-videos
(find-videos-intro "1. Some videos")

Discussion on Reddit:
https://www.reddit.com/r/emacs/comments/l3tg2x/using_test_blocks_in_eev/

Index:
(code-eevvideo "testbls" "2021-test-blocks" "fpsF_M55W4o")
(code-video "testblsvideo" "$S/http/angg.twu.net/eev-videos/2021-test-blocks.mp4")
(find-eevtestblsvideo "0:00")
(find-eevtestblsvideo "0:16" "I just added this section here to the documentation:")
(find-eevtestblsvideo "0:30" "3.2. Test blocks as documentation")
(find-eevtestblsvideo "0:36"   "most people think that test blocks are very alien")
(find-eevtestblsvideo "1:04"   "The demo is this thing here:")
(find-eevtestblsvideo "1:25"   "this part downloads dednat6-minimal.zip with eepitch")
(find-eevtestblsvideo "1:50"   "we run this code-c-d so that the hyperlinks below will work")
(find-eevtestblsvideo "1:56"   "we run this setenv to set up the init file that Lua uses")
(find-eevtestblsvideo "2:06"   "the header of 'edrxlib.lua' explains how that init file works")
(find-eevtestblsvideo "2:19" "let's go to this test block: in 'treetex.lua'...")
(find-eevtestblsvideo "2:23" "test block 1: 'Treenode-tests'")
(find-eevtestblsvideo "2:24" "this thing here is colored as a comment - it is a comment")
(find-eevtestblsvideo "2:33"   "if I run f8 here I start a new Lua interpreter")
(find-eevtestblsvideo "2:44"   "the line 'require \"treetex.lua\"' loads the current file")
(find-eevtestblsvideo "2:57"   "I use it as documentation for certain data structures")
(find-eevtestblsvideo "3:31" "test block 2: 'dedtorect-tests'")
(find-eevtestblsvideo "3:44"   "run this start a new Lua interpreter")
(find-eevtestblsvideo "4:14" "again: these things are treated by Lua as comment but...")
(find-eevtestblsvideo "4:24" "to learn more about test blocks go to the eepitch tutorial")
(find-eevtestblsvideo "4:36" "to the section: '3. Test blocks'")