An exercism wrapper for fish

This provides additional subcommands that I find useful to improve my experience working locally.

A typical workflow

(~)$ cd (exercism workspace)
(~/s/e/exercism)$ cd wren                    # working on the wren track
(~/s/e/e/wren)$ exercism missing             # I've _almost_ finished it
clock
(~/s/e/e/wren)$ exercism download -e clock   # `-t wren` not required
(~/s/e/e/w/clock)$ #...edit/test...
(~/s/e/e/w/clock)$ exercism submit
(~/s/e/e/w/clock)$ exercism open             # see how it looks online
(~/s/e/e/w/clock)$ exercism publish          # Done!

Now, what does Exercism know about this exercise?

(~/s/e/e/w/clock)$ exercism metadada
{
  "solution": {
    "uuid": "73af9a29bd774aca8f6ed4f0446d231b",
    "private_url": "https://exercism.org/tracks/wren/exercises/clock",
    "public_url": "https://exercism.org/tracks/wren/exercises/clock/solutions/glennj",
    "status": "published",
    "mentoring_status": "none",
    "published_iteration_head_tests_status": "passed",
    "has_notifications": false,
    "num_views": 0,
    "num_stars": 0,
    "num_comments": 0,
    "num_iterations": 3,
    "num_loc": 0,
    "is_out_of_date": false,
    "published_at": "2022-07-16T15:58:05Z",
    "completed_at": "2022-07-16T15:58:05Z",
    "updated_at": "2022-07-16T15:58:06Z",
    "last_iterated_at": "2022-07-16T15:57:55Z",
    "exercise": {
      "slug": "clock",
      "title": "Clock",
      "icon_url": "https://dg8krxphbh767.cloudfront.net/exercises/clock.svg"
    },
    "track": {
      "slug": "wren",
      "title": "Wren",
      "icon_url": "https://dg8krxphbh767.cloudfront.net/tracks/wren.svg"
    }
  }
}

Subcommands

All gloriously tab-completed.

override or augment existing exercism subcommands:

• download
  • after downloading, cd to the solution directory
  • you can omit the --track option if the function can figure it out
• submit
  • with no arguments, uploads the solution file from .exercism/config.json
• open
  • open your solution's iterations page in a browser

additional subcommands for interacting with solutions

• test
  • run test suite for this exercise
  • enhances the builtin exercism test with some custom behaviour for some tracks.
• check, format
  • run formatters and/or linters for this exercise
  • only some tracks currently supported
  • "format" is an alias for "check"
• publish
  • mark the exercise as complete, and enables comments on the public solution
• refresh
  • re-download the current solution (based on $PWD)
  • I use this mainly to refresh the .exercism/ directory
• square1
  • Destroy your current solution (!) and reset it back to its initial contents
• iterations
  • list the iterations for one or all solutions in a track
• last-test-run
  • show the data about the test run of the last iteration.
• metadata
  • a dump of the exercism backend's data about an exercise

subcommands to feed my obsession at keeping up-to-date solutions

• bulk-download
  • bulk download all your solutions for a track.
  • handy for those who store their solutions in a git repo.
• sync
  • updates the exercise
    • this is like clicking "See what's changed" in the "This exercise has been updated..." banner, then clicking the "Update exercise" button
  • requires the presence of the .exercism/ directory: you may need to exercism refresh first
• test-all
  • run test suite for all downloaded exercise in a track
  • only some tracks currently supported (the ones I've joined)
• missing
  • show track exercises that are not currently downloaded
• cleanup
  • cleanup build artifacts from track exercises
  • useful to remove huge node_modules subdirectories (unless you use pnpm)
  • not all tracks supported
• tracks
  • list all Exercism tracks, and your progress through each.
• exercises
  • list the exercises, and your progress, for a track.
• syllabus
  • create a _concepts directory for a track, linking the Concept name to the exercise's README.
• by-exercise
  • create a _by_exercise directory mapping exercises you've completed to the tracks you've completed them in.

commands related to your activity on exercism

• achievements
  • list your track trophies and badges
• notifications
  • list recent notifications
• reputation
  • recently awarded reputation

mentoring sub- and sub-subcommands

This subcommand is itself subdivided.

• mentoring queue
  • show your current mentoring queue, sorted by age
• mentoring request
  • display a summary of a mentoring request
  • it is necessary to call mentoring queue first
• mentoring inbox
  • list the discussions in your mentoring workspace
• mentoring discussion
  • display the posts of the discussion
  • it is necessary to call mentoring inbox first
  • options exist to post to the thread, and to end the discussion.
• mentoring overview
  • display your unread notifications, mentoring queue and inbox.

track development

• dev unimplemented
  • lists unimplemented, foregone or deprecated exercises.

fish setup

Add to ~/.config/fish/config.fish:

set exercism_wrapper_home /path/to/the/exercism/wrapper/root
if not contains $exercism_wrapper_home/functions $fish_function_path
    set fish_function_path $exercism_wrapper_home/functions $fish_function_path
end
if not contains $exercism_wrapper_home/completions $fish_complete_path
    set fish_complete_path $exercism_wrapper_home/completions $fish_complete_path
end
set -e exercism_wrapper_home

Tools used herein

• exercism and fish of course!
• curl
• jq
• miller
  • to print tables with pretty boxes.
• pup for parsing HTML (like jq for HTML)
• for mentoring discussions rendering of posts:
  • ruby
  • colorize gem
  • @html-to/text-cli npm package

Assuming fish and Homebrew are already installed:

brew install exercism curl jq miller node
gem install colorize
npm install --global '@html-to/text-cli'
go install 'github.com/ericchiang/pup@latest'