refactor: make telescope explicit dependency

For `lazy.nvim` users, this means they have to explicitly list
`telescope` as dependency. This will only affect those not having
`telescope` as a plugin or dependency elsewhere in their config.

Making it an explicit dependency to be listed by the user is necessary
to prepare for `tinygit` supporting other picker plugins, since
`lazy.nvim`'s package specification via a `lazy.lua` build file does not
give us the flexibility to specify alternative packages.

Author: chrisgrieser

README.md

@@ -6,6 +6,7 @@
 
 Bundle of commands focused on swift and streamlined git operations.
 
+<!-- DEPRECATION 2025-03-03 -->
 ## Breaking changes in v1.0
 - `dressing.nvim` and `nvim-notify` are **no longer dependencies**.
 - `telescope.nvim` is now a **required dependency**.
@@ -99,8 +100,11 @@ Bundle of commands focused on swift and streamlined git operations.
 - *optional*: Treesitter parser for syntax highlighting: `TSInstall gitcommit`
 
 ```lua
--- lazy.nvim (automatically takes care of dependencies)
-{ "chrisgrieser/nvim-tinygit" },
+-- lazy.nvim
+{ 
+	"chrisgrieser/nvim-tinygit"
+	dependencies = "nvim-telescope/telescope.nvim",
+},
 
 -- packer
 use {
@@ -361,7 +365,7 @@ require("tinygit").createGitHubPr()
 
 ### File history
 Search the git history of the current file. Select from the matching commits to
-open a popup with a diffview of the changes.
+open a popup with a diff view of the changes.
 
 If the config `history.autoUnshallowIfNeeded` is set to `true`, will also
 automatically un-shallow the repo if needed.

lazy.lua

@@ -178,7 +178,13 @@ end
 
 ---@param opts? { selectFromLastXCommits?: number, squashInstead: boolean, autoRebase?: boolean }
 function M.fixupCommit(opts)
+	-- GUARD
 	if u.notInGitRepo() or hasNoChanges() then return end
+	local installed, _ = pcall(require, "telescope")
+	if not installed then
+		u.notify("telescope.nvim is not installed.", "warn")
+		return
+	end
 
 	local defaultOpts = { selectFromLastXCommits = 15, autoRebase = false }
 	opts = vim.tbl_deep_extend("force", defaultOpts, opts or {})
@@ -246,7 +252,7 @@ function M.fixupCommit(opts)
 		updateStatusline()
 	end
 
-	require("tinygit.shared.selector").withTelescope(
+	require("tinygit.shared.picker").withTelescope(
 		prompt,
 		commits,
 		commitFormatter,

lua/tinygit/commands/commit.lua

@@ -79,13 +79,19 @@ end
 ---CAVEAT Due to GitHub API limitations, only the last 100 issues are shown.
 ---@param opts? { state?: string, type?: string }
 function M.issuesAndPrs(opts)
+	-- GUARD
 	if u.notInGitRepo() then return end
 	local repo = M.getGithubRemote()
 	if not repo then return end
 	if vim.fn.executable("curl") == 0 then
 		u.notify("`curl` cannot be found.", "warn")
 		return
 	end
+	local installed, _ = pcall(require, "telescope")
+	if not installed then
+		u.notify("telescope.nvim is not installed.", "warn")
+		return
+	end
 
 	local defaultOpts = { state = "all", type = "all" }
 	opts = vim.tbl_deep_extend("force", defaultOpts, opts or {})
@@ -151,7 +157,7 @@ function M.issuesAndPrs(opts)
 		return ("%s #%s %s by %s"):format(icon, issue.number, issue.title, issue.user.login)
 	end
 
-	require("tinygit.shared.selector").withTelescope(
+	require("tinygit.shared.picker").withTelescope(
 		prompt,
 		issues,
 		issueListFormatter,

lua/tinygit/commands/github.lua

@@ -314,7 +314,7 @@ local function selectFromCommits(commitList)
 	end
 	local onChoice = function(_, commitIdx) showDiff(commitIdx) end
 
-	require("tinygit.shared.selector").withTelescope(
+	require("tinygit.shared.picker").withTelescope(
 		prompt,
 		commits,
 		commitFormatter,
@@ -423,7 +423,13 @@ end
 --------------------------------------------------------------------------------
 
 function M.fileHistory()
+	-- GUARD
 	if u.notInGitRepo() then return end
+	local installed, _ = pcall(require, "telescope")
+	if not installed then
+		u.notify("telescope.nvim is not installed.", "warn")
+		return
+	end
 
 	state.absPath = vim.api.nvim_buf_get_name(0)
 	state.ft = vim.bo.filetype