https://github.com/edo1z/nvim-plugin-sandbox
複数バージョンのNeovimでプラグインをテストするためのDocker環境です
https://github.com/edo1z/nvim-plugin-sandbox
docker nvim nvim-plugin
Last synced: 4 months ago
JSON representation
複数バージョンのNeovimでプラグインをテストするためのDocker環境です
- Host: GitHub
- URL: https://github.com/edo1z/nvim-plugin-sandbox
- Owner: edo1z
- License: mit
- Created: 2025-07-01T06:10:56.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-01T13:38:27.000Z (4 months ago)
- Last Synced: 2025-07-01T14:28:25.707Z (4 months ago)
- Topics: docker, nvim, nvim-plugin
- Language: Lua
- Homepage:
- Size: 16.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Neovim Plugin Sandbox
複数バージョンのNeovimでプラグインをテストするためのDocker環境です。
## 特徴
- Neovim 0.10, 0.11, Nightly版を簡単に切り替え可能
- ローカルのプラグインを即座にテスト
- 最小限の設定と完全な設定を用意
- 他の環境に影響を与えない隔離環境
## 必要なもの
- Docker
- Docker Compose
## 使い方
### 基本的な使い方
```bash
# プラグインディレクトリをpluginsフォルダにコピーまたはシンボリックリンク
ln -s ~/my-awesome-plugin ./plugins/
# Neovim 0.11でテスト
docker-compose run --rm nvim-0.11
# Neovim 0.10でテスト
docker-compose run --rm nvim-0.10
# Nightly版でテスト
docker-compose run --rm nvim-nightly
```
### 環境変数を使った方法
```bash
# 特定のプラグインをテスト
PLUGIN_PATH=~/my-plugin docker-compose run --rm nvim-0.11
# フル設定でテスト
NVIM_CONFIG=full PLUGIN_PATH=~/my-plugin docker-compose run --rm nvim-0.11
```
### スクリプトを使った方法
```bash
# プラグインパス、バージョン、設定を指定
./scripts/test-plugin.sh ~/my-plugin 0.11 full
# デフォルト（現在のディレクトリ、0.11、minimal設定）
./scripts/test-plugin.sh
```
### .bashrcにエイリアスを設定
開発中のプラグインディレクトリで簡単にテストできるようにエイリアスを設定：
```bash
# ~/.bashrcに追加（パスは環境に合わせて調整）
alias nvim-plugin-test='~/nvim-plugin-sandbox/scripts/test-plugin.sh'
# 使い方：プラグインディレクトリで実行
cd ~/my-awesome-plugin
nvim-plugin-test # 現在のディレクトリ、0.11、minimal設定
nvim-plugin-test . 0.10 # 現在のディレクトリ、0.10、minimal設定
nvim-plugin-test . 0.11 full # 現在のディレクトリ、0.11、full設定
nvim-plugin-test . nightly full # 現在のディレクトリ、nightly、full設定
```
## 設定ファイル
### minimal.lua
- 基本的な設定のみ
- プラグインのテストに必要最小限
### full.lua
- より実用的な設定
- 一般的なキーマッピング付き
- `p`で読み込まれたプラグイン一覧を表示
### プラグイン固有の設定ファイル
多くの最近のNeovimプラグインは`setup()`関数の呼び出しが必要です。プラグインが自動的に動作しない場合は、専用の設定ファイルを作成してください：
```lua
-- configs/my-plugin.lua の例
---@diagnostic disable-next-line: undefined-global
local vim = vim
-- 基本設定
vim.g.mapleader = " "
vim.opt.number = true
-- プラグインのセットアップ
local ok, my_plugin = pcall(require, 'my-plugin')
if ok then
my_plugin.setup({
-- プラグイン固有のオプション
option1 = true,
option2 = "value"
})
print("My-plugin loaded successfully!")
else
print("Failed to load my-plugin:", my_plugin)
end
```
使用方法：
```bash
# プラグインディレクトリで実行
nvim-plugin-test . 0.11 my-plugin
```
## カスタマイズ
### 環境変数
- `PLUGIN_PATH`: テストするプラグインのパス（デフォルト: `./plugins`）
- `NVIM_CONFIG`: 使用する設定ファイル（デフォルト: `minimal`）
## ライセンス
MIT