exercism.nvim

Exercism Meets Neovim 💪🧠

exercism.nvim in action

exercism.nvim integrates exercism into Neovim by providing a set of commands and keybindngs to help you solve exercises faster.

✨ Features

• Browse and choose exercises from the entire exercism library from within Neovim
• Quickly test and submit your solutions
• Review your existing solution for an exercise
• Track and revisit recently opened exercises
• Simple keybindings and commands to make your workflow faster

⚡ Setup

⚙️ Requirements

• utils.nvim for utility functions

• termin.nvim for terminal support

• exercism-cli installed and configured

  • Make sure to login with exercism configure

• tmux-tea (optional, recommended) for separate tmux sessions for each exercise

  • Use set -g @tea-default-command 'nvim' for a better experience

💻 Installation

-- Lazy
{
    '2kabhishek/exercism.nvim',
    cmd = { 'Exercism' },
    keys = { '<leader>exa', '<leader>exl', '<leader>exr' }, -- add your preferred keybindings
    dependencies = {
        '2kabhishek/utils.nvim', -- required, for utility functions
        '2kabhishek/termim.nvim', -- optional, better UX for running tests
    },
    -- Add your custom configs here, keep it blank for default configs (required)
    opts = {},
},

🚀 Usage

Configuration

exercism.setup({
    exercism_workspace = '~/exercism', -- Default workspace for exercism exercises
    default_language = 'ruby', -- Default language for exercise list
    add_default_keybindings = true, -- Whether to add default keybindings
    max_recents = 30, -- Maximum number of recent exercises to keep
    icons = {
        concept = '', -- Icon for concept exercises
        practice = '', -- Icon for practice exercises
    },
})

Commands

exercism.nvim provides a unified command interface with tab completion:

• Exercism languages - Lists all available languages, select one to list exercises
• Exercism list [language] - Lists exercises for the specified language, show exercises for default language if not specified
• Exercism test - Runs tests for the current exercise
• Exercism submit - Submits the current exercise
• Exercism open <language> <exercise> - Opens a specific exercise directly in the specified language
• Exercism exercise <exercise> - Opens a specific exercise directly using the default language
• Exercism recents - Shows recently opened exercises in a fuzzy searchable list

Keybindings

Here are the default keybindings:

Keybinding	Command	Description
<leader>exa	Exercism languages	List all available languages
<leader>exl	Exercism list [language]	List exercises for the specified language
<leader>ext	Exercism test	Run tests for the current exercise
<leader>exs	Exercism submit	Submit the current exercise

You can change these by setting add_default_keybindings to false and adding your own keybindings.

Help

Run :help exercism.txt for more details.

🏗️ What's Next

✅ To-Do

• Add tests

⛅ Behind The Code

🌈 Inspiration

I really like exercism but the back and forth between the browser and the terminal was a bit annoying. So I decided to integrate it with Neovim.

💡 Challenges/Learnings

• I build exercism-fetcher to fetch exercises from exercism's github repos.
• Reused knowledge from octohub.nvim, not too many challenges here.

🔍 More Info

• octohub.nvim — GitHub Repos in Neovim
• nerdy.nvim — Find nerd glyphs easily
• tdo.nvim — Fast and simple notes in Neovim
• termim.nvim — Neovim terminal improved

---

⭐ hit the star button if you found this useful ⭐

Source | Blog | Twitter | LinkedIn | More Links | Other Projects