Sublime Forum

**mattst** · February 25, 2017, 4:06pm

Importance: Minor

An API method to get whatever syntax path is currently associated with a specific file extension.

e.g. get_syntax_file(file_extension)

At the moment to get this info. something along the lines of this would be needed.

Thanks.

**rwols** · March 3, 2017, 7:31pm

##Make “Open File Prompt” part of the API
Importance: minor

Motivation: Some plugins want to process a file, maybe present it after the processing it in some way. There is currently no canonical way to ask for a file from the user on the API side. There is

sublime.run_command('prompt_open_file')

and this opens an “open file” dialog window; but there is no way to retrieve the selected file. See also this thread.

Proposed solution #1 (old):

New function in module sublime:

sublime.prompt_open_file(on_done, <folder>)

where:

on_done is a function (filepath, window) -> None that takes two argument and returns None:
1. the filepath that the user selected. If the user pressed cancel, then filepath is None.
1. the window where the open file dialog was started.
folder is an optional argument which, if given, starts the open file dialog in the given folder. If it is not given, then the starting folder is whatever the starting folder is when you run sublime.run_command('prompt_open_file')

Proposed solution #2 (better):

New function in module sublime:

sublime.file_selector_dialog(caption, <folder>)

where:

caption is a string for the caption
folder is an optional argument which, if given, starts the open file dialog in the given folder. If it is not given, then the starting folder is whatever the starting folder is when you run sublime.run_command('prompt_open_file')

The function blocks until the user has selected to open a file or cancelled the operation. If the user selected a file, the filepath is returned. If the user canceled the operation, None is returned.

Example usage:

class MyFileProcessorCommand(sublime_plugin.ApplicationCommand):
    def run(self):
        filepath = sublime.file_selector_dialog('gimme a file!')
        if not filepath:
            # User pressed "cancel"
            return
        view = sublime.active_window().new_file()
        contents = None
        with open(filepath) as f:
            contents = f.read()
        # process "contents" ...
        view.run_command('insert', {'characters': contents})

**mattst** · March 3, 2017, 5:08pm

@rwols

The thread I started, linked by rwols, wasn’t really about the lack of a file selector dialog in the API. However with that said it would be a helpful addition to the API.

I don’t think it should be called prompt_open_file(), it would be better to make it more generic, e.g. file_selector_dialog(). There is no need for an on_done callback, better would be for it to block until a file is selected or it is cancelled, then it could return the full path or an empty string on cancellation. The window the method is called from is not needed, active_window() can provide that. Finally since it is a generic file selector dialog the caption must be settable.

file_selector_dialog(caption, <optional_start_folder>)

**rwols** · March 10, 2017, 10:48pm

##Add --{installed-}packages-path command line option to subl

Importance: Medium

Motivation: Lots of plugin installation instructions (the “non Package Control way”) tell the user to “go to their packages folder”, sometimes supplying the full paths for Linux, macOS, Windows. This is pointless as this can just as well be provided by Sublime itself in the form a simple command line option. If Sublime provides it as a command-line option, every plugin author can just write something along the lines of:

If you want to install my package manually, run
$ cd `subl --packages-path`
and then
$ git clone https://github.com/author/package

Proposed solution #1:

Calling

$ subl --packages-path

will print the full path to Sublime’s packages folder. Calling

$ subl --installed-packages-path

will print the full path to Sublime’s installed packages folder.

**math2001** · March 10, 2017, 11:10pm

Way faster IMO

alias st="cd '$APPDATA/Sublime Text 3/Packages'"

**rwols** · March 10, 2017, 11:12pm

Doesn’t that only work on osx?

**math2001** · March 10, 2017, 11:47pm

I’m on Windows using bash from git-for-windows

**rwols** · March 11, 2017, 12:13am

Yeah, I got confused . Anyway, it’s platform dependent is my point. So Sublime should make this issue platform-independent by providing a --packages-path argument.

**ihodev** · March 26, 2017, 8:08am

Add restart command

In some cases it’s really necessary to restart Sublime Text to get plugin to work correctly.

It would be great to have the chance to ask the user to restart ST and run this command if he/she doesn’t mind.
.

**addons_zz** · July 1, 2017, 5:21pm

Originally posted on:

#25346 Combine Windows?

I opened a feature request to allow this on the Core issue tracker:

Core$1794 API to set/change/move views between different windows

After that API addition, you can create the following package/plugin to create the command gather_all_windows_here

import sublime
import sublime_plugin


class GatherAllWindowsHereCommand( sublime_plugin.TextCommand ):

    def run( self, edit ):
        windows        = sublime.windows()
        current_window = sublime.active_window()
        windows.remove( current_window )

        for window in windows:

                for view in window.views()
                    current_window.attach_view( view.id() )

**idleberg** · March 24, 2018, 7:59pm

on_pre_build / on_post_build

This would, for instance, allow running eligibility test before a build starts. One of the most frequent support requests for my packages is about compilers not being in the user’s PATH. An example for on_post_build would be asking the user whether he wants to open a successfully transpiled document in the editor.

**acheronfail** · August 5, 2018, 4:21am

I just read this whole thread and couldn’t find this suggestion, but it’s a large thread so forgive me if I missed it.

Find Previous Command

This would simply add the API to be able to find the previous occurrence of a pattern.
I would suggest adding it as a flag to the already existing API. Something like sublime.REVERSE or similar.

This feature has been requested before:

GitHub issue: https://github.com/SublimeTextIssues/Core/issues/245
Forum Thread: Find the previous occurence of a regex pattern

**avoid** · August 26, 2018, 6:55pm

Way to update the Quick Panel items

I want to perform some work in background and update quick panel list items along the way
Right now I can only take user input, make full list and show it

**slifin** · November 1, 2018, 9:59am

Minihtml is being used to create the interface for debuggers, see: https://github.com/daveleroy/sublime_db
is it possible to get some relative CSS units? So these interfaces can resize when sublime’s window resizes

**Acecool** · November 6, 2018, 5:52am

This would be useful. I already have to replace some of mine with ${x} just so it can be replaced properly later.

**ccw** · February 12, 2019, 1:11am

Glad to see another XEDITer here

**ccw** · February 12, 2019, 3:00pm

##Request to document Fold status of a region and list of folded regions
Importance: medium
Motivation: Being able to detect if a region is folded or not would allow selective processing.

Proposed solution:

Document the two view module functions view.is_folded(region) and view.folded_regions()

**ouweiya** · February 12, 2019, 2:32am

More sorting methods

Importance: Minor

**OdatNurd** · February 12, 2019, 2:26am

API functions to do that already exist, although they’re not currently officially documented (with all of the usual warnings that sort of thing entails). As such the request might better be made to promote them to being official.

**ccw** · February 12, 2019, 2:58pm

Okay Thanks.

API Suggestions

Add restart command

Find Previous Command

More sorting methods

Importance: Minor