SublimeLog
A bare-bones console logger for Sublime Text 2 and 3.
Details
Installs
- Total 5K
- Win 2K
- Mac 1K
- Linux 921
| Feb 5 | Feb 4 | Feb 3 | Feb 2 | Feb 1 | Jan 31 | Jan 30 | Jan 29 | Jan 28 | Jan 27 | Jan 26 | Jan 25 | Jan 24 | Jan 23 | Jan 22 | Jan 21 | Jan 20 | Jan 19 | Jan 18 | Jan 17 | Jan 16 | Jan 15 | Jan 14 | Jan 13 | Jan 12 | Jan 11 | Jan 10 | Jan 9 | Jan 8 | Jan 7 | Jan 6 | Jan 5 | Jan 4 | Jan 3 | Jan 2 | Jan 1 | Dec 31 | Dec 30 | Dec 29 | Dec 28 | Dec 27 | Dec 26 | Dec 25 | Dec 24 | Dec 23 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Windows | 0 | 0 | 2 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 1 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 2 |
| Mac | 0 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 |
| Linux | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
SublimeLog
A bare-bones console logger for Sublime Text ~~2 and~~ 3.
Description
Sublime Text 3 provides a console (accessible via Control-`) for interaction with the editor's Python-based innards and plug-in architecture. This plug-in logs the console contents into a plain-text file ornamented with logger activation/deactivation timestamps.
The log is erased and recreated each time Sublime Text is launched.
Installation
The most straightforward installation method is by far via Will Bond's superb Package Control. Alternatively, you may clone (or copy the contents of) this repository into your Sublime Text ./Packages folder:
git clone https://github.com/yrammos/SublimeLog.git
Commands
For now SublimeLog supplies a single command that toggles the logger. The default key-binding is Command-Control-C on OS X or Alt-Control-C on Windows/Linux. You may also invoke it via the command palette (⌘-Shift-P on a Mac or Ctrl-Shift-P otherwise): SublimeLog: Toggle logger (on/off)
The key-binding is adjustable in the default JSON file appropriate to your platform:
./Packages/SublimeLog/Default ({OSX | Linux | Windows}).sublime-keymapping
or, to prevent overwrites following plugin updates, in a corresponding file within the User subfolder:
./Packages/User/SublimeLog ({OSX | Linux | Windows}).sublime-keymapping
Retrieving the log
By default, the console is logged in the following plain-text file:
{HOME}/.subl.log
This default destination is adjustable in:
./Packages/SublimeLog/SublimeLog.sublime-settings
or, preferably, in the User subfolder:
./Packages/User/SublimeLog.sublime-settings
Whatever path-filename you declare for the log is relative to your root folder, so please be sure you have adequate write permissions or the plug-in will complain politely.
Note that Sublime Text no longer needs to be restarted for changes to these settings to take effect.
Serving suggestion
I wrote this plug-in as a complement to my LaTeX workflow. Within a dedicated terminal session, or a tmux pane for that matter, I constantly monitor the log file for changes:
tail -f ~/.subl.log
This provides me with a dynamic view of the console stream in a separate window, without the space- and time-consuming tedium of toggling the console view.
If need to maintain a history of log files following successive restarts of the editor, multitail is probably the best solution. It runs on all major Unix platforms and on Windows via Cygwin.
Version history
12/2/2016
- FIXED: Non-ASCII timestamps no longer cause a crash.
- NEW: Support for Sublime Text 2 is dropped.
4/18/2013
- NEW: Support for Sublime Text 3.
- NEW: Logger may now be toggled via the command palette.
- NEW: Settings modifications no longer necessitate an editor restart to take effect.
7/17/2012
- NEW: Adds preferences menu (Sublime Text 2 > Preferences > Package Settings > SublimeLog).
- FIXED: Default and user preferences are now honored as expected.
6/26/2012
- NEW: Plugin now available via Package Control.
6/22/2012
- NEW: First release.
Copyright © 2012-3 by Yannis Rammos. This work is made available under the terms of the Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0) license, http://creativecommons.org/licenses/by-sa/3.0/.