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.

• Host: GitHub
• URL: https://github.com/FichteFoll/FileHistory
• Owner: FichteFoll
• License: mit
• Created: 2012-05-16T21:12:45.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2019-08-26T17:02:31.000Z (about 5 years ago)
• Last Synced: 2024-05-01T21:22:12.021Z (5 months ago)
• Topics: hacktoberfest, sublime-text, sublime-text-3, sublime-text-package
• Language: Python
• Homepage:
• Size: 183 KB
• Stars: 52
• Watchers: 6
• Forks: 9
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

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