ci: merge workflow jobs and add makefile

.github/pre-commit

@@ -1,5 +1,3 @@
 #!/bin/bash
 set -e
-luacheck lua tests
-
-stylua --check .
+make fastlint

.github/pre-push

@@ -0,0 +1,11 @@
+#!/bin/bash
+set -e
+IFS=' '
+while read local_ref _local_sha _remote_ref _remote_sha; do
+	remote_main=$( (git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null || echo "///master") | cut -f 4 -d / | tr -d "[:space:]")
+	local_ref_short=$(echo "$local_ref" | cut -f 3 -d / | tr -d "[:space:]")
+	if [ "$local_ref_short" = "$remote_main" ]; then
+		make lint
+		make test
+	fi
+done

.github/workflows/install_nvim.sh

@@ -3,7 +3,7 @@ set -e
 PLUGINS="$HOME/.local/share/nvim/site/pack/plugins/start"
 mkdir -p "$PLUGINS"
 
-wget "https://github.com/neovim/neovim/releases/download/${NVIM_TAG}/nvim.appimage"
+wget "https://github.com/neovim/neovim/releases/download/${NVIM_TAG-stable}/nvim.appimage"
 chmod +x nvim.appimage
 ./nvim.appimage --appimage-extract >/dev/null
 rm -f nvim.appimage

.github/workflows/tests.yml

@@ -1,6 +1,12 @@
 name: Tests
 
-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
 
 jobs:
   luacheck:
@@ -17,7 +23,7 @@ jobs:
           sudo luarocks install luacheck
 
       - name: Run Luacheck
-        run: luacheck .
+        run: luacheck lua tests
 
   stylua:
     name: StyLua
@@ -29,7 +35,7 @@ jobs:
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           version: v0.15.2
-          args: --check .
+          args: --check lua tests
 
   typecheck:
     name: typecheck
@@ -62,6 +68,35 @@ jobs:
         run: |
           bash ./run_tests.sh
 
+  update_docs:
+    name: Update docs
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Install Neovim and dependencies
+        run: |
+          bash ./.github/workflows/install_nvim.sh
+
+      - name: Update docs
+        run: |
+          python -m pip install pyparsing==3.0.9
+          make doc
+      - name: Commit changes
+        if: ${{ github.ref == 'refs/heads/master' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          COMMIT_MSG: |
+            [docgen] Update docs
+            skip-checks: true
+        run: |
+          git config user.email "actions@github"
+          git config user.name "Github Actions"
+          git remote set-url origin https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
+          git add README.md doc
+          # Only commit and push if we have changes
+          git diff --quiet && git diff --staged --quiet || (git commit -m "${COMMIT_MSG}"; git push origin HEAD:${GITHUB_REF})
+
   release:
     name: release
 
@@ -71,6 +106,7 @@ jobs:
       - stylua
       - typecheck
       - run_tests
+      - update_docs
     runs-on: ubuntu-22.04
     steps:
       - uses: google-github-actions/release-please-action@v3

.gitignore

@@ -42,3 +42,5 @@ luac.out
 .direnv/
 .testenv/
 doc/tags
+scripts/nvim_doc_tools
+scripts/nvim-typecheck-action

.gitmodules

@@ -1,3 +0,0 @@
-[submodule ".github/nvim_doc_tools"]
-	path = .github/nvim_doc_tools
-	url = https://github.com/stevearc/nvim_doc_tools

Makefile

@@ -0,0 +1,27 @@
+.PHONY: all doc test lint fastlint clean
+
+all: doc lint test
+
+doc: scripts/nvim_doc_tools
+	python scripts/main.py generate
+	python scripts/main.py lint
+
+test:
+	./run_tests.sh
+
+lint: scripts/nvim-typecheck-action fastlint
+	./scripts/nvim-typecheck-action/typecheck.sh --workdir scripts/nvim-typecheck-action lua
+
+fastlint: scripts/nvim_doc_tools
+	python scripts/main.py lint
+	luacheck lua tests --formatter plain
+	stylua --check lua tests
+
+scripts/nvim_doc_tools:
+	git clone https://github.com/stevearc/nvim_doc_tools scripts/nvim_doc_tools
+
+scripts/nvim-typecheck-action:
+	git clone https://github.com/stevearc/nvim-typecheck-action scripts/nvim-typecheck-action
+
+clean:
+	rm -rf scripts/nvim_doc_tools scripts/nvim-typecheck-action

doc/oil.txt

@@ -3,11 +3,11 @@
 --------------------------------------------------------------------------------
 CONTENTS                                                            *oil-contents*
 
-  1. Options.....................................................|oil-options|
-  2. Api.............................................................|oil-api|
-  3. Columns.....................................................|oil-columns|
-  4. Actions.....................................................|oil-actions|
-  5. Highlights...............................................|oil-highlights|
+  1. Options                                                     |oil-options|
+  2. Api                                                             |oil-api|
+  3. Columns                                                     |oil-columns|
+  4. Actions                                                     |oil-actions|
+  5. Highlights                                               |oil-highlights|
 
 --------------------------------------------------------------------------------
 OPTIONS                                                              *oil-options*