Local History

based on https://github.com/zabel-xyz/local-history which seems abandoned

• check CHANGELOG

Local History

A visual source code plugin for maintaining local history of files.

Every time you modify a file, a copy of the old contents is kept in the local history. At any time, you can compare a file with any older version from the history. It can help you out when you change or delete a file by accident. The history can also help you out when your workspace has a catastrophic problem. Each file revision is stored in a separate file inside the .history folder of your workspace directory (you can also configure another location, see local-history.path). e.g., .history/foo/bar/myFile_20151212205930.ts

You can easily navigate between history files with the local-history tree in the explorer pane.

When you click on a file, a comparaison with the current version is displayed.
You can also access other commands via a context menu.

You have different views to filter:

• all
• current file (default)
• specific file (you can enter a search pattern)

The files displayed depend on setting localHistory.maxDisplay to see more, use search-plus icon.

Settings

"localHistory.daysLimit":  30  // A day number to purge local history. (0: no purge)
"localHistory.maxDisplay": 10  // A max files to display with local history commands
"localHistory.saveDelay":   0  // A delay in seconds to save file in local history. {0: no delay}
"localHistory.dateLocale":     // The locale to use when displaying date (e.g.: "fr-CH" or "en-GB" or ...)

"localHistory.path":     // Specify another location for .history folder (null: use workspaceFolder)
This settings must be an absolute path.

  You can start your path with:
      - ${workspaceFolder}: current workspace folder
          e.g. ${workspaceFolder}/.vscode to save in each workspace folder .vscode/.history
      - ${workspaceFolder: index}: specific workspace index
          e.g. workspace folders A, B, C. But save always in A/.history => ${workspaceFolder: 0}

  Your can also use specific variable in path:
      - %variable%: an environnement variable (e.g. %AppData%)
      - ~: the home directory (linux)

"localHistory.absolute": // Save absolute or relative path in localHistory.path
   true:  (absolute) // <localHistory.path>/.history/<absolutePath>
   false: (relative) // (default) <localHistory.path>/.history/<workspaceFolder.basename>/<relativePath>

"localHistory.enabled":
   0: Never     // Possibility to disabled the extension for some project
   1: Always    // (default) Save also single file with no workspaceFolder ("localHistory.path" must be defined)
   2: Workspace // Save only files within workspaceFolder

"localHistory.exclude": // Files or folders to not save
// (default) ['**/.history/**', '**/.vscode**', '**/node_modules/**', '**/typings/**', '**/out/**']

"localHistory.treeLocation": // Specify a location for tree view
   explorer (default): // Show tree in Explorer item
   localHistory:       // Show tree in a special active bar item

Commands

local-history.showAll // Show all history available to select (limited with maxDisplay settings)
local-history.showCurrent // Show current version (if history version is active)
local-history.compareToCurrent // compare current version with another version in history
local-history.compareToActive // compare active file with another version in history
local-history.compareToPrevious // compare a version in history with its previous version

Note

When .history folder is stored in workspace, you can add a "files.exclude". This hides .history folder and avoids some issues. (e.g. csproj extension)
Thanks to @pabloarista (issue #13)