feat(config): question filename customization

Author: kawre

README.md

@@ -147,6 +147,12 @@ To see full configuration types see [template.lua](./lua/leetcode/config/templat
         ["leave"] = {},
     },
 
+    ---@type lc.filename
+    filename = function(id, title, alias, extension)
+        local parts = alias and { id, title, alias, extension } or { id, title, extension }
+        return table.concat(parts, ".")
+    end,
+
     keys = {
         toggle = { "q" }, ---@type string|string[]
         confirm = { "<CR>" }, ---@type string|string[]
@@ -300,6 +306,21 @@ hooks = {
 },
 ```
 
+### filename
+
+Custom function to both create and read questions
+
+`alias` can be `nil` and is used for differentiating between `Python` and
+`Python3` languages, since they share the same file extension `.py`
+
+```lua
+---@type lc.filename
+filename = function(id, title, alias, extension)
+    local parts = alias and { id, title, alias, extension } or { id, title, extension }
+    return table.concat(parts, ".")
+end,
+```
+
 ### theme
 
 Override the [default theme](./lua/leetcode/theme/default.lua).

lua/leetcode-ui/question.lua

@@ -60,19 +60,11 @@ end
 ---@return string path, boolean existed
 function Question:path()
     local lang = utils.get_lang(self.lang)
-    local alt = lang.alt and ("." .. lang.alt) or ""
 
-    -- handle legacy file names first
-    local fn_legacy = --
-        ("%s.%s-%s.%s"):format(self.q.frontend_id, self.q.title_slug, lang.slug, lang.ft)
-    self.file = config.storage.home:joinpath(fn_legacy)
+    local id, title, alias, extension = self.q.frontend_id, self.q.title_slug, lang.alias, lang.ft
+    local filename = config.user.filename(id, title, alias, extension)
 
-    if self.file:exists() then
-        return self.file:absolute(), true
-    end
-
-    local fn = ("%s.%s%s.%s"):format(self.q.frontend_id, self.q.title_slug, alt, lang.ft)
-    self.file = config.storage.home:joinpath(fn)
+    self.file = config.storage.home:joinpath(filename)
     local existed = self.file:exists()
 
     if not existed then

lua/leetcode/config/langs.lua

@@ -6,7 +6,7 @@
 ---@field hl? string
 ---@field comment string
 ---@field ft string
----@field alt? string
+---@field alias? string
 
 ---@type lc.language[]
 return {
@@ -33,7 +33,7 @@ return {
         color = "#306998",
         ft = "py",
         comment = "#",
-        alt = "python2",
+        alias = "python2",
     },
     {
         lang = "Python3",

lua/leetcode/config/template.lua

@@ -38,6 +38,8 @@
 
 ---@alias lc.storage table<"cache"|"home", string>
 
+---@alias lc.filename fun(id: string, title: string, alias: string|nil, extension: string): string
+
 ---@class lc.UserConfig
 local M = {
     ---@type string
@@ -112,6 +114,12 @@ local M = {
         ["leave"] = {},
     },
 
+    ---@type lc.filename
+    filename = function(id, title, alias, extension)
+        local parts = alias and { id, title, alias, extension } or { id, title, extension }
+        return table.concat(parts, ".")
+    end,
+
     keys = {
         toggle = { "q" }, ---@type string|string[]
         confirm = { "<CR>" }, ---@type string|string[]