chore(main): release 2.0.0 (#36)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -16,7 +16,7 @@ body:
           required: true
         - label: I have searched the existing issues of persistence.nvim
           required: true
-        - label: I have searched the exsiting issues of plugins related to this issue
+        - label: I have searched the existing issues of plugins related to this issue
           required: true
   - type: input
     attributes:
@@ -59,6 +59,7 @@ body:
       value: |
         -- DO NOT change the paths and don't remove the colorscheme
         local root = vim.fn.fnamemodify("./.repro", ":p")
+
         -- set stdpaths to use .repro
         for _, name in ipairs({ "config", "data", "state", "cache" }) do
           vim.env[("XDG_%s_HOME"):format(name:upper())] = root .. "/" .. name

.github/workflows/ci.yml

@@ -15,8 +15,12 @@ jobs:
       - name: Install Neovim
         shell: bash
         run: |
-            wget -q https://github.com/neovim/neovim/releases/download/nightly/nvim-linux64.deb -O /tmp/nvim.deb
+          mkdir -p /tmp/nvim
-            sudo dpkg -i /tmp/nvim.deb
+          wget -q https://github.com/neovim/neovim/releases/download/nightly/nvim.appimage -O /tmp/nvim/nvim.appimage
+          cd /tmp/nvim
+          chmod a+x ./nvim.appimage
+          ./nvim.appimage --appimage-extract
+          echo "/tmp/nvim/squashfs-root/usr/bin/" >> $GITHUB_PATH
       - name: Run Tests
         run: |
           nvim --version
@@ -55,7 +59,7 @@ jobs:
         with:
           release-type: simple
           package-name: persistence.nvim
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - name: tag stable versions
         if: ${{ steps.release.outputs.release_created }}
         run: |

CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [2.0.0](https://github.com/folke/persistence.nvim/compare/v1.2.1...v2.0.0) (2023-10-15)
+
+
+### ⚠ BREAKING CHANGES
+
+* **start:** session name is now based on the cwd when the session starts and not when the session ends. Fixes #1688
+
+### Bug Fixes
+
+* **start:** session name is now based on the cwd when the session starts and not when the session ends. Fixes [#1688](https://github.com/folke/persistence.nvim/issues/1688) ([0361df7](https://github.com/folke/persistence.nvim/commit/0361df7775f5b4ed51a6d7fe159438573b7f07a6))
+
+## [1.2.1](https://github.com/folke/persistence.nvim/compare/v1.2.0...v1.2.1) (2023-10-13)
+
+
+### Bug Fixes
+
+* dont save the session when only `gitcommit` buffers are present. Fixes [#14](https://github.com/folke/persistence.nvim/issues/14) ([8f7cbcc](https://github.com/folke/persistence.nvim/commit/8f7cbccfb506fe6cb35db9ad966137c363b049c5))
+
+## [1.2.0](https://github.com/folke/persistence.nvim/compare/v1.1.0...v1.2.0) (2023-10-13)
+
+
+### Features
+
+* don't save the session when no files are open (save_empty = false) ([e9afeaf](https://github.com/folke/persistence.nvim/commit/e9afeaf3a7bb645ca73980cd13048c48c292500c))
+
+## [1.1.0](https://github.com/folke/persistence.nvim/compare/v1.0.1...v1.1.0) (2023-02-28)
+
+
+### Features
+
+* **persistence:** `pre_save` option to call before saving ([#22](https://github.com/folke/persistence.nvim/issues/22)) ([f4bb0c5](https://github.com/folke/persistence.nvim/commit/f4bb0c5641a0e6c9ac3675ddd794ca78099d8510))
+
 ## [1.0.1](https://github.com/folke/persistence.nvim/compare/v1.0.0...v1.0.1) (2023-01-06)
 
 

README.md

@@ -4,7 +4,7 @@
 
 ## ✨ Features
 
-- automatically saves the active session under `.config/nvim/sessions` on exit
+- automatically saves the active session under `~/.local/state/nvim/sessions` on exit
 - simple API to restore the current or last session
 
 ## ⚡️ Requirements
@@ -15,33 +15,17 @@
 
 Install the plugin with your preferred package manager:
 
-### [packer](https://github.com/wbthomason/packer.nvim)
+### [folke](https://github.com/folke/lazy.nvim)
 
 ```lua
 -- Lua
-use({
+{
   "folke/persistence.nvim",
   event = "BufReadPre", -- this will only start session saving when an actual file was opened
-  module = "persistence",
+  opts = {
-  config = function()
+    -- add any custom options here
-    require("persistence").setup()
-  end,
-})
-```
-
-### [vim-plug](https://github.com/junegunn/vim-plug)
-
-```vim
-" Vim Script
-Plug 'folke/persistence.nvim'
-
-lua << EOF
-  require("persistence").setup {
-    -- your configuration comes here
-    -- or leave it empty to use the default settings
-    -- refer to the configuration section below
   }
-EOF
+}
 ```
 
 ## ⚙️ Configuration
@@ -52,6 +36,8 @@ Persistence comes with the following defaults:
 {
   dir = vim.fn.expand(vim.fn.stdpath("state") .. "/sessions/"), -- directory where session files are saved
   options = { "buffers", "curdir", "tabpages", "winsize" }, -- sessionoptions used for saving
+  pre_save = nil, -- a function to call before saving the session
+  save_empty = false, -- don't save if there are no open file buffers
 }
 ```
 

doc/persistence.nvim.txt

@@ -1,69 +1,52 @@
-*persistence.nvim.txt*     For Neovim >= 0.8.0    Last change: 2023 January 06
+*persistence.nvim.txt*     For Neovim >= 0.8.0    Last change: 2023 October 15
 
 ==============================================================================
 Table of Contents                         *persistence.nvim-table-of-contents*
 
 1. Persistence                                  |persistence.nvim-persistence|
-  - Features                                       |persistence.nvim-features|
+  - Features                           |persistence.nvim-persistence-features|
-  - Requirements                               |persistence.nvim-requirements|
+  - Requirements                   |persistence.nvim-persistence-requirements|
-  - Installation                               |persistence.nvim-installation|
+  - Installation                   |persistence.nvim-persistence-installation|
-  - Configuration                             |persistence.nvim-configuration|
+  - Configuration                 |persistence.nvim-persistence-configuration|
-  - Usage                                             |persistence.nvim-usage|
+  - Usage                                 |persistence.nvim-persistence-usage|
 
 ==============================================================================
 1. Persistence                                  *persistence.nvim-persistence*
 
 **Persistence** is a simple lua plugin for automated session management.
 
-FEATURES                                           *persistence.nvim-features*
 
+FEATURES                               *persistence.nvim-persistence-features*
 
-- automatically saves the active session under `.config/nvim/sessions` on exit
+- automatically saves the active session under `~/.local/state/nvim/sessions` on exit
 - simple API to restore the current or last session
 
 
-REQUIREMENTS                                   *persistence.nvim-requirements*
+REQUIREMENTS                       *persistence.nvim-persistence-requirements*
-
 
 - Neovim >= 0.7.2
 
 
-INSTALLATION                                   *persistence.nvim-installation*
+INSTALLATION                       *persistence.nvim-persistence-installation*
 
 Install the plugin with your preferred package manager:
 
-PACKER <HTTPS://GITHUB.COM/WBTHOMASON/PACKER.NVIM> ~
+
+FOLKE ~
 
 >lua
     -- Lua
-    use({
+    {
       "folke/persistence.nvim",
       event = "BufReadPre", -- this will only start session saving when an actual file was opened
-      module = "persistence",
+      opts = {
-      config = function()
+        -- add any custom options here
-        require("persistence").setup()
+      }
-      end,
-    })
-<
-
-
-VIM-PLUG <HTTPS://GITHUB.COM/JUNEGUNN/VIM-PLUG> ~
-
->vim
-    " Vim Script
-    Plug 'folke/persistence.nvim'
-    
-    lua << EOF
-      require("persistence").setup {
-        -- your configuration comes here
-        -- or leave it empty to use the default settings
-        -- refer to the configuration section below
     }
-    EOF
 <
 
 
-CONFIGURATION                                 *persistence.nvim-configuration*
+CONFIGURATION                     *persistence.nvim-persistence-configuration*
 
 Persistence comes with the following defaults:
 
@@ -71,11 +54,13 @@ Persistence comes with the following defaults:
     {
       dir = vim.fn.expand(vim.fn.stdpath("state") .. "/sessions/"), -- directory where session files are saved
       options = { "buffers", "curdir", "tabpages", "winsize" }, -- sessionoptions used for saving
+      pre_save = nil, -- a function to call before saving the session
+      save_empty = false, -- don't save if there are no open file buffers
     }
 <
 
 
-USAGE                                                 *persistence.nvim-usage*
+USAGE                                     *persistence.nvim-persistence-usage*
 
 **Persistence** works well with plugins like `startify` or `dashboard`. It will
 never restore a session automatically, but you can of course write an autocmd
@@ -92,7 +77,6 @@ that does exactly that if you want.
     vim.api.nvim_set_keymap("n", "<leader>qd", [[<cmd>lua require("persistence").stop()<cr>]], {})
 <
 
-
 Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
 
 vim:tw=78:ts=8:noet:ft=help:norl:

doc/persistence.txt

@@ -1,98 +0,0 @@
-*persistence.txt*         For NVIM v0.8.0         Last change: 2023 January 04
-
-==============================================================================
-Table of Contents                              *persistence-table-of-contents*
-
-1. 💾 Persistence                             |persistence-💾-persistence|
-  - ✨ Features                                    |persistence-✨-features|
-  - ⚡️ Requirements                      |persistence-⚡️-requirements|
-  - 📦 Installation                          |persistence-📦-installation|
-  - ⚙️ Configuration                    |persistence-⚙️-configuration|
-  - 🚀 Usage                                        |persistence-🚀-usage|
-
-==============================================================================
-1. 💾 Persistence                             *persistence-💾-persistence*
-
-**Persistence** is a simple lua plugin for automated session management.
-
-✨ FEATURES                                        *persistence-✨-features*
-
-
-- automatically saves the active session under `.config/nvim/sessions` on exit
-- simple API to restore the current or last session
-
-
-⚡️ REQUIREMENTS                          *persistence-⚡️-requirements*
-
-
-- Neovim >= 0.5.0
-
-
-📦 INSTALLATION                              *persistence-📦-installation*
-
-Install the plugin with your preferred package manager:
-
-PACKER <HTTPS://GITHUB.COM/WBTHOMASON/PACKER.NVIM> ~
-
->
-    -- Lua
-    use({
-      "folke/persistence.nvim",
-      event = "BufReadPre", -- this will only start session saving when an actual file was opened
-      module = "persistence",
-      config = function()
-        require("persistence").setup()
-      end,
-    })
-<
-
-
-VIM-PLUG <HTTPS://GITHUB.COM/JUNEGUNN/VIM-PLUG> ~
-
->
-    " Vim Script
-    Plug 'folke/persistence.nvim'
-    
-    lua << EOF
-      require("persistence").setup {
-        -- your configuration comes here
-        -- or leave it empty to use the default settings
-        -- refer to the configuration section below
-      }
-    EOF
-<
-
-
-⚙️ CONFIGURATION                        *persistence-⚙️-configuration*
-
-Persistence comes with the following defaults:
-
->
-    {
-      dir = vim.fn.expand(vim.fn.stdpath("state") .. "/sessions/"), -- directory where session files are saved
-      options = { "buffers", "curdir", "tabpages", "winsize" }, -- sessionoptions used for saving
-    }
-<
-
-
-🚀 USAGE                                            *persistence-🚀-usage*
-
-**Persistence** works well with plugins like `startify` or `dashboard`. It will
-never restore a session automatically, but you can of course write an autocmd
-that does exactly that if you want.
-
->
-    -- restore the session for the current directory
-    vim.api.nvim_set_keymap("n", "<leader>qs", [[<cmd>lua require("persistence").load()<cr>]], {})
-    
-    -- restore the last session
-    vim.api.nvim_set_keymap("n", "<leader>ql", [[<cmd>lua require("persistence").load({ last = true })<cr>]], {})
-    
-    -- stop Persistence => session won't be saved on exit
-    vim.api.nvim_set_keymap("n", "<leader>qd", [[<cmd>lua require("persistence").stop()<cr>]], {})
-<
-
-
-Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
-
-vim:tw=78:ts=8:noet:ft=help:norl:

lua/persistence/config.lua

@@ -1,9 +1,11 @@
 local M = {}
 
 ---@class PersistenceOptions
+---@field pre_save? fun()
 local defaults = {
   dir = vim.fn.expand(vim.fn.stdpath("state") .. "/sessions/"), -- directory where session files are saved
-  options = { "buffers", "curdir", "tabpages", "winsize" }, -- sessionoptions used for saving
+  options = { "buffers", "curdir", "tabpages", "winsize", "skiprtp" }, -- sessionoptions used for saving
+  save_empty = false, -- don't save if there are no open file buffers
 }
 
 ---@type PersistenceOptions

lua/persistence/init.lua

@@ -1,6 +1,8 @@
 local Config = require("persistence.config")
 
 local M = {}
+---@type string?
+M.current = nil
 
 local e = vim.fn.fnameescape
 
@@ -27,22 +29,43 @@ function M.setup(opts)
 end
 
 function M.start()
+  M.current = M.get_current()
   vim.api.nvim_create_autocmd("VimLeavePre", {
     group = vim.api.nvim_create_augroup("persistence", { clear = true }),
     callback = function()
+      if Config.options.pre_save then
+        Config.options.pre_save()
+      end
+
+      if not Config.options.save_empty then
+        local bufs = vim.tbl_filter(function(b)
+          if vim.bo[b].buftype ~= "" then
+            return false
+          end
+          if vim.bo[b].filetype == "gitcommit" then
+            return false
+          end
+          return vim.api.nvim_buf_get_name(b) ~= ""
+        end, vim.api.nvim_list_bufs())
+        if #bufs == 0 then
+          return
+        end
+      end
+
       M.save()
     end,
   })
 end
 
 function M.stop()
+  M.current = nil
   pcall(vim.api.nvim_del_augroup_by_name, "persistence")
 end
 
 function M.save()
   local tmp = vim.o.sessionoptions
   vim.o.sessionoptions = table.concat(Config.options.options, ",")
-  vim.cmd("mks! " .. e(M.get_current()))
+  vim.cmd("mks! " .. e(M.current or M.get_current()))
   vim.o.sessionoptions = tmp
 end