slot.nvim/doc/nvim-plugin-template.txt

63 lines
2.6 KiB
Plaintext

*nvim-plugin-template.txt* For NVIM v0.8.0 Last change: 2023 August 05
==============================================================================
Table of Contents *nvim-plugin-template-table-of-contents*
1. nvim-plugin-template |nvim-plugin-template-nvim-plugin-template|
- Usage |nvim-plugin-template-nvim-plugin-template-usage|
- Format |nvim-plugin-template-nvim-plugin-template-format|
- Test |nvim-plugin-template-nvim-plugin-template-test|
- Ci |nvim-plugin-template-nvim-plugin-template-ci|
- More |nvim-plugin-template-nvim-plugin-template-more|
- License MIT |nvim-plugin-template-nvim-plugin-template-license-mit|
==============================================================================
1. nvim-plugin-template *nvim-plugin-template-nvim-plugin-template*
neovim plugin template integration test and doc publish
USAGE *nvim-plugin-template-nvim-plugin-template-usage*
1. click `use this template` button generate a repo on your github.
2. clone your plugin repo.open terminal then cd plugin directory.
3. run `python3 rename.py your-plugin-name` this will replace all `nvim-plugin-template` to your `pluing-name`.
then it will prompt you input `y` or `n` to remove example codes in `init.lua` and
`test/plugin_spec.lua`. if you are familiar this repo just input y. if you are first look at this
template I suggest you look at them first. after these step the `rename.py` will also auto
remove.
now you have a clean plugin env. enjoy!
FORMAT *nvim-plugin-template-nvim-plugin-template-format*
format use `stylua` and provide `.stylua.toml`.
TEST *nvim-plugin-template-nvim-plugin-template-test*
use vusted for test install by using `luarocks --lua-version=5.1 install
vusted` then run `vusted test` for your test cases.
create test case in test folder file rule is `foo_spec.lua` with `_spec` more
usage please check busted usage <https://lunarmodules.github.io/busted/>
CI *nvim-plugin-template-nvim-plugin-template-ci*
Ci support auto generate doc from README and integration test and lint check by
`stylua`.
MORE *nvim-plugin-template-nvim-plugin-template-more*
Other usage you can look at my plugins
LICENSE MIT *nvim-plugin-template-nvim-plugin-template-license-mit*
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
vim:tw=78:ts=8:noet:ft=help:norl: