local DataStorage = require("datastorage") local DocSettings = require("docsettings") local datetime = require("datetime") local dump = require("dump") local ffiutil = require("ffi/util") local util = require("util") local joinPath = ffiutil.joinPath local lfs = require("libs/libkoreader-lfs") local realpath = ffiutil.realpath local history_file = joinPath(DataStorage:getDataDir(), "history.lua") -- This is a singleton local ReadHistory = { hist = {}, last_read_time = 0, } local function selectCallback(path) local ReaderUI = require("apps/reader/readerui") ReaderUI:showReader(path) end local function buildEntry(input_time, input_file) local file_path = realpath(input_file) or input_file -- keep orig file path of deleted files return { time = input_time, file = file_path, text = input_file:gsub(".*/", ""), dim = lfs.attributes(file_path, "mode") ~= "file", -- "dim", as expected by Menu mandatory_func = function() -- Show the last read time local readerui_instance = require("apps/reader/readerui"):_getRunningInstance() local currently_opened_file = readerui_instance and readerui_instance.document and readerui_instance.document.file local last_read_ts if file_path == currently_opened_file then -- Don't use the sidecar file date which is updated regularly while -- reading: keep showing the opening time for the current document. last_read_ts = input_time else -- For past documents, the last save time of the settings is better -- as last read time than input_time (its last opening time, that -- we fallback to if no sidecar file) last_read_ts = DocSettings:getLastSaveTime(file_path) or input_time end return datetime.secondsToDateTime(last_read_ts, G_reader_settings:isTrue("twelve_hour_clock")) end, select_enabled_func = function() return lfs.attributes(file_path, "mode") == "file" end, callback = function() selectCallback(input_file) end, } end function ReadHistory:getIndexByFile(item_file) for i, v in ipairs(self.hist) do if item_file == v.file then return i end end end --- Returns leftmost index of the entry with item_time using binary search -- (items in history are sorted by time in reverse order). -- If several entries have equal time, search within them by item_file in alphabetical order. -- If there are no entries with item_time, returns insertion index. function ReadHistory:getIndexByTime(item_time, item_file) local hist_nb = #self.hist if hist_nb == 0 then return 1 end if item_time > self.hist[1].time then return 1 elseif item_time < self.hist[hist_nb].time then return hist_nb + 1 end local s, e, m, d = 1, hist_nb while s <= e do m = bit.rshift(s + e, 1) if item_time < self.hist[m].time then s, d = m + 1, 1 else e, d = m - 1, 0 end end local index = m + d if item_file then while index <= #self.hist and self.hist[index].time == item_time and self.hist[index].file:gsub(".*/", "") < item_file do index = index + 1 end end return index end --- Reduces number of history items to the required limit by removing old items. function ReadHistory:_reduce() local history_size = G_reader_settings:readSetting("history_size") or 500 while #self.hist > history_size do table.remove(self.hist) end end --- Saves history table to a file. function ReadHistory:_flush() local content = {} for _, v in ipairs(self.hist) do table.insert(content, { time = v.time, file = v.file }) end local f = io.open(history_file, "w") if f then f:write("return " .. dump(content) .. "\n") ffiutil.fsyncOpenedFile(f) -- force flush to the storage device f:close() end self:ensureLastFile() end --- Reads history table from file. -- @treturn boolean true if the history_file has been updated and reloaded. function ReadHistory:_read(force_read) local history_file_modification_time = lfs.attributes(history_file, "modification") if history_file_modification_time == nil then -- no history_file, proceed legacy only return true end if force_read or (history_file_modification_time > self.last_read_time) then self.last_read_time = history_file_modification_time local ok, data = pcall(dofile, history_file) if ok and data then self.hist = {} for _, v in ipairs(data) do table.insert(self.hist, buildEntry(v.time, v.file)) end end return true end end --- Reads history from legacy history folder. function ReadHistory:_readLegacyHistory() local history_updated local history_dir = DataStorage:getHistoryDir() for f in lfs.dir(history_dir) do local legacy_history_file = joinPath(history_dir, f) if lfs.attributes(legacy_history_file, "mode") == "file" then local item_path = DocSettings:getFileFromHistory(f) if item_path then local item_time = lfs.attributes(legacy_history_file, "modification") if self:addItem(item_path, item_time, true) then history_updated = true end end end end if history_updated then self:_reduce() self:_flush() end end function ReadHistory:_init() self:reload() end function ReadHistory:ensureLastFile() local last_existing_file for _, v in ipairs(self.hist) do if lfs.attributes(v.file, "mode") == "file" then last_existing_file = v.file break end end G_reader_settings:saveSetting("lastfile", last_existing_file) end --- Get last or previous file in history that is not current_file -- (self.ui.document.file, provided as current_file, might have -- been removed from history). function ReadHistory:getPreviousFile(current_file) if not current_file then current_file = G_reader_settings:readSetting("lastfile") end for _, v in ipairs(self.hist) do -- skip current document and deleted items kept in history if v.file ~= current_file and lfs.attributes(v.file, "mode") == "file" then return v.file end end end --- Used in the BookShortcuts plugin. function ReadHistory:getFileByDirectory(directory, recursive) local real_path = realpath(directory) for _, v in ipairs(self.hist) do local ipath = realpath(ffiutil.dirname(v.file)) if ipath == real_path or (recursive and util.stringStartsWith(ipath, real_path)) then return v.file end end end function ReadHistory:updateItemByPath(old_path, new_path) local index = self:getIndexByFile(old_path) if index then self.hist[index].file = new_path self.hist[index].text = new_path:gsub(".*/", "") self.hist[index].callback = function() selectCallback(new_path) end self:_flush() self:reload(true) end end --- Updates the history list after deleting a file. function ReadHistory:fileDeleted(path) local index = self:getIndexByFile(path) if index then if G_reader_settings:isTrue("autoremove_deleted_items_from_history") then self:removeItem(self.hist[index], index) else self.hist[index].dim = true self:ensureLastFile() end end end --- Removes the history item if the document settings has been reset. function ReadHistory:fileSettingsPurged(path) if G_reader_settings:isTrue("autoremove_deleted_items_from_history") then self:removeItemByPath(path) end end --- Checks the history list for deleted files and removes history items respectively. function ReadHistory:clearMissing() local history_updated for i, v in ipairs(self.hist) do if v.file == nil or lfs.attributes(v.file, "mode") ~= "file" then self:removeItem(v, i, true) -- no flush history_updated = true end end if history_updated then self:_flush() end end function ReadHistory:removeItemByPath(path) local index = self:getIndexByFile(path) if index then self:removeItem(self.hist[index], index) end end function ReadHistory:removeItem(item, idx, no_flush) local index = idx or self:getIndexByTime(item.time, item.file:gsub(".*/", "")) table.remove(self.hist, index) os.remove(DocSettings:getHistoryPath(item.file)) if not no_flush then self:_flush() end end --- Adds new item (last opened document) to the top of the history list. -- If item time (ts) is passed, add item to the history list at this time position. function ReadHistory:addItem(file, ts, no_flash) if file ~= nil and lfs.attributes(file, "mode") == "file" then local index = self:getIndexByFile(realpath(file)) if ts and index and self.hist[index].time == ts then return -- this legacy item is in the history already end local now = ts or os.time() local mtime = lfs.attributes(file, "modification") lfs.touch(file, now, mtime) if index == 1 and not ts then -- last book self.hist[1].time = now else -- old or new book if index then -- old book table.remove(self.hist, index) end index = ts and self:getIndexByTime(ts, file:gsub(".*/", "")) or 1 table.insert(self.hist, index, buildEntry(now, file)) end if not no_flash then self:_reduce() self:_flush() end return true -- used while adding legacy items end end --- Reloads history from history_file and legacy history folder. function ReadHistory:reload(force_read) if self:_read(force_read) then self:_readLegacyHistory() if G_reader_settings:isTrue("autoremove_deleted_items_from_history") then self:clearMissing() end self:_reduce() end end ReadHistory:_init() return ReadHistory