Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/FichteFoll/FileHistory

Sublime Text plugin that keeps track of files which have been recently closed, as well as files that have been recently accessed.
https://github.com/FichteFoll/FileHistory

hacktoberfest sublime-text sublime-text-3 sublime-text-package

Last synced: about 2 months ago
JSON representation

Sublime Text plugin that keeps track of files which have been recently closed, as well as files that have been recently accessed.

Awesome Lists containing this project

README

        

# SublimeText - File History #

**Sublime Text 2 and 3** plugin
to provide access to the history of recently used files -
project-wise or globally.

The most recently closed file
can be instantly re-opened
or the entire file history
can be shown and filtered in a quick panel
(including file preview
and the ability to open multiple files).

![Preview Image][preview-img]

## Features ##

* Reopen the most recently closed file
or open a quick panel of recently used files
to choose from
* Display a preview of the file
while browsing the quick panel
(only Sublime Text 3)
* Open multiple history entries
from the quick panel
with the Right key
* Delete history entries from the quick panel
with Ctrl + Del
* Optionally remove any non-existent files
while looking through the file history
(when previewed or opened)
or on start-up
* Creates backups
in case you lose your history
* Highly configurable through [FileHistory.sublime-settings][] file,
like excluding files with regex patterns

## Installation ##

1. Install [Package Control][pck-ctrl].
2. Once installed,
bring up the Command Palette
(`Command-Shift-P` on OS X, `Ctrl-Shift-P` on Linux/Windows).
3. Select `Package Control: Install Package`
and then select `File History` when the list appears.

Package Control will automagically keep the plugin up to date.

## Usage ##

To use the plugin,
open the Command Palette
and search for `File History:`.

When you opened a panel
you can use the Right key
to open the file and keep the panel open,
or Ctrl/Cmd + Del
to remove the selected file from the history.

For default keymap definitions,
see [Default (Windows).sublime-keymap][keymap] ([OSX][keymap-osx]).

For the available and default settings,
see [FileHistory.sublime-settings][].

### Project Settings ###

You can **extend**
the `path_exclude_patterns` and `path_reinclude_patterns` lists
in your project settings.

For this,
add a `"file_history"` dictionary
to your project's settings
and then one or both of the settings to that.
Example:

```json
{
"folders": [
{
"path": "."
}
],
"settings": {
"file_history": {
"path_exclude_patterns": ["/bin/"],
"path_reinclude_patterns": ["\\.compiled$"]
}
}
}
```

### Commands ###

**`open_recently_closed_file`** (Window)

Opens a popup with recently closed files
or reopens the lastly closed view
if `action == "open_latest_closed"`.

> *Parameters*
>
> - **action** (str) -
> *Default*: `"show_history"`,
> *Allowed values*: `"show_history"`, `"open_latest_closed"`
>
> - **current_project_only** (bool) -
> *Default*: `True`

**`cleanup_file_history`** (Window)

Checks the current project
or the whole history
for non-existent files
and removes them from the history.

> *Parameters*
>
> - **current_project_only** (bool) -
> *Default*: `True`

**`reset_file_history`** (Window)

Removes all history data.

[github]: https://github.com/FichteFoll/sublimetext-filehistory "Github.com: FichteFoll/FileHistory"
[pck-ctrl]: https://packagecontrol.io/installation "Installation - Package Control"

[FileHistory.sublime-settings]: FileHistory.sublime-settings

[keymap]: Default%20%28Windows%29.sublime-keymap "Default.sublime-keymap"
[keymap-osx]: Default%20%28OSX%29.sublime-keymap "Default (OSX).sublime-keymap"

[preview-img]: https://cloud.githubusercontent.com/assets/931051/14301433/2178c37c-fb98-11e5-8f70-f2e032d3479f.gif