latex_installed_packages.py

# -*- coding:utf-8 -*-
import os
import json

from collections import defaultdict

from functools import partial
import threading
import traceback

import sublime
import sublime_plugin

from .deprecated_command import deprecate
from .latextools_utils.external_command import (
    check_output, CalledProcessError
)

__all__ = ['LatexGenPkgCacheCommand', 'LatextoolsGenPkgCacheCommand']


def _get_tex_searchpath(file_type):
    if file_type is None:
        raise Exception('file_type must be set for _get_tex_searchpath')

    command = ['kpsewhich']
    command.append('--show-path={0}'.format(file_type))

    try:
        return check_output(command)
    except CalledProcessError as e:
        sublime.set_timeout(
            partial(
                sublime.error_message,
                'An error occurred while trying to run kpsewhich. '
                'Files in your TEXMF tree could not be accessed.'
            ),
            0
        )
        if e.output:
            print(e.output)
        traceback.print_exc()
    except OSError:
        sublime.set_timeout(
            partial(
                sublime.error_message,
                'Could not run kpsewhich. Please ensure that your texpath '
                'setting is configured correctly in your LaTeXTools '
                'settings.'
            ),
            0
        )
        traceback.print_exc()

    return None


def _get_files_matching_extensions(paths, extensions=[]):
    if isinstance(extensions, str):
        extensions = [extensions]

    matched_files = defaultdict(lambda: [])

    for path in paths.split(os.pathsep):
        # our current directory isn't usually meaningful from a WindowCommand
        if path == '.':
            continue

        # !! sometimes occurs in the results on POSIX; remove them
        path = path.replace(u'!!', u'')
        path = os.path.normpath(path)
        if not os.path.exists(path):  # ensure path exists
            continue

        if len(extensions) > 0:
            for _, _, files in os.walk(path):
                for f in files:
                    for ext in extensions:
                        if f.endswith(u''.join((os.extsep, ext))):
                            matched_files[ext].append(os.path.splitext(f)[0])
        else:
            for _, _, files in os.walk(path):
                for f in files:
                    matched_files['*'].append(os.path.splitext(f)[0])

    matched_files = dict([
        (key, sorted(set(value), key=lambda s: s.lower()))
        for key, value in matched_files.items()
    ])

    return matched_files


def _generate_package_cache():
    installed_tex_items = _get_files_matching_extensions(
        _get_tex_searchpath('tex'),
        ['sty', 'cls']
    )

    installed_bst = _get_files_matching_extensions(
        _get_tex_searchpath('bst'),
        ['bst']
    )

    # create the cache object
    pkg_cache = {
        'pkg': installed_tex_items['sty'],
        'bst': installed_bst['bst'],
        'cls': installed_tex_items['cls']
    }

    # For ST3, put the cache files in cache dir
    # and for ST2, put it in the user packages dir
    # and change the name
    cache_path = os.path.normpath(
        os.path.join(sublime.cache_path(), "LaTeXTools"))

    if not os.path.exists(cache_path):
        os.makedirs(cache_path)

    pkg_cache_file = os.path.normpath(
        os.path.join(cache_path, 'pkg_cache.cache'))

    with open(pkg_cache_file, 'w+') as f:
        json.dump(pkg_cache, f)

    sublime.set_timeout(
        partial(
            sublime.status_message,
            'Finished generating LaTeX package cache'
        ),
        0
    )


# Generates a cache for installed latex packages, classes and bst.
# Used for fill all command for \documentclass, \usepackage and
# \bibliographystyle envrioments
class LatextoolsGenPkgCacheCommand(sublime_plugin.WindowCommand):

    def run(self):
        # use a separate thread to update cache
        thread = threading.Thread(target=_generate_package_cache)
        thread.daemon = True
        thread.start()

deprecate(globals(), 'LatexGenPkgCacheCommand', LatextoolsGenPkgCacheCommand)