vimwasm-try-plugin

vimwasm-try-plugin

vimwasm-try-plugin is a command line tool to open try a Vim plugin hosted on GitHub using vim.wasm. You can instantly try Vim plugin without installing it on browser. About vim.wasm, please visit the repository.

Installation

Download and unzip an executable from release page for your platform and put it in some $PATH directory.

Or build from source using Go toolchain.

go get -u github.com/rhysd/vimwasm-try-plugin

Usage

vimwasm-try-plugin [flags] 'owner/name'

For example,

vimwasm-try-plugin 'rhysd/clever-f.vim'

This command opens:

https://rhysd.github.io/vim.wasm/?dir=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f&dir=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f%2Fmigemo&file=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f.vim%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Frhysd%2Fclever-f.vim%2Fmaster%2Fautoload%2Fclever_f.vim&file=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f%2Fcompat.vim%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Frhysd%2Fclever-f.vim%2Fmaster%2Fautoload%2Fclever_f%2Fcompat.vim&file=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f%2Fmigemo%2Fcp932.vim%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Frhysd%2Fclever-f.vim%2Fmaster%2Fautoload%2Fclever_f%2Fmigemo%2Fcp932.vim&file=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f%2Fmigemo%2Feucjp.vim%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Frhysd%2Fclever-f.vim%2Fmaster%2Fautoload%2Fclever_f%2Fmigemo%2Feucjp.vim&file=%2Fusr%2Flocal%2Fshare%2Fvim%2Fautoload%2Fclever_f%2Fmigemo%2Futf8.vim%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Frhysd%2Fclever-f.vim%2Fmaster%2Fautoload%2Fclever_f%2Fmigemo%2Futf8.vim&file=%2Fusr%2Flocal%2Fshare%2Fvim%2Fplugin%2Fclever-f.vim%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Frhysd%2Fclever-f.vim%2Fmaster%2Fplugin%2Fclever-f.vim

You can try clever-f.vim in your browser without installing it.

All files are fetched on memory. So they are cleaned up automatically when a browser tab is closed. vim.wasm is a Vim fork for Web

Limitation

vim.wasm is a Vim compiled to WebAssembly. So entire Vim is running on your browser and has some limitation.

• Shell commands are not available. So if the Vim plugin uses system() or other stuffs which try to execute shell commands, it does not work.
• The Vim is built with 'normal' feature set configuration. Some functionalities enabled in 'big' or 'huge' feature set are not available. For example, sign, conceal or profile.
• vim.wasm fetches all plugin files before starting Vim. Fetching many files or a large file may slows Vim start up.

TODO

• Add -local string option to specify local directory instead of using GitHub API
• Consider symlinks

License

This repository is distributed under the MIT license.