JSPM – open-in-editor@1.1.0

Package Exports

open-in-editor
open-in-editor/lib/editors
open-in-editor/lib/editors/sublime

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (open-in-editor) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Opens files in editor.

Supported editors:

You also can use any other editor that is able to open files from command line.

Support for more editors is comming soon. PRs are welcomed!

Installation

npm install open-in-editor

Usage

First of all you should create an interface with your settings.

var openInEditor = require('open-in-editor');
var editor = openInEditor.configure({
  // options
}, function(err) {
  console.error('Something went wrong: ' + err);
});

Resulting object has a single method open. This method runs terminal command that opens an editor. Result of this method is a promise:

editor.open('path/to/file.js:3:10')
  .then(function() {
    console.log('Success!');
  }, function(err) {
    console.error('Something went wrong: ' + err);
  });

API

openInEditor.configure([options][, failCallback]);

Arguments:

options – optional is used to set up a command to launch an editor. If no options set it will try to get the command from environment
failCallback – optional function that is called when something's wrong with editor setup.

If editor setup was successful configure method returns an interface with single method open. The method accepts file reference with the following format: filename[:line[:column]], where line and column tell the editor where to place cursor when file is opened.

Options

editor

Type: String

Values: sublime, atom, code, webstorm, phpstorm, idea14ce

Default: not set

Editor that will be used to open a file. Once value is set, we try to detect a command to launch the editor.

Supported editors:

sublime – Sublime Text
atom – Atom Editor
code – Visual Studio Code
webstorm – WebStorm
phpstorm - PhpStorm
idea14ce – IDEA 14 CE

cmd

Type: String

Default: not set

Command that will be used to launch the editor. If this option is set, editor is ignored.

Command could contain placeholders that will be replaced by actual values. Supported placeholders: filename, line and column.

var openInEditor = require('open-in-editor');
var editor = openInEditor.configure({
  cmd: 'code -r -g {filename}:{line}:{column}'
});

If there's no {filename} placholder in the command then {filename}:{line}:{column} is appended. That way previous example could be simplified:

var openInEditor = require('open-in-editor');
var editor = openInEditor.configure({
  cmd: 'code -r -g'
});

line

Type: Number

Default: 1

Defines the number of the first line in the editor. Usually it's 1, but you can set it to 0.

column

Type: Number

Default: 1

Defines the number of the first column in the editor. Usually it's 1, but you can set it to 0.

Environment

If no editor or cmd value specified, we try to get the command to launch editor using environment settings. Following values could be used (in descending priority):

process.env.OPEN_FILE
process.env.VISUAL
process.env.EDITOR

First value found is used. If it's process.env.VISUAL or process.env.EDITOR, it's used directly as cmd option. But process.env.OPEN_FILE is different: if value is allowed for editor parameter, it's used as a value for editor option, otherwise it's used as a value for cmd option.

You can set env settings per command:

OPEN_FILE=atom oe path/to/file.js:4:15
OPEN_FILE="code -r -g" node script.js

CLI

Package could be installed globally.

npm install open-in-editor -g

In this case oe command will be available in terminal.

Usage:

  oe [filename] [options]

Options:

      --cmd <command>      Command to open file
      --debug              Debug errors
  -e, --editor <editor>    Editor: atom, code, sublime, webstorm, phpstorm, idea14ce
  -f, --file <filename>    File to open
  -h, --help               Output usage information
  -v, --version            Output version

express-open-in-editor – Express extension to open files from browser

License

MIT

open-in-editor