local strings = require "plenary.strings" local deprecated = require "telescope.deprecated" local sorters = require "telescope.sorters" local if_nil = vim.F.if_nil local os_sep = require("plenary.path").path.sep -- Keep the values around between reloads _TelescopeConfigurationValues = _TelescopeConfigurationValues or {} _TelescopeConfigurationPickers = _TelescopeConfigurationPickers or {} local function first_non_null(...) local n = select("#", ...) for i = 1, n do local value = select(i, ...) if value ~= nil then return value end end end -- A function that creates an amended copy of the `base` table, -- by replacing keys at "level 2" that match keys in "level 1" in `priority`, -- and then performs a deep_extend. -- May give unexpected results if used with tables of "depth" -- greater than 2. local smarter_depth_2_extend = function(priority, base) local result = {} for key, val in pairs(base) do if type(val) ~= "table" then result[key] = first_non_null(priority[key], val) else result[key] = {} for k, v in pairs(val) do result[key][k] = first_non_null(priority[k], v) end end end for key, val in pairs(priority) do if type(val) ~= "table" then result[key] = first_non_null(val, result[key]) else result[key] = vim.tbl_extend("keep", val, result[key] or {}) end end return result end -- TODO: Add other major configuration points here. -- selection_strategy local config = {} config.smarter_depth_2_extend = smarter_depth_2_extend config.values = _TelescopeConfigurationValues config.descriptions = {} config.pickers = _TelescopeConfigurationPickers function config.set_pickers(pickers) pickers = if_nil(pickers, {}) for k, v in pairs(pickers) do config.pickers[k] = v end end local layout_config_defaults = { width = 0.8, height = 0.9, horizontal = { prompt_position = "bottom", preview_cutoff = 120, }, vertical = { preview_cutoff = 40, }, center = { preview_cutoff = 40, }, cursor = { preview_cutoff = 40, }, } local layout_config_description = string.format( [[ Determines the default configuration values for layout strategies. See |telescope.layout| for details of the configurations options for each strategy. Allows setting defaults for all strategies as top level options and for overriding for specific options. For example, the default values below set the default width to 80%% of the screen width for all strategies except 'center', which has width of 50%% of the screen width. Default: %s ]], vim.inspect(layout_config_defaults, { newline = "\n ", indent = " " }) ) -- A table of all the usual defaults for telescope. -- Keys will be the name of the default, -- values will be a list where: -- - first entry is the value -- - second entry is the description of the option local telescope_defaults = { sorting_strategy = { "descending", [[ Determines the direction "better" results are sorted towards. Available options are: - "descending" (default) - "ascending"]], }, selection_strategy = { "reset", [[ Determines how the cursor acts after each sort iteration. Available options are: - "reset" (default) - "follow" - "row" - "closest"]], }, scroll_strategy = { "cycle", [[ Determines what happens you try to scroll past view of the picker. Available options are: - "cycle" (default) - "limit"]], }, layout_strategy = { "horizontal", [[ Determines the default layout of Telescope pickers. See |telescope.layout| for details of the available strategies. Default: 'horizontal']], }, layout_config = { layout_config_defaults, layout_config_description }, winblend = { 0 }, prompt_prefix = { "> ", [[ Will be shown in front of the prompt. Default: '> ']] }, selection_caret = { "> ", [[ Will be shown in front of the selection. Default: '> ']] }, entry_prefix = { " ", [[ Prefix in front of each result entry. Current selection not included. Default: ' ']], }, initial_mode = { "insert" }, border = { true, [[ Boolean defining if borders are added to Telescope windows. Default: true]] }, path_display = { {}, [[ Determines how file paths are displayed path_display can be set to an array with a combination of: - "hidden" hide file names - "tail" only display the file name, and not the path - "absolute" display absolute paths - "shorten" only display the first character of each directory in the path You can also specify the number of characters of each directory name to keep by setting `path_display.shorten = num`. e.g. for a path like `alpha/beta/gamma/delta.txt` setting `path_display.shorten = 1` will give a path like: `a/b/g/delta.txt` Similarly, `path_display.shorten = 2` will give a path like: `al/be/ga/delta.txt` path_display can also be set to 'hidden' string to hide file names path_display can also be set to a function for custom formatting of the path display. Example: -- Format path as "file.txt (path\to\file\)" path_display = function(opts, path) local tail = require("telescope.utils").path_tail(path) return string.format("%s (%s)", tail, path) end, Default: {}]], }, borderchars = { { "─", "│", "─", "│", "╭", "╮", "╯", "╰" } }, get_status_text = { function(self, opts) local xx = (self.stats.processed or 0) - (self.stats.filtered or 0) local yy = self.stats.processed or 0 if xx == 0 and yy == 0 then return "" end -- local status_icon -- if opts.completed then -- status_icon = "✔️" -- else -- status_icon = "*" -- end return string.format("%s / %s ", xx, yy) end, }, dynamic_preview_title = { false, [[ Will change the title of the preview window dynamically, where it is supported. Means the preview window will for example show the full filename. Default: false]], }, history = { { path = vim.fn.stdpath "data" .. os_sep .. "telescope_history", limit = 100, handler = function(...) return require("telescope.actions.history").get_simple_history(...) end, }, [[ This field handles the configuration for prompt history. By default it is a table, with default values (more below). To disable history, set it to false. Currently mappings still need to be added, Example: mappings = { i = { [""] = require('telescope.actions').cycle_history_next, [""] = require('telescope.actions').cycle_history_prev, }, }, Fields: - path: The path to the telescope history as string. default: stdpath("data")/telescope_history - limit: The amount of entries that will be written in the history. Warning: If limit is set to nil it will grown unbound. default: 100 - handler: A lua function that implements the history. This is meant as a developer setting for extensions to override the history handling, e.g., https://github.com/nvim-telescope/telescope-smart-history.nvim, which allows context sensitive (cwd + picker) history. Default: require('telescope.actions.history').get_simple_history ]], }, -- Builtin configuration -- List that will be executed. -- Last argument will be the search term (passed in during execution) vimgrep_arguments = { { "rg", "--color=never", "--no-heading", "--with-filename", "--line-number", "--column", "--smart-case" }, }, use_less = { true }, color_devicons = { true }, set_env = { nil }, mappings = { {}, [[ Your mappings to override telescope's default mappings. Format is: { mode = { ..keys } } where {mode} is the one character letter for a mode ('i' for insert, 'n' for normal). For example: mappings = { i = { [""] = require('telescope.actions').close, }, } To disable a keymap, put [map] = false So, to not map "", just put ..., [""] = false, ..., Into your config. otherwise, just set the mapping to the function that you want it to be. ..., [""] = require('telescope.actions').select_default, ..., If the function you want is part of `telescope.actions`, then you can simply give a string. For example, the previous option is equivalent to: ..., [""] = "select_default", ..., You can also add other mappings using tables with `type = "command"`. For example: ..., ["jj"] = { "", type = "command" }, ["kk"] = { "echo \"Hello, World!\"", type = "command" },) ..., ]], }, default_mappings = { nil, [[ Not recommended to use except for advanced users. Will allow you to completely remove all of telescope's default maps and use your own. ]], }, generic_sorter = { sorters.get_generic_fuzzy_sorter }, prefilter_sorter = { sorters.prefilter }, file_sorter = { sorters.get_fuzzy_file }, file_ignore_patterns = { nil }, file_previewer = { function(...) return require("telescope.previewers").vim_buffer_cat.new(...) end, }, grep_previewer = { function(...) return require("telescope.previewers").vim_buffer_vimgrep.new(...) end, }, qflist_previewer = { function(...) return require("telescope.previewers").vim_buffer_qflist.new(...) end, }, buffer_previewer_maker = { function(...) return require("telescope.previewers").buffer_previewer_maker(...) end, }, } -- @param user_defaults table: a table where keys are the names of options, -- and values are the ones the user wants -- @param tele_defaults table: (optional) a table containing all of the defaults -- for telescope [defaults to `telescope_defaults`] function config.set_defaults(user_defaults, tele_defaults) user_defaults = if_nil(user_defaults, {}) tele_defaults = if_nil(tele_defaults, telescope_defaults) -- Check if using layout keywords outside of `layout_config` deprecated.picker_window_options(user_defaults) -- Check if using `layout_defaults` instead of `layout_config` user_defaults = deprecated.layout_configuration(user_defaults) local function get(name, default_val) if name == "layout_config" then return smarter_depth_2_extend( if_nil(user_defaults[name], {}), vim.tbl_deep_extend("keep", if_nil(config.values[name], {}), if_nil(default_val, {})) ) end if name == "history" then if user_defaults[name] == false or config.values[name] == false then return false end return smarter_depth_2_extend( if_nil(user_defaults[name], {}), vim.tbl_deep_extend("keep", if_nil(config.values[name], {}), if_nil(default_val, {})) ) end return first_non_null(user_defaults[name], config.values[name], default_val) end local function set(name, default_val, description) -- TODO(doc): Once we have descriptions for all of these, then we can add this back in. -- assert(description, "Config values must always have a description") config.values[name] = get(name, default_val) if description then config.descriptions[name] = strings.dedent(description) end end for key, info in pairs(tele_defaults) do set(key, info[1], info[2]) end local M = {} M.get = get return M end function config.clear_defaults() for k, _ in pairs(config.values) do config.values[k] = nil end end config.set_defaults() return config