vimniscient 0.2.0__py3-none-any.whl

vimniscient/lessons/w2d3-cgn.yaml

@@ -0,0 +1,196 @@
+week: 2
+day: 3
+title: The cgn trick
+intro: |
+  `gn` reads as *go to the next match* and grab it: it selects the next
+  search match. So `cgn` changes the next match, and `.` then changes the one
+  after that, and the one after that. Search once (with `/` or `*`), `cgn`
+  the first, then press `.` per match. Press `n` to skip one you want to
+  keep. `dgn` deletes matches the same way.
+keys: ['cgn', 'dgn', '*cgn', 'n.']
+tasks:
+  - goal: 'Rename every hit to next_match.'
+    ft: python
+    start: |-
+      ▮hit = search()
+      grab(hit)
+      change(hit)
+    target: |-
+      next_match = search()
+      grab(next_match)
+      change(next_match)
+    solution: '*cgnnext_match<Esc>..'
+    hint: '* sets the search; cgn changes one match; . does the rest (it wraps around).'
+    variants:
+      - goal: 'Rename every cram to spaced.'
+        start: |-
+          ▮cram = plan()
+          study(cram)
+          review(cram)
+        target: |-
+          spaced = plan()
+          study(spaced)
+          review(spaced)
+        solution: '*cgnspaced<Esc>..'
+      - goal: 'Rename every reread to retrieve.'
+        start: |-
+          ▮reread = plan()
+          study(reread)
+          log(reread)
+        target: |-
+          retrieve = plan()
+          study(retrieve)
+          log(retrieve)
+        solution: '*cgnretrieve<Esc>..'
+      - goal: 'Rename every x to match.'
+        start: |-
+          ▮x = gn()
+          c(x)
+          dot(x)
+        target: |-
+          match = gn()
+          c(match)
+          dot(match)
+        solution: '*cgnmatch<Esc>..'
+      - goal: 'Rename every massed to spaced.'
+        start: |-
+          ▮massed = schedule()
+          run(massed)
+          save(massed)
+        target: |-
+          spaced = schedule()
+          run(spaced)
+          save(spaced)
+        solution: '*cgnspaced<Esc>..'
+  - goal: 'Change the first and the last "the" to "a", keep the middle one.'
+    start: |-
+      ▮the change, the skip and the repeat
+    target: |-
+      a change, the skip and a repeat
+    solution: '*Ncgna<Esc>nn.'
+    hint: '* then N to go back to the first; cgna<Esc> changes; n n skips one; . repeats on the last.'
+    variants:
+      - goal: 'Change the first and the last "the" to "a", keep the middle one.'
+        start: |-
+          ▮the vowel, the glide and the stop
+        target: |-
+          a vowel, the glide and a stop
+      - start: |-
+          ▮the star, the next and the dot
+        target: |-
+          a star, the next and a dot
+      - start: |-
+          ▮the test, the wait and the retest
+        target: |-
+          a test, the wait and a retest
+      - start: |-
+          ▮the cue, the gap and the recall
+        target: |-
+          a cue, the gap and a recall
+  - goal: 'Replace "very weak" with "strong" on both lines.'
+    start: |-
+      ▮Spaced recall is very weak.
+      Tested recall is very weak.
+    target: |-
+      Spaced recall is strong.
+      Tested recall is strong.
+    solution: '/very weak<CR>cgnstrong<Esc>.'
+    hint: 'Search for the phrase, cgn changes the whole match, . the next one.'
+    variants:
+      - goal: 'Replace "the last" with "the next" on both lines.'
+        start: |-
+          ▮gn goes to the last match.
+          cgn changes the last match.
+        target: |-
+          gn goes to the next match.
+          cgn changes the next match.
+        solution: '/the last<CR>cgnthe next<Esc>.'
+      - goal: 'Replace "is best" with "fades" on both lines.'
+        start: |-
+          ▮Massed practice is best.
+          Cramming practice is best.
+        target: |-
+          Massed practice fades.
+          Cramming practice fades.
+        solution: '/is best<CR>cgnfades<Esc>.'
+      - goal: 'Replace "one match" with "the next match" on both lines.'
+        start: |-
+          ▮cgn changes one match.
+          The dot changes one match.
+        target: |-
+          cgn changes the next match.
+          The dot changes the next match.
+        solution: '/one match<CR>cgnthe next match<Esc>.'
+      - goal: 'Replace "high utility" with "low utility" on both lines.'
+        start: |-
+          ▮Highlighting is high utility.
+          Rereading is high utility.
+        target: |-
+          Highlighting is low utility.
+          Rereading is low utility.
+        solution: '/high utility<CR>cgnlow utility<Esc>.'
+  - goal: 'Change all four n to dot.'
+    start: |-
+      echo ▮n; echo n; echo n; echo n
+    target: |-
+      echo dot; echo dot; echo dot; echo dot
+    solution: '*cgndot<Esc>...'
+    hint: 'Same trick: * then cgn, then . for each remaining match.'
+    variants:
+      - goal: 'Change all four tmp to out.'
+        start: |-
+          cp ▮tmp; cp tmp; cp tmp; cp tmp
+        target: |-
+          cp out; cp out; cp out; cp out
+        solution: '*cgnout<Esc>...'
+      - goal: 'Change all four it to again.'
+        start: |-
+          say ▮it; say it; say it; say it
+        target: |-
+          say again; say again; say again; say again
+        solution: '*cgnagain<Esc>...'
+      - goal: 'Change all four old to new.'
+        start: |-
+          mv ▮old; mv old; mv old; mv old
+        target: |-
+          mv new; mv new; mv new; mv new
+        solution: '*cgnnew<Esc>...'
+      - goal: 'Change all four cram to space.'
+        start: |-
+          test ▮cram; test cram; test cram; test cram
+        target: |-
+          test space; test space; test space; test space
+        solution: '*cgnspace<Esc>...'
+  - goal: 'Delete every "um, ".'
+    start: |-
+      dgn ▮um, deletes um, the next match um, each time.
+    target: |-
+      dgn deletes the next match each time.
+    solution: '/um, <CR>dgn..'
+    hint: 'dgn deletes the next match. Search for "um, " with the space.'
+    variants:
+      - goal: 'Delete every "like, ".'
+        start: |-
+          It's ▮like, a word that is like, just like, filler.
+        target: |-
+          It's a word that is just filler.
+        solution: '/like, <CR>dgn..'
+        hint: 'dgn deletes the next match. Search for "like, " with the space.'
+      - goal: 'Delete every "so, ".'
+        start: |-
+          dgn ▮so, deletes so, every match so, in turn.
+        target: |-
+          dgn deletes every match in turn.
+        solution: '/so, <CR>dgn..'
+      - goal: 'Delete every "uh, ".'
+        start: |-
+          Spacing ▮uh, beats uh, cramming uh, easily.
+        target: |-
+          Spacing beats cramming easily.
+        solution: '/uh, <CR>dgn..'
+      - goal: 'Delete every "er, ".'
+        start: |-
+          Testing ▮er, beats er, rereading er, later.
+        target: |-
+          Testing beats rereading later.
+        solution: '/er, <CR>dgn..'

vimniscient/lessons/w2d4-case-numbers.yaml

@@ -0,0 +1,201 @@
+week: 2
+day: 4
+title: Case and numbers
+intro: |
+  `~` flips the case of one character: the tilde is a little wave. `gU`, `gu`
+  and `g~` are operators: U is *up* (capitals), u is down. `gUiw` uppercases
+  a word, `guu` lowercases a line. `Ctrl-a` *adds* one to the next number on
+  the line and `Ctrl-x` crosses one out; with a count, `30 Ctrl-a` adds
+  thirty. The cursor doesn't need to be on the number.
+keys: ["~", gUiw, guu, g~iw, "<C-a>", "<C-x>"]
+tasks:
+  - goal: 'Capitalise the first letter.'
+    start: |-
+      ▮tilde flips one letter
+    target: |-
+      Tilde flips one letter
+    solution: '~'
+    hint: '~ flips the case of the character under the cursor.'
+    variants:
+      - goal: 'Capitalise the name.'
+        start: |-
+          ▮ebbinghaus tested himself
+        target: |-
+          Ebbinghaus tested himself
+      - goal: 'Capitalise the name.'
+        start: |-
+          ▮miller wrote about seven
+        target: |-
+          Miller wrote about seven
+      - goal: 'Capitalise the first letter.'
+        start: |-
+          ▮the tilde is a wave
+        target: |-
+          The tilde is a wave
+      - goal: 'Capitalise the name.'
+        start: |-
+          ▮cowan argued for four
+        target: |-
+          Cowan argued for four
+  - goal: 'Uppercase "up".'
+    start: |-
+      gU raises ▮up to capitals
+    target: |-
+      gU raises UP to capitals
+    solution: 'gUiw'
+    hint: 'gU is the uppercase operator; iw is the word.'
+    variants:
+      - goal: 'Uppercase "srs".'
+        start: |-
+          an ▮srs schedules your reviews
+        target: |-
+          an SRS schedules your reviews
+      - goal: 'Uppercase "url".'
+        start: |-
+          gU sends the ▮url up to capitals
+        target: |-
+          gU sends the URL up to capitals
+      - goal: 'Uppercase "pspi".'
+        start: |-
+          Dunlosky's 2013 review is in ▮pspi
+        target: |-
+          Dunlosky's 2013 review is in PSPI
+      - goal: 'Uppercase "tla".'
+        start: |-
+          a ▮tla is a three-letter acronym
+        target: |-
+          a TLA is a three-letter acronym
+  - goal: 'Make the whole line lowercase.'
+    start: |-
+      ▮GU LOWERS THE WHOLE LINE
+    target: |-
+      gu lowers the whole line
+    solution: 'guu'
+    hint: 'guu lowercases the line (gu + u, like dd).'
+    variants:
+      - goal: 'Make the whole line lowercase.'
+        start: |-
+          ▮DON'T SHOUT THE GLOSSES
+        target: |-
+          don't shout the glosses
+      - start: |-
+          ▮LOWERCASE IS QUIETER
+        target: |-
+          lowercase is quieter
+      - start: |-
+          ▮SPACING BEATS CRAMMING
+        target: |-
+          spacing beats cramming
+      - start: |-
+          ▮NO NEED TO SHOUT A REVIEW
+        target: |-
+          no need to shout a review
+  - goal: 'Make the sentence true: Ctrl-a adds 1.'
+    start: |-
+      ▮Ctrl-a adds 0 to the number
+    target: |-
+      Ctrl-a adds 1 to the number
+    solution: '<C-a>'
+    hint: 'Ctrl-a adds one to the next number on the line.'
+    variants:
+      - goal: 'Fitts and Posner named three stages of skill: fix the number.'
+        start: |-
+          ▮Fitts and Posner named 2 stages of skill
+        target: |-
+          Fitts and Posner named 3 stages of skill
+      - goal: 'Ebbinghaus was born in 1850: fix the year.'
+        start: |-
+          ▮Ebbinghaus was born in 1849
+        target: |-
+          Ebbinghaus was born in 1850
+      - goal: 'Miller''s magical number is seven: fix it.'
+        start: |-
+          ▮Miller's number is 6, plus or minus two
+        target: |-
+          Miller's number is 7, plus or minus two
+      - goal: 'Roediger and Karpicke published in 2006: fix the year.'
+        start: |-
+          ▮Roediger and Karpicke published in 2005
+        target: |-
+          Roediger and Karpicke published in 2006
+  - goal: 'Ebbinghaus published in 1885: add 30 to the year.'
+    start: |-
+      ▮Ebbinghaus published in 1855
+    target: |-
+      Ebbinghaus published in 1885
+    solution: '30<C-a>'
+    hint: 'With a count, Ctrl-a adds that many.'
+    variants:
+      - goal: 'Miller''s magical number came out in 1956: add 30 to the year.'
+        start: |-
+          ▮Miller's magical number came out in 1926
+        target: |-
+          Miller's magical number came out in 1956
+      - goal: 'Cowan''s magical number four came out in 2001: add 30 to the year.'
+        start: |-
+          ▮Cowan's magical number four came out in 1971
+        target: |-
+          Cowan's magical number four came out in 2001
+      - goal: 'Fitts and Posner''s Human Performance came out in 1967: add 30 to the year.'
+        start: |-
+          ▮Fitts and Posner's Human Performance came out in 1937
+        target: |-
+          Fitts and Posner's Human Performance came out in 1967
+      - goal: 'Dunlosky and colleagues rated learning techniques in 2013: add 30 to the year.'
+        start: |-
+          ▮Dunlosky and colleagues rated learning techniques in 1983
+        target: |-
+          Dunlosky and colleagues rated learning techniques in 2013
+  - goal: 'Make the sentence true: 3 take away 1 leaves 2.'
+    start: |-
+      ▮Ctrl-x leaves 3 when you take 1 from 3
+    target: |-
+      Ctrl-x leaves 2 when you take 1 from 3
+    solution: '<C-x>'
+    hint: 'Ctrl-x takes one away from the next number.'
+    variants:
+      - goal: 'Cowan''s estimate is about four chunks: fix the number.'
+        start: |-
+          ▮Cowan's working memory holds about 5 chunks
+        target: |-
+          Cowan's working memory holds about 4 chunks
+      - goal: 'Fitts and Posner named three stages: fix the number.'
+        start: |-
+          ▮Fitts and Posner named 4 stages of skill
+        target: |-
+          Fitts and Posner named 3 stages of skill
+      - goal: 'Miller''s magical number is seven: fix it.'
+        start: |-
+          ▮Miller's magical number is 8, plus or minus two
+        target: |-
+          Miller's magical number is 7, plus or minus two
+      - goal: 'Ebbinghaus published in 1885: fix the year.'
+        start: |-
+          ▮Ebbinghaus published Über das Gedächtnis in 1886
+        target: |-
+          Ebbinghaus published Über das Gedächtnis in 1885
+  - goal: 'Flip the case of the first word.'
+    start: |-
+      ▮tILDE flips the case
+    target: |-
+      Tilde flips the case
+    solution: 'g~iw'
+    hint: 'g~ flips case over a motion or text object.'
+    variants:
+      - goal: 'Flip the case of the first word.'
+        start: |-
+          ▮eBBINGHAUS and the forgetting curve
+        target: |-
+          Ebbinghaus and the forgetting curve
+      - start: |-
+          ▮mILLER and the magical number
+        target: |-
+          Miller and the magical number
+      - start: |-
+          ▮cOWAN and the number four
+        target: |-
+          Cowan and the number four
+      - start: |-
+          ▮wAVE: the tilde flips
+        target: |-
+          Wave: the tilde flips

vimniscient/lessons/w2d5-insert.yaml

@@ -0,0 +1,229 @@
+week: 2
+day: 5
+title: Getting into insert mode well
+intro: |
+  Choosing the right way into insert mode saves moving first: `o`/`O` *open*
+  a line below/above, `ea` goes to the *end* of a word and *appends*, `R`
+  keeps *replacing* (you type over text), `r` replaces one character without
+  entering insert mode, and a count repeats what you type (`5i=<Esc>`). While
+  typing, `Ctrl-w` wipes the last word and `Ctrl-u` undoes the whole line, so
+  you rarely need Backspace.
+keys: [o, O, ea, R, r, 5i, "<C-w>", "<C-u>"]
+tasks:
+  - goal: 'Add the line "below" between them.'
+    start: |-
+      ▮o opens a line
+      O opens one above
+    target: |-
+      o opens a line
+      below
+      O opens one above
+    solution: 'obelow<Esc>'
+    hint: 'o opens a new line below and starts insert mode.'
+    variants:
+      - goal: 'Add the missing stage between them.'
+        start: |-
+          ▮encoding
+          retrieval
+        target: |-
+          encoding
+          storage
+          retrieval
+        solution: 'ostorage<Esc>'
+      - goal: 'Add the missing stage of skill between them.'
+        start: |-
+          ▮cognitive
+          autonomous
+        target: |-
+          cognitive
+          associative
+          autonomous
+        solution: 'oassociative<Esc>'
+      - goal: 'Add "day 3" between them.'
+        start: |-
+          ▮day 1
+          day 7
+        target: |-
+          day 1
+          day 3
+          day 7
+        solution: 'oday 3<Esc>'
+      - goal: 'Add "2001 Cowan" between them.'
+        start: |-
+          ▮1956 Miller
+          2006 Roediger
+        target: |-
+          1956 Miller
+          2001 Cowan
+          2006 Roediger
+        solution: 'o2001 Cowan<Esc>'
+  - goal: 'Add the line "O opened this one above" above.'
+    start: |-
+      ▮this line
+    target: |-
+      O opened this one above
+      this line
+    solution: 'OO opened this one above<Esc>'
+    hint: 'Capital O opens a line above.'
+    variants:
+      - goal: 'Add an Introduction line above.'
+        start: |-
+          ▮Method
+        target: |-
+          Introduction
+          Method
+        solution: 'OIntroduction<Esc>'
+      - goal: 'Add a Method line above.'
+        start: |-
+          ▮Results
+        target: |-
+          Method
+          Results
+        solution: 'OMethod<Esc>'
+      - goal: 'Add the line "O opens above" above.'
+        start: |-
+          ▮below
+        target: |-
+          O opens above
+          below
+        solution: 'OO opens above<Esc>'
+      - goal: 'Add "encoding" above.'
+        start: |-
+          ▮storage
+          retrieval
+        target: |-
+          encoding
+          storage
+          retrieval
+        solution: 'Oencoding<Esc>'
+  - goal: 'Fix "append" to "appends".'
+    start: |-
+      e goes to the end, and a ▮append after it.
+    target: |-
+      e goes to the end, and a appends after it.
+    solution: 'eas<Esc>'
+    hint: 'e goes to the end of the word, a appends after it.'
+    variants:
+      - goal: 'Make "allophone" plural.'
+        start: |-
+          Three ▮allophone appear.
+        target: |-
+          Three allophones appear.
+      - goal: 'Make "syllable" plural.'
+        start: |-
+          Ebbinghaus learned nonsense ▮syllable by heart.
+        target: |-
+          Ebbinghaus learned nonsense syllables by heart.
+      - goal: 'Fix "append" to "appends".'
+        start: |-
+          e moves, then a ▮append after the word.
+        target: |-
+          e moves, then a appends after the word.
+      - goal: 'Make "topic" plural.'
+        start: |-
+          Interleaving mixes ▮topic within a session.
+        target: |-
+          Interleaving mixes topics within a session.
+  - goal: 'Underline the title with five = signs.'
+    start: |-
+      Recall
+      ▮
+    target: |-
+      Recall
+      =====
+    solution: '5i=<Esc>'
+    hint: 'A count before i repeats the inserted text.'
+    variants:
+      - goal: 'Underline the title with five = signs.'
+        start: |-
+          Tones
+          ▮
+        target: |-
+          Tones
+          =====
+      - goal: 'Underline the title with five - signs.'
+        start: |-
+          Sleep
+          ▮
+        target: |-
+          Sleep
+          -----
+        solution: '5i-<Esc>'
+      - start: |-
+          Chunks
+          ▮
+        target: |-
+          Chunks
+          =====
+      - goal: 'Underline the title with five ~ signs.'
+        start: |-
+          Tests
+          ▮
+        target: |-
+          Tests
+          ~~~~~
+        solution: '5i~<Esc>'
+  - goal: 'Type the date 2026-10-26 over the zeros.'
+    start: |-
+      Next review: ▮0000-00-00
+    target: |-
+      Next review: 2026-10-26
+    solution: 'R2026-10-26<Esc>'
+    hint: 'R keeps replacing: it types over the existing characters.'
+    variants:
+      - goal: 'Overwrite the date with 2026-10-24.'
+        start: |-
+          Recorded: ▮2024-03-15
+        target: |-
+          Recorded: 2026-10-24
+        solution: 'R2026-10-24<Esc>'
+      - goal: 'Type 1885 over the zeros.'
+        start: |-
+          Ebbinghaus, ▮0000
+        target: |-
+          Ebbinghaus, 1885
+        solution: 'R1885<Esc>'
+      - goal: 'Type the date 2026-11-02 over the placeholder.'
+        start: |-
+          Next review: ▮YYYY-MM-DD
+        target: |-
+          Next review: 2026-11-02
+        solution: 'R2026-11-02<Esc>'
+      - goal: 'Overwrite the year with 1956.'
+        start: |-
+          Miller, ▮1965
+        target: |-
+          Miller, 1956
+        solution: 'R1956<Esc>'
+  - goal: 'Fix "keplaces" to "replaces".'
+    start: |-
+      r ▮keplaces one letter
+    target: |-
+      r replaces one letter
+    solution: 'rr'
+    hint: 'r replaces one character and stays in normal mode. Here that''s r, then r.'
+    variants:
+      - goal: 'Fix the operator: minus should be plus.'
+        start: |-
+          x = a ▮- b
+        target: |-
+          x = a + b
+        solution: 'r+'
+      - goal: 'Fitts and Posner named three stages: fix the number.'
+        start: |-
+          Fitts and Posner named ▮2 stages
+        target: |-
+          Fitts and Posner named 3 stages
+        solution: 'r3'
+      - goal: 'Fix "mot" to "dot".'
+        start: |-
+          The ▮mot command repeats
+        target: |-
+          The dot command repeats
+        solution: 'rd'
+      - goal: 'Cowan said about four: fix the number.'
+        start: |-
+          Cowan: about ▮5 chunks
+        target: |-
+          Cowan: about 4 chunks
+        solution: 'r4'