CW script

The CW script is a script containing one or more exercises, which can be fed into the CW software. A very simple CW script containing just a couple of tests is shown below:

  require "cw"

# test_script.rb

cw do
  comment "5 common words at 12 wpm (test letters)"
  shuffle
  wpm        12
  word_count 5
  test_letters
end

cw do
  comment "5 common words at 12 wpm (test words)"
  shuffle
  wpm        12
  word_count 5
end

test_script.rb

The script can be run by typing the following into a terminal:


cw script

Alternatively, the script can be run via the Ruby executable:

Note: Using cw gives you a few extra features (including less typing!)


ruby script.rb

The output of the test_script (following the test) is likely to look something like this:

word by word

Note: Here we can see that the words in red were entered incorrectly, whilst the words in blue were entered correctly.

Another example output is:

letter by letter

Note: Here we are marking-by-letter and the letters in red are letters that were entered incorrectly.

Maintenance of CW scripts

The test script (or set of test scripts) is supposed to reflect the progress of the student at the current time. For instance, if we are struggling on certain letters or numbers, extra tests can easily be included in the script to provide additional exposure to the weakness. Also, the speed of tests can increase as the proficiency of the student increases to the point where no mistakes are (usually) made.

Regular Practice

By utilizing test scripts in this way, the user can easily run the daily exercise routine, or the morning exercise routine, and benefit from an uninterrupted period of mindful study, without lots of pauses and distractions of button clicking and program operation. We can get in the zone and stay in the zone!


cw daily_script

<test interactions>

done!

A tutorial on the commands that can be used to prepare CW scripts begins here.