submizeVim

submizeVim is a tiny Python helper for running Vim Ex commands against a file in the current working directory.

Install

pip install submizeVim

Vim must be installed and available on PATH.

Usage

import submizeVim

submizeVim.vim_do("hello.txt", "%s/old/new/g")

The first argument is the file name relative to the current folder. The second argument is a string containing one or more Vim commands. Multiple commands can be separated by newlines:

submizeVim.vim_do(
    "hello.txt",
    """
    %s/foo/bar/g
    normal! gg
    """
)

By default, vim_do writes the file after the commands finish. It returns a VimResult object with returncode, stdout, stderr, file, and cwd.

CLI

submizevim hello.txt "%s/old/new/g"

Notes

This library does not execute commands through a shell. It writes the Vim commands to a temporary Vim script and runs Vim in Ex mode.