common.py

# coding: utf-8

'''Common stuff, used in other modules'''
from __future__ import print_function
import re, os, fnmatch, sys, itertools
import sublime
from sublime import Region
from os.path import isdir, join, basename

if sublime.platform() == 'windows':
    import ctypes

ST3 = int(sublime.version()) >= 3000

if ST3:
    MARK_OPTIONS = sublime.DRAW_NO_OUTLINE
else:
    MARK_OPTIONS = 0

OS = sublime.platform()
NT = OS == 'windows'
LIN = OS == 'linux'
OSX = OS == 'osx'
RE_FILE = re.compile(r'^(\s*)([^\\//].*)$')
PARENT_SYM = u"⠤"

#
def first(seq, pred):
    '''similar to built-in any() but return the object instead of boolean'''
    return next((item for item in seq if pred(item)), None)

#
def sort_nicely(names):
    """ Sort the given list in the way that humans expect.
    Source: http://www.codinghorror.com/blog/2007/12/sorting-for-humans-natural-sort-order.html
    """
    convert = lambda text: int(text) if text.isdigit() else text.lower()
    alphanum_key = lambda key: [convert(c) for c in re.split('([0-9]+)', key)]
    names.sort(key=alphanum_key)

#
def print(*args, **kwargs):
    """ Redefine print() function; the reason is the inconsistent treatment of
        unicode literals among Python versions used in ST2.
        Redefining/tweaking built-in things is relatively safe; of course, when
        ST2 will become irrelevant, this def might be removed undoubtedly.
    """
    if not (ST3 or NT):
        args = (s.encode('utf-8') if isinstance(s, unicode) else str(s) for s in args)
    else:
        args = (s if isinstance(s, str if ST3 else unicode) else str(s) for s in args)

    sep, end = kwargs.get('sep', ' '), kwargs.get('end', '\n')
    sys.stdout.write(sep.join(s for s in args) + end)

#
def set_proper_scheme(view):
    '''
    this is callback, it is not meant to be called directly
        view.settings().add_on_change('color_scheme', lambda: set_proper_scheme(view))
    set once, right after view is created
    _note_, color_scheme must not be set directly, but in a setting file
    '''
    # Since we cannot create file with syntax, there is moment when view has no settings,
    # but it is activated, so some plugins (e.g. Color Highlighter) set wrong color scheme
    if view.settings().get('outline_rename_mode', False):
        outline_settings = sublime.load_settings('outline-rename-mode.sublime-settings')
    else:
        outline_settings = sublime.load_settings('outline.sublime-settings')

    if view.settings().get('color_scheme') == outline_settings.get('color_scheme'):
        return

    view.settings().set('color_scheme', outline_settings.get('color_scheme'))

#
def calc_width(view):
    '''
    return float width, which must be
        0.0 < width < 1.0 (other values acceptable, but cause unfriendly layout)
    used in show.show() and "outline_select" command with other_group=True
    '''
    width = view.settings().get('outline_width', 0.3)

    if isinstance(width, float):
        width -= width//1  # must be less than 1
    elif isinstance(width, int if ST3 else long):  # assume it is pixels
        wport = view.viewport_extent()[0]
        width = 1 - round((wport - width) / wport, 2)
        if width >= 1:
            width = 0.9
    else:
        sublime.error_message(u'FileBrowser:\n\noutline_width set to '
                              u'unacceptable type "%s", please change it.\n\n'
                              u'Fallback to default 0.3 for now.' % type(width))
        width = 0.3

    return width or 0.1  # avoid 0.0

#
def get_group(groups, nag):
    '''
    groups  amount of groups in window
    nag     number of active group
    return number of neighbour group
    '''
    if groups <= 4 and nag < 2:
        group = 1 if nag == 0 else 0
    elif groups == 4 and nag >= 2:
        group = 3 if nag == 2 else 2
    else:
        group = nag - 1

    return group

#
def relative_path(rpath):
    u'''rpath is either list or empty string (if list, we need only first item);
    return either empty string or rpath[0] (or its parent), e.g.
        foo/bar/ → foo/bar/
        foo/bar  → foo/
    '''
    if rpath:
        rpath = rpath[0]

        if rpath[~0] != os.sep:
            rpath = os.path.split(rpath)[0] + os.sep
        if rpath == os.sep:
            rpath = ''

    return rpath

#
def hijack_window():
    '''Execute on loading plugin or on new window open;
    allow to open FB automatically in ST3
    '''
    settings = sublime.load_settings('outline.sublime-settings')
    command = settings.get("outline_hijack_new_window")

    if command:
        if command == "jump_list":
            sublime.set_timeout(lambda: sublime.windows()[-1].run_command("outline_jump_list"), 1)
        else:
            sublime.set_timeout(lambda: sublime.windows()[-1].run_command("outline", {"immediate": True}), 1)

#
class outlineBaseCommand:    
    """
    Convenience functions for outline TextCommands
    """

    #
    @property
    def path(self):
        return self.view.settings().get('outline_path')

    #    
    def get_path(self):
        path = self.path

        if path == 'ThisPC\\':
            path = ''

        return path

    #    
    def filecount(self):
        """
        Returns the number of files and directories in the view.
        """
        return self.view.settings().get('outline_count', 0)

    #    
    def move_to_extreme(self, extreme="bof"):
        """
        Moves the cursor to the beginning or end of file list.  Clears all sections.
        """
        files = self.fileregion(with_parent_link=True)
        self.view.sel().clear()

        if extreme == "bof":
            ext_region = Region(files.a, files.a)
        else:
            name_point = self.view.extract_scope(self.view.line(files.b).a + 2).a
            ext_region = Region(name_point, name_point)

        self.view.sel().add(ext_region)
        self.view.show_at_center(ext_region)

    #    
    def move(self, forward=None):
        """
        Moves the cursor one line forward or backwards.  Clears all sections.
        """
        assert forward in (True, False), 'forward must be set to True or False'
        files = self.fileregion(with_parent_link=True)

        if not files:
            return

        new_sels = []

        for s in list(self.view.sel()):
            new_sels.append(self._get_name_point(self.next_line(forward, s.a, files)))

        self.view.sel().clear()

        for n in new_sels:
            self.view.sel().add(Region(n, n))

        name_point = new_sels[~0] if forward else new_sels[0]
        surroundings = True if self.view.rowcol(name_point)[0] < 3 else False
        self.view.show(name_point, surroundings)

    #
    def next_line(self, forward, pt, filergn):
        '''Return Region of line for pt within filergn'''
        if filergn.contains(pt):
            # Try moving by one line.
            line = self.view.line(pt)
            pt = forward and (line.b + 1) or (line.a - 1)
        if not filergn.contains(pt):
            # Not (or no longer) in the list of files, so move to the closest edge.
            pt = (pt > filergn.b) and filergn.b or filergn.a

        return self.view.line(pt)

    #    
    def _get_name_point(self, line):
        '''Return point at which filename starts (i.e. after icon & whitspace)'''
        scope = self.view.scope_name(line.a)

        if 'indent' in scope:
            name_point = self.view.extract_scope(line.a).b
        else:
            name_point = line.a + (2 if not 'parent_dir' in scope else 0)

        return name_point

    #    
    def show_parent(self):
        return self.view.settings().get('outline_show_parent', False)

    #    
    def fileregion(self, with_parent_link=False):
        """
        Returns a region containing the lines containing filenames.
        If there are no filenames None is returned.
        """
        if with_parent_link:
            all_items = sorted(self.view.find_by_selector('outline.item'))
        else:
            all_items = sorted(self.view.find_by_selector('outline.item.directory') +
                               self.view.find_by_selector('outline.item.file'))
        if not all_items:
            return None

        return Region(all_items[0].a, all_items[~0].b)

    #    
    def get_parent(self, line, path):
        u'''
        Returns relative path for line
            • line is a region
            • path is self.path
            • self.index is list stored in view settings as 'outline_index'
        '''
        return self.get_fullpath_for(line).replace(path, '', 1)

    #    
    def get_fullpath_for(self, line):
        return self.index[self.view.rowcol(line.a)[0]]

    #    
    def get_all(self):
        """
        Returns a list of all filenames in the view.
        outline_index is always supposed to represent current state of view,
        each item matches corresponding line, thus list will never be empty unless sth went wrong;
        if header is enabled then first two elements are empty strings
        """
        index = self.view.settings().get('outline_index', [])

        if not index:
            return sublime.error_message(u'FileBrowser:\n\n"outline_index" is empty,\n'
                                         u'that shouldn’t happen ever, there is some bug.')

        return index

    #    
    def get_all_relative(self, path):
        return [f.replace(path, '', 1) for f in self.get_all()]

    #    
    def get_selected(self, parent=True, full=False):
        """
        parent
            if False, returned list does not contain PARENT_SYM even if it is in view
        full
            if True, items in returned list are full paths, else relative

        Returns a list of selected filenames.
        self.index should be assigned before call it
        """
        fileregion = self.fileregion(with_parent_link=parent)

        if not fileregion:
            return None

        path = self.get_path()
        names = []

        for line in self._get_lines([s for s in self.view.sel()], fileregion):
            text = self.get_fullpath_for(line) if full else self.get_parent(line, path)
            if text and text not in names:
                names.append(text)

        return names

    #    
    def get_marked(self, full=False):
        '''self.index should be assigned before call it'''
        if not self.filecount():
            return []

        path = self.get_path()
        names = []

        for line in self.view.get_regions('marked'):
            text = self.get_fullpath_for(line) if full else self.get_parent(line, path)
            if text and text not in names:
                names.append(text)

        return names

    #    
    def _mark(self, mark, regions):
        """
        Marks the requested files.

        mark
            True, False, or a function with signature `func(oldmark, filename)`.
            The function should return True or False.

        regions
            List of region(s).  Only files within the region will be modified.
        """
        filergn = self.fileregion()

        if not filergn:
            return

        self.index = self.get_all()
        # We can't update regions for a key, only replace, so we need to record the existing marks.
        marked = dict((self.get_fullpath_for(r), r) for r in self.view.get_regions('marked') if not r.empty())

        for line in self._get_lines(regions, filergn):
            filename = self.get_fullpath_for(line)

            if mark not in (True, False):
                newmark = mark(filename in marked, filename)
                assert newmark in (True, False), u'Invalid mark: {0}'.format(newmark)
            else:
                newmark = mark

            if newmark:
                name_point = self._get_name_point(line)
                marked[filename] = Region(name_point, line.b)
            else:
                marked.pop(filename, None)

        if marked:
            r = sorted(list(marked.values()), key=lambda region: region.a)
            self.view.add_regions('marked', r, 'outline.marked', '', MARK_OPTIONS)
        else:
            self.view.erase_regions('marked')

    #        
    def _get_lines(self, regions, within):
        '''
        regions is a list of non-overlapping region(s), each may have many lines
        within  is a region which is supposed to contain each line
        '''
        return (line for line in itertools.chain(*(self.view.lines(r) for r in regions)) if within.contains(line))

    #    
    def set_ui_in_rename_mode(self, edit):
        header = self.view.settings().get('outline_header', False)

        if header:
            regions = self.view.find_by_selector('text.outline header.outline punctuation.definition.separator.outline')
        else:
            regions = self.view.find_by_selector('text.outline outline.item.parent_dir')

        if not regions:
            return

        region = regions[0]
        start = region.begin()
        self.view.erase(edit, region)

        if header:
            new_text = u"——[RENAME MODE]——" + u"—"*(region.size()-17)
        else:
            new_text = u"⠤ [RENAME MODE]"

        self.view.insert(edit, start, new_text)

    #    
    def set_status(self):
        '''Update status-bar;
        self.show_hidden must be assigned before call it'''
        # if view isnot focused, view.window() may be None
        window          = self.view.window() or sublime.active_window()
        path_in_project = any(folder == self.path[:-1] for folder in window.folders())
        settings        = self.view.settings()
        copied_items    = settings.get('outline_to_copy', [])
        cut_items       = settings.get('outline_to_move', [])
        status = u" 𝌆 [?: Help] {0}Hidden: {1}{2}{3}".format(
            'Project root, ' if path_in_project else '',
            'On' if self.show_hidden else 'Off',
            ', copied(%d)' % len(copied_items) if copied_items else '',
            ', cut(%d)' % len(cut_items) if cut_items else ''
        )
        self.view.set_status("__FileBrowser__", status)

    #    
    def prepare_filelist(self, names, path, goto, indent):
        '''About self.index see outlineRefreshCommand
        could be called from  outlineExpand.expand_single_folder
                     or from  outlineRefresh.continue_refresh
        '''
        items   = []
        tab     = self.view.settings().get('tab_size')
        line    = self.view.line(self.sel.a if self.sel is not None else self.view.sel()[0].a)
        content = self.view.substr(line).replace('\t', ' '*tab)
        ind     = re.compile('^(\s*)').match(content).group(1)
        level   = indent * int((len(ind) / tab) + 1) if ind else indent
        files   = []
        index_dirs  = []
        index_files = []

        for name in names:
            full_name = join(path, goto, name)

            if isdir(full_name):
                index_dirs.append(u'%s%s' % (full_name, os.sep))
                items.append(''.join([level, u"▸ ", name, os.sep]))
            else:
                index_files.append(full_name)
                files.append(''.join([level, u"≡ ", name]))

        index = index_dirs + index_files
        self.index = self.index[:self.number_line] + index + self.index[self.number_line:]
        items += files
        return items

    #    
    def is_hidden(self, filename, path, goto=''):
        if not (path or goto):  # special case for ThisPC
            return False

        tests = self.view.settings().get('outline_hidden_files_patterns', ['.*'])

        if isinstance(tests, str):
            tests = [tests]
        if any(fnmatch.fnmatch(filename, pattern) for pattern in tests):
            return True
        if sublime.platform() != 'windows':
            return False

        # check for attribute on windows:
        try:
            attrs = ctypes.windll.kernel32.GetFileAttributesW(join(path, goto, filename))
            assert attrs != -1
            result = bool(attrs & 2)
        except (AttributeError, AssertionError):
            result = False

        return result

    #    
    def try_listing_directory(self, path):
        '''Return tuple of two element
            items  sorted list of filenames in path, or empty list
            error  exception message, or empty string
        '''
        items, error = [], ''
        try:
            if not self.show_hidden:
                items = [name for name in os.listdir(path) if not self.is_hidden(name, path)]
            else:
                items = os.listdir(path)
        except OSError as e:
            error = str(e)
            if NT:
                error = error.split(':')[0].replace('[Error 5] ', 'Access denied').replace('[Error 3] ', 'Not exists, press r to refresh')
            if not ST3 and LIN:
                error = error.decode('utf8')
        else:
            sort_nicely(items)
        finally:
            return items, error

    #        
    def try_listing_only_dirs(self, path):
        '''Same as self.try_listing_directory, but items contains only directories.
        Used for prompt completion'''
        items, error = self.try_listing_directory(path)

        if items:
            items = [n for n in items if isdir(join(path, n))]

        return (items, error)

    #    
    def restore_marks(self, marked=None):
        if marked:
            # Even if we have the same filenames, they may have moved so we have to manually
            # find them again.
            path = self.get_path()
            regions = []

            for mark in marked:
                matches = self._find_in_view(mark)

                for region in matches:
                    filename = self.get_parent(region, path)

                    if filename == mark:
                        regions.append(region)
                        # if it is found, no need to check other mathes, so break
                        break
            # End for
                        
            self._mark(mark=True, regions=regions)
        else:
            self.view.erase_regions('marked')

    #        
    def restore_sels(self, sels=None):
        '''
        sels is tuple of two elements:
            0 list of filenames
                relative paths to search in the view
            1 list of Regions
                copy of view.sel(), used for fallback if filenames are not found
                in view (e.g. user deleted selected file)
        '''
        if sels:
            seled_fnames, seled_regions = sels
            path = self.get_path()
            regions = []

            for selection in seled_fnames:
                matches = self._find_in_view(selection)

                for region in matches:
                    filename = self.get_parent(region, path)

                    if filename == selection:
                        name_point = self._get_name_point(region)
                        regions.append(Region(name_point, name_point))
                        break
            # End for            

            if regions:
                return self._add_sels(regions)
            else:
                # e.g. when user remove file(s), we just restore sel RegionSet
                # despite positions may be wrong sometimes
                return self._add_sels(seled_regions)
        # End if
                
        # fallback:
        return self._add_sels()

    #    
    def _find_in_view(self, item):
        '''item is Unicode'''
        fname = re.escape(basename(os.path.abspath(item)) or item.rstrip(os.sep))

        if item[~0] == os.sep:
            pattern = u'^\s*[▸▾] '
            sep = re.escape(os.sep)
        else:
            pattern = u'^\s*≡ '
            sep = ''

        return self.view.find_all(u'%s%s%s' % (pattern, fname, sep))

    #    
    def _add_sels(self, sels=None):
        self.view.sel().clear()

        if sels:
            eof = self.view.size()

            for s in sels:
                if s.begin() <= eof:
                    self.view.sel().add(s)

        if not sels or not list(self.view.sel()):  # all sels more than eof
            item = (self.view.find_by_selector('text.outline outline.item.parent_dir ') or
                    self.view.find_by_selector('text.outline outline.item.directory string.name.directory.outline ') or
                    self.view.find_by_selector('text.outline outline.item.file string.name.file.outline '))
            s = Region(item[0].a, item[0].a) if item else Region(0, 0)
            self.view.sel().add(s)

        self.view.show_at_center(s)

    #    
    def display_path(self, folder):
        display = folder
        home = os.path.expanduser("~")

        if folder.startswith(home):
            display = folder.replace(home, "~", 1)
            
        return display
    # End def
# End class
# EOF