zotero/chrome/content/zotero/xpcom/fulltext.js
Dan Stillman b50b055e44 Wait for DB transaction to end before indexing string
This might help avoid timeouts during indexing.

Addresses #1284
2018-03-01 01:28:28 -05:00

1685 lines
47 KiB
JavaScript

/*
***** BEGIN LICENSE BLOCK *****
Copyright © 2009 Center for History and New Media
George Mason University, Fairfax, Virginia, USA
http://zotero.org
This file is part of Zotero.
Zotero is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Zotero is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with Zotero. If not, see <http://www.gnu.org/licenses/>.
***** END LICENSE BLOCK *****
*/
Zotero.Fulltext = Zotero.FullText = new function(){
this.isCachedMIMEType = isCachedMIMEType;
this.__defineGetter__("pdfConverterCacheFile", function () { return '.zotero-ft-cache'; });
this.__defineGetter__("pdfInfoCacheFile", function () { return '.zotero-ft-info'; });
this.INDEX_STATE_UNAVAILABLE = 0;
this.INDEX_STATE_UNINDEXED = 1;
this.INDEX_STATE_PARTIAL = 2;
this.INDEX_STATE_INDEXED = 3;
this.INDEX_STATE_QUEUED = 4;
this.SYNC_STATE_UNSYNCED = 0;
this.SYNC_STATE_IN_SYNC = 1;
this.SYNC_STATE_TO_PROCESS = 2;
this.SYNC_STATE_TO_DOWNLOAD = 3;
this.SYNC_STATE_MISSING = 4;
const _processorCacheFile = '.zotero-ft-unprocessed';
const kWbClassSpace = 0;
const kWbClassAlphaLetter = 1;
const kWbClassPunct = 2;
const kWbClassHanLetter = 3;
const kWbClassKatakanaLetter = 4;
const kWbClassHiraganaLetter = 5;
const kWbClassHWKatakanaLetter = 6;
const kWbClassThaiLetter = 7;
var _pdfConverter = null; // nsIFile to executable
var _pdfInfo = null; // nsIFile to executable
var _pdfData = null;
var _idleObserverIsRegistered = false;
var _idleObserverDelay = 30;
var _processorTimeoutID = null;
var _processorBlacklist = {};
var _upgradeCheck = true;
var _syncLibraryVersion = 0;
this.init = Zotero.Promise.coroutine(function* () {
yield Zotero.DB.queryAsync("ATTACH ':memory:' AS 'indexing'");
yield Zotero.DB.queryAsync('CREATE TABLE indexing.fulltextWords (word NOT NULL)');
this.decoder = Components.classes["@mozilla.org/intl/utf8converterservice;1"].
getService(Components.interfaces.nsIUTF8ConverterService);
let pdfConverterFileName = "pdftotext";
let pdfInfoFileName = "pdfinfo";
if (Zotero.isWin) {
pdfConverterFileName += '.exe';
pdfInfoFileName += '.exe';
}
let dir = FileUtils.getDir('AChrom', []).parent;
_pdfData = dir.clone();
_pdfData.append('poppler-data');
_pdfData = _pdfData.path;
_pdfConverter = dir.clone();
_pdfInfo = dir.clone();
if(Zotero.isMac) {
_pdfConverter = _pdfConverter.parent;
_pdfConverter.append('MacOS');
_pdfInfo = _pdfInfo.parent;
_pdfInfo.append('MacOS');
}
_pdfConverter.append(pdfConverterFileName);
_pdfInfo.append(pdfInfoFileName);
Zotero.uiReadyPromise.delay(30000).then(() => {
this.registerContentProcessor();
Zotero.addShutdownListener(this.unregisterContentProcessor.bind(this));
// Start/stop content processor with full-text content syncing pref
Zotero.Prefs.registerObserver('sync.fulltext.enabled', (enabled) => {
if (enabled) {
this.registerContentProcessor();
}
else {
this.unregisterContentProcessor();
}
});
// Stop content processor during syncs
Zotero.Notifier.registerObserver(
{
notify: Zotero.Promise.method(function (event, type, ids, extraData) {
if (event == 'start') {
this.unregisterContentProcessor();
}
else if (event == 'stop') {
this.registerContentProcessor();
}
}.bind(this))
},
['sync'],
'fulltext'
);
});
});
this.setPDFConverterPath = function(path) {
_pdfConverter = Zotero.File.pathToFile(path);
};
this.setPDFInfoPath = function(path) {
_pdfInfo = Zotero.File.pathToFile(path);
};
this.setPDFDataPath = function(path) {
_pdfData = path;
};
this.getLibraryVersion = function (libraryID) {
if (!libraryID) throw new Error("libraryID not provided");
return Zotero.DB.valueQueryAsync(
"SELECT version FROM version WHERE schema=?", "fulltext_" + libraryID
)
};
this.setLibraryVersion = Zotero.Promise.coroutine(function* (libraryID, version) {
if (!libraryID) throw new Error("libraryID not provided");
yield Zotero.DB.queryAsync(
"REPLACE INTO version VALUES (?, ?)", ["fulltext_" + libraryID, version]
);
});
this.clearLibraryVersion = function (libraryID) {
return Zotero.DB.queryAsync("DELETE FROM version WHERE schema=?", "fulltext_" + libraryID);
};
this.getItemVersion = Zotero.Promise.coroutine(function* (itemID) {
return Zotero.DB.valueQueryAsync(
"SELECT version FROM fulltextItems WHERE itemID=?", itemID
)
});
this.setItemSynced = function (itemID, version) {
return Zotero.DB.queryAsync(
"UPDATE fulltextItems SET synced=?, version=? WHERE itemID=?",
[this.SYNC_STATE_IN_SYNC, version, itemID]
);
};
// this is a port from http://mxr.mozilla.org/mozilla-central/source/intl/lwbrk/src/nsSampleWordBreaker.cpp to
// Javascript to avoid the overhead of xpcom calls. The port keeps to the mozilla naming of interfaces/constants as
// closely as possible.
function getClass(c, cc) {
if (cc < 0x2E80) { //alphabetical script
if ((cc & 0xFF80) == 0) { // ascii
if (c == ' ' || c == "\t" || c == "\r" || c == "\n") { return kWbClassSpace; }
if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9')) { return kWbClassAlphaLetter; }
return kWbClassPunct;
}
if ((0xFF80 & cc) == 0x0E00) { return kWbClassThaiLetter; }
if (cc == 0x00A0/*NBSP*/) { return kWbClassSpace; }
// General and Supplemental Unicode punctuation
if ((cc >= 0x2000 && cc <= 0x206f) || (cc >= 0x2e00 && cc <= 0x2e7f)) { return kWbClassPunct; }
return kWbClassAlphaLetter;
}
if ((cc >= 0x3400 && cc <= 0x9fff) || (cc>= 0xf900 && cc <= 0xfaff)) /*han*/ { return kWbClassHanLetter; }
if (cc >= 0x30A0 && cc <= 0x30FF) { return kWbClassKatakanaLetter; }
if (cc >= 0x3040 && cc <= 0x309F) { return kWbClassHiraganaLetter; }
if (cc>= 0xFF60 && cc <= 0xFF9F) { return kWbClassHWKatakanaLetter; }
return kWbClassAlphaLetter;
}
this.getPDFConverterExecAndArgs = function () {
return {
exec: _pdfConverter,
args: ['-datadir', _pdfData]
}
};
/*
* Returns true if MIME type is converted to text and cached before indexing
* (e.g. application/pdf is run through pdftotext)
*/
function isCachedMIMEType(mimeType) {
switch (mimeType) {
case 'application/pdf':
return true;
}
return false;
}
/**
* Index multiple words at once
*
* @requireTransaction
* @param {Number} itemID
* @param {Array<string>} words
* @return {Promise}
*/
var indexWords = Zotero.Promise.coroutine(function* (itemID, words) {
Zotero.DB.requireTransaction();
let chunk;
yield Zotero.DB.queryAsync("DELETE FROM indexing.fulltextWords");
while (words.length > 0) {
chunk = words.splice(0, 100);
yield Zotero.DB.queryAsync('INSERT INTO indexing.fulltextWords (word) ' + chunk.map(x => 'SELECT ?').join(' UNION '), chunk);
}
yield Zotero.DB.queryAsync('INSERT OR IGNORE INTO fulltextWords (word) SELECT word FROM indexing.fulltextWords');
yield Zotero.DB.queryAsync('DELETE FROM fulltextItemWords WHERE itemID = ?', [itemID]);
yield Zotero.DB.queryAsync('INSERT OR IGNORE INTO fulltextItemWords (wordID, itemID) SELECT wordID, ? FROM fulltextWords JOIN indexing.fulltextWords USING(word)', [itemID]);
yield Zotero.DB.queryAsync("REPLACE INTO fulltextItems (itemID, version) VALUES (?,?)", [itemID, 0]);
yield Zotero.DB.queryAsync("DELETE FROM indexing.fulltextWords");
});
/**
* @return {Promise}
*/
var indexString = Zotero.Promise.coroutine(function* (text, charset, itemID, stats, version, synced) {
var words = this.semanticSplitter(text, charset);
while (Zotero.DB.inTransaction()) {
yield Zotero.DB.waitForTransaction('indexString()');
}
yield Zotero.DB.executeTransaction(function* () {
this.clearItemWords(itemID, true);
yield indexWords(itemID, words, stats, version, synced);
var sql = "UPDATE fulltextItems SET synced=?";
var params = [synced ? parseInt(synced) : this.SYNC_STATE_UNSYNCED];
if (stats) {
for (let stat in stats) {
sql += ", " + stat + "=?";
params.push(stats[stat] ? parseInt(stats[stat]) : null);
}
}
if (version) {
sql += ", version=?";
params.push(parseInt(version));
}
sql += " WHERE itemID=?";
params.push(itemID);
yield Zotero.DB.queryAsync(sql, params);
/*
var sql = "REPLACE INTO fulltextContent (itemID, textContent) VALUES (?,?)";
Zotero.DB.query(sql, [itemID, {string:text}]);
*/
Zotero.Notifier.queue('refresh', 'item', itemID);
}.bind(this));
// If there's a processor cache file, delete it (whether or not we just used it)
var item = yield Zotero.Items.getAsync(itemID);
var cacheFile = this.getItemProcessorCacheFile(item);
if (cacheFile.exists()) {
cacheFile.remove(false);
}
}.bind(this));
/**
* @param {Document} document
* @param {Number} itemID
* @return {Promise}
*/
this.indexDocument = Zotero.Promise.coroutine(function* (document, itemID) {
if (!itemID){
throw ('Item ID not provided to indexDocument()');
}
Zotero.debug("Indexing document '" + document.title + "'");
if (!Zotero.MIME.isTextType(document.contentType)) {
Zotero.debug(document.contentType + " document is not text", 2);
return false;
}
if (!document.body) {
Zotero.debug("Cannot index " + document.contentType + " file", 2);
return false;
}
if (!document.characterSet){
Zotero.debug("Text file didn't have charset", 2);
return false;
}
var maxLength = Zotero.Prefs.get('fulltext.textMaxLength');
if (!maxLength) {
return false;
}
var obj = yield convertItemHTMLToText(itemID, document.body.innerHTML, maxLength);
var text = obj.text;
var totalChars = obj.totalChars;
if (totalChars > maxLength) {
Zotero.debug('Only indexing first ' + maxLength + ' characters of item '
+ itemID + ' in indexDocument()');
}
yield indexString(text, document.characterSet, itemID);
yield setChars(itemID, { indexed: text.length, total: totalChars });
});
/**
* @param {String} path
* @param {Boolean} [complete=FALSE] Index the file in its entirety, ignoring maxLength
*/
var indexFile = Zotero.Promise.coroutine(function* (path, contentType, charset, itemID, complete, isCacheFile) {
if (!(yield OS.File.exists(path))) {
Zotero.debug('File not found in indexFile()', 2);
return false;
}
if (!contentType) {
Zotero.debug("Content type not provided in indexFile()", 1);
return false;
}
if (!itemID) {
throw new Error('Item ID not provided');
}
if (contentType == 'application/pdf') {
return this.indexPDF(path, itemID, complete);
}
if (!Zotero.MIME.isTextType(contentType)) {
Zotero.debug('File is not text in indexFile()', 2);
return false;
}
if (!charset) {
Zotero.logError(`Item ${itemID} didn't have a charset`);
return false;
}
var maxLength = Zotero.Prefs.get('fulltext.textMaxLength');
if (!maxLength) {
return false;
}
if (complete) {
maxLength = null;
}
Zotero.debug('Indexing file ' + path);
var text = yield Zotero.File.getContentsAsync(path, charset);
var totalChars = text.length;
if (contentType == 'text/html') {
let obj = yield convertItemHTMLToText(itemID, text, maxLength);
text = obj.text;
totalChars = obj.totalChars;
}
else {
if (maxLength && text.length > maxLength) {
text = text.substr(0, maxLength);
}
}
yield indexString(text, charset, itemID);
// Record the number of characters indexed (unless we're indexing a (PDF) cache file,
// in which case the stats are coming from elsewhere)
if (!isCacheFile) {
yield setChars(itemID, { indexed: text.length, total: totalChars });
}
return true;
}.bind(this));
/**
* Run PDF through pdfinfo and pdftotext to generate .zotero-ft-info
* and .zotero-ft-cache, and pass the text file back to indexFile()
*
* @param {nsIFile} file
* @param {Number} itemID
* @param {Boolean} [allPages] - If true, index all pages rather than pdfMaxPages
* @return {Promise}
*/
this.indexPDF = Zotero.Promise.coroutine(function* (filePath, itemID, allPages) {
var maxPages = Zotero.Prefs.get('fulltext.pdfMaxPages');
if (maxPages == 0) {
return false;
}
var item = yield Zotero.Items.getAsync(itemID);
var linkMode = item.attachmentLinkMode;
// If file is stored outside of Zotero, create a directory for the item
// in the storage directory and save the cache file there
if (linkMode == Zotero.Attachments.LINK_MODE_LINKED_FILE) {
var parentDirPath = yield Zotero.Attachments.createDirectoryForItem(item);
}
else {
var parentDirPath = OS.Path.dirname(filePath);
}
var infoFilePath = OS.Path.join(parentDirPath, this.pdfInfoCacheFile);
var cacheFilePath = OS.Path.join(parentDirPath, this.pdfConverterCacheFile);
var args = [filePath, infoFilePath];
try {
yield Zotero.Utilities.Internal.exec(_pdfInfo, args);
var totalPages = yield getTotalPagesFromFile(itemID);
}
catch (e) {
Zotero.debug("Error running " + _pdfInfo.path, 1);
Zotero.logError(e);
}
var {exec, args} = this.getPDFConverterExecAndArgs();
args.push('-nopgbrk');
if (allPages) {
if (totalPages) {
var pagesIndexed = totalPages;
}
}
else {
args.push('-l', maxPages);
var pagesIndexed = Math.min(maxPages, totalPages);
}
args.push(filePath, cacheFilePath);
try {
yield Zotero.Utilities.Internal.exec(exec, args);
}
catch (e) {
Zotero.debug("Error running " + exec.path, 1);
Zotero.logError(e);
return false;
}
if (!(yield OS.File.exists(cacheFilePath))) {
let fileName = OS.Path.basename(filePath);
let msg = fileName + " was not indexed";
if (!fileName.match(/^[\u0000-\u007F]+$/)) {
msg += " -- PDFs with filenames containing extended characters cannot currently be indexed due to a Mozilla limitation";
}
Zotero.debug(msg, 2);
Components.utils.reportError(msg);
return false;
}
yield indexFile(cacheFilePath, 'text/plain', 'utf-8', itemID, true, true);
yield setPages(itemID, { indexed: pagesIndexed, total: totalPages });
return true;
});
/**
* @param {Integer[]|Integer} items - One or more itemIDs
*/
this.indexItems = Zotero.Promise.coroutine(function* (items, complete, ignoreErrors) {
if (!Array.isArray(items)) {
items = [items];
}
var items = yield Zotero.Items.getAsync(items);
var found = [];
for (let i=0; i<items.length; i++) {
let item = items[i];
if (!item.isAttachment()) {
continue;
}
Zotero.debug("Indexing item " + item.libraryKey);
let itemID = item.id;
var path = yield item.getFilePathAsync();
if (!path) {
if (yield OS.File.exists(this.getItemProcessorCacheFile(item).path)) {
yield Zotero.Fulltext.indexFromProcessorCache(itemID);
}
else {
Zotero.debug("No file to index for item " + item.libraryKey
+ " in Zotero.FullText.indexItems()");
}
continue;
}
if (ignoreErrors) {
try {
yield indexFile(path, item.attachmentContentType, item.attachmentCharset, itemID, complete);
}
catch (e) {
Components.utils.reportError("Error indexing " + path);
Zotero.logError(e);
}
}
else {
yield indexFile(path, item.attachmentContentType, item.attachmentCharset, itemID, complete);
}
}
});
// TEMP: Temporary mechanism to serialize indexing of new attachments
//
// This should instead save the itemID to a table that's read by the content processor
var _queue = [];
var _indexing = false;
var _nextIndexTime;
var _indexDelay = 5000;
var _indexInterval = 500;
this.queueItem = function (item) {
// Don't index files in the background during tests
if (Zotero.test) return;
_queue.push(item.id);
_nextIndexTime = Date.now() + _indexDelay;
setTimeout(() => {
_processNextItem()
}, _indexDelay);
};
async function _processNextItem() {
if (!_queue.length) return;
// Another _processNextItem() was scheduled
if (Date.now() < _nextIndexTime) return;
// If indexing is already running, _processNextItem() will be called when it's done
if (_indexing) return;
_indexing = true;
var itemID = _queue.shift();
try {
await Zotero.Fulltext.indexItems([itemID], false, true);
}
finally {
_indexing = false;
}
setTimeout(() => {
_processNextItem();
}, _indexInterval);
};
//
// Full-text content syncing
//
/**
* Get content and stats that haven't yet been synced
*
* @param {Integer} libraryID
* @param {Integer} [options]
* @param {Integer} [options.maxSize]
* @param {Integer} [options.maxItems]
* @param {Integer} [options.lastItemID] - Only return content for items above this id
* @return {Promise<Array<Object>>}
*/
this.getUnsyncedContent = Zotero.Promise.coroutine(function* (libraryID, options = {}) {
var contentItems = [];
var sql = "SELECT itemID, indexedChars, totalChars, indexedPages, totalPages "
+ "FROM fulltextItems FI JOIN items I USING (itemID) WHERE libraryID=? AND "
+ "FI.synced=? AND I.synced=1 ";
var params = [libraryID, this.SYNC_STATE_UNSYNCED];
if (options.lastItemID) {
sql += "AND itemID>?";
params.push(options.lastItemID);
}
sql += "ORDER BY itemID";
var rows = yield Zotero.DB.queryAsync(sql, params);
var contentSize = 0;
for (let i = 0; i < rows.length; i++) {
let row = rows[i];
let content;
let itemID = row.itemID;
let item = yield Zotero.Items.getAsync(itemID);
let libraryKey = item.libraryKey;
let contentType = item.attachmentContentType;
if (contentType && (isCachedMIMEType(contentType) || Zotero.MIME.isTextType(contentType))) {
try {
let cacheFile = this.getItemCacheFile(item).path;
if (yield OS.File.exists(cacheFile)) {
Zotero.debug("Getting full-text content from cache "
+ "file for item " + libraryKey);
content = yield Zotero.File.getContentsAsync(cacheFile);
}
else {
// If there should be a cache file and isn't, mark the full text as missing
if (!Zotero.MIME.isTextType(contentType)) {
Zotero.debug("Full-text content cache file doesn't exist for item "
+ libraryKey, 2);
let sql = "UPDATE fulltextItems SET synced=? WHERE itemID=?";
yield Zotero.DB.queryAsync(sql, [this.SYNC_STATE_MISSING, item.id]);
continue;
}
// Same for missing attachments
let path = yield item.getFilePathAsync();
if (!path) {
Zotero.debug("File doesn't exist getting full-text content for item "
+ libraryKey, 2);
let sql = "UPDATE fulltextItems SET synced=? WHERE itemID=?";
yield Zotero.DB.queryAsync(sql, [this.SYNC_STATE_MISSING, item.id]);
continue;
}
Zotero.debug("Getting full-text content from file for item " + libraryKey);
content = yield Zotero.File.getContentsAsync(path, item.attachmentCharset);
// If HTML, convert to plain text first, and cache the result
if (item.attachmentContentType == 'text/html') {
let obj = yield convertItemHTMLToText(
itemID,
content,
// Include in the cache file only as many characters as we
// indexed previously
row.indexedChars
);
content = obj.text;
}
else {
// Include only as many characters as we've indexed
content = content.substr(0, row.indexedChars);
}
}
}
catch (e) {
Zotero.logError(e);
continue;
}
}
else {
Zotero.debug("Skipping non-text file getting full-text content for item "
+ `${libraryKey} (contentType: ${contentType})`, 2);
// Delete rows for items that weren't supposed to be indexed
yield Zotero.DB.executeTransaction(function* () {
yield this.clearItemWords(itemID);
}.bind(this));
continue;
}
// If this isn't the first item and it would put us over the size limit, stop
if (contentItems.length && options.maxSize && contentSize + content.length > options.maxSize) {
break;
}
contentItems.push({
itemID: item.id,
key: item.key,
content,
indexedChars: row.indexedChars ? row.indexedChars : 0,
totalChars: row.totalChars ? row.totalChars : 0,
indexedPages: row.indexedPages ? row.indexedPages : 0,
totalPages: row.totalPages ? row.totalPages : 0
});
if (options.maxItems && contentItems.length >= options.maxItems) {
break;
}
contentSize += content.length;
}
return contentItems;
});
/**
* @return {String} PHP-formatted POST data for items not yet downloaded
*/
this.getUndownloadedPostData = Zotero.Promise.coroutine(function* () {
// TODO: Redo for API syncing
// On upgrade, get all content
var sql = "SELECT value FROM settings WHERE setting='fulltext' AND key='downloadAll'";
if (yield Zotero.DB.valueQueryAsync(sql)) {
return "&ftkeys=all";
}
var sql = "SELECT itemID FROM fulltextItems WHERE synced=" + this.SYNC_STATE_TO_DOWNLOAD;
var itemIDs = yield Zotero.DB.columnQueryAsync(sql);
if (!itemIDs) {
return "";
}
var undownloaded = {};
for (let i=0; i<itemIDs.length; i++) {
let itemID = itemIDs[i];
let item = yield Zotero.Items.getAsync(itemID);
let libraryID = item.libraryID
if (!undownloaded[libraryID]) {
undownloaded[libraryID] = [];
}
undownloaded[libraryID].push(item.key);
}
var data = "";
for (let libraryID in undownloaded) {
for (let i = 0; i < undownloaded[libraryID].length; i++) {
data += "&" + encodeURIComponent("ftkeys[" + libraryID + "][" + i + "]")
+ "=" + undownloaded[libraryID][i];
}
}
return data;
});
/**
* Save full-text content and stats to a cache file
*
* @param {Integer} libraryID
* @param {String} key - Item key
* @param {Object} data
* @param {String} data.content
* @param {Integer} [data.indexedChars]
* @param {Integer} [data.totalChars]
* @param {Integer} [data.indexedPages]
* @param {Integer} [data.totalPages]
* @param {Integer} version
* @return {Promise}
*/
this.setItemContent = Zotero.Promise.coroutine(function* (libraryID, key, data, version) {
var libraryKey = libraryID + "/" + key;
var item = Zotero.Items.getByLibraryAndKey(libraryID, key);
if (!item) {
let msg = "Item " + libraryKey + " not found setting full-text content";
Zotero.logError(msg);
return;
}
var itemID = item.id;
var currentVersion = yield this.getItemVersion(itemID)
var processorCacheFile = this.getItemProcessorCacheFile(item).path; // .zotero-ft-unprocessed
var itemCacheFile = this.getItemCacheFile(item).path; // .zotero-ft-cache
// If a storage directory doesn't exist, create it
if (!(yield OS.File.exists(OS.Path.dirname(processorCacheFile)))) {
yield Zotero.Attachments.createDirectoryForItem(item);
}
// If indexed previously and the existing extracted text matches the new text,
// just update the version
if (currentVersion !== false
&& (yield OS.File.exists(itemCacheFile))
&& (yield Zotero.File.getContentsAsync(itemCacheFile)) == data.content) {
Zotero.debug("Current full-text content matches remote for item "
+ libraryKey + " -- updating version");
return Zotero.DB.queryAsync(
"REPLACE INTO fulltextItems (itemID, version, synced) VALUES (?, ?, ?)",
[itemID, version, this.SYNC_STATE_IN_SYNC]
);
}
// Otherwise save data to -unprocessed file
Zotero.debug("Writing full-text content and data for item " + libraryKey
+ " to " + processorCacheFile);
yield Zotero.File.putContentsAsync(processorCacheFile, JSON.stringify({
indexedChars: data.indexedChars,
totalChars: data.totalChars,
indexedPages: data.indexedPages,
totalPages: data.totalPages,
version,
text: data.content
}));
var synced = this.SYNC_STATE_TO_PROCESS;
// If indexed previously, update the sync state
if (currentVersion !== false) {
yield Zotero.DB.queryAsync("UPDATE fulltextItems SET synced=? WHERE itemID=?", [synced, itemID]);
}
// If not yet indexed, add an empty row
else {
yield Zotero.DB.queryAsync(
"REPLACE INTO fulltextItems (itemID, version, synced) VALUES (?, 0, ?)",
[itemID, synced]
);
}
this.registerContentProcessor();
});
/**
* Start the idle observer for the background content processor
*/
this.registerContentProcessor = function () {
if (!Zotero.Prefs.get('sync.fulltext.enabled')) return;
if (!_idleObserverIsRegistered) {
Zotero.debug("Starting full-text content processor");
var idleService = Components.classes["@mozilla.org/widget/idleservice;1"]
.getService(Components.interfaces.nsIIdleService);
idleService.addIdleObserver(this.idleObserver, _idleObserverDelay);
_idleObserverIsRegistered = true;
}
}
this.unregisterContentProcessor = function () {
if (_idleObserverIsRegistered) {
Zotero.debug("Unregistering full-text content processor idle observer");
var idleService = Components.classes["@mozilla.org/widget/idleservice;1"]
.getService(Components.interfaces.nsIIdleService);
idleService.removeIdleObserver(this.idleObserver, _idleObserverDelay);
_idleObserverIsRegistered = false;
}
this.stopContentProcessor();
}
/**
* Stop the idle observer and a running timer, if there is one
*/
this.stopContentProcessor = function () {
Zotero.debug("Stopping full-text content processor");
if (_processorTimeoutID) {
clearTimeout(_processorTimeoutID);
_processorTimeoutID = null;
}
}
/**
* Find items marked as having unprocessed cache files, run cache file processing on one item, and
* after a short delay call self again with the remaining items
*
* @param {Array<Integer>} itemIDs An array of itemIDs to process; if this
* is omitted, a database query is made
* to find unprocessed content
* @return {Boolean} TRUE if there's more content to process; FALSE otherwise
*/
this.processUnprocessedContent = Zotero.Promise.coroutine(function* (itemIDs) {
// Idle observer can take a little while to trigger and may not cancel the setTimeout()
// in time, so check idle time directly
var idleService = Components.classes["@mozilla.org/widget/idleservice;1"]
.getService(Components.interfaces.nsIIdleService);
if (idleService.idleTime < _idleObserverDelay * 1000) {
return;
}
if (!itemIDs) {
Zotero.debug("Checking for unprocessed full-text content");
let sql = "SELECT itemID FROM fulltextItems WHERE synced=" + this.SYNC_STATE_TO_PROCESS;
itemIDs = yield Zotero.DB.columnQueryAsync(sql);
}
var origLen = itemIDs.length;
itemIDs = itemIDs.filter(function (id) {
return !(id in _processorBlacklist);
});
if (itemIDs.length < origLen) {
let skipped = (origLen - itemIDs.length);
Zotero.debug("Skipping large full-text content for " + skipped
+ " item" + (skipped == 1 ? '' : 's'));
}
// If there's no more unprocessed content, stop the idle observer
if (!itemIDs.length) {
Zotero.debug("No unprocessed full-text content found");
this.unregisterContentProcessor();
return;
}
let itemID = itemIDs.shift();
let item = yield Zotero.Items.getAsync(itemID);
Zotero.debug("Processing full-text content for item " + item.libraryKey);
yield Zotero.Fulltext.indexFromProcessorCache(itemID);
if (!itemIDs.length || idleService.idleTime < _idleObserverDelay * 1000) {
return;
}
// If there are remaining items, call self again after a short delay. The delay allows
// for processing to be interrupted if the user returns from idle. At least on macOS,
// when Zotero is in the background this can be throttled to 10 seconds.
_processorTimeoutID = setTimeout(() => this.processUnprocessedContent(itemIDs), 200);
});
this.idleObserver = {
observe: function (subject, topic, data) {
// On idle, start the background processor
if (topic == 'idle') {
this.processUnprocessedContent();
}
// When back from idle, stop the processor (but keep the idle observer registered)
else if (topic == 'active') {
this.stopContentProcessor();
}
}.bind(this)
};
/**
* @param {Number} itemID
* @return {Promise<Boolean>}
*/
this.indexFromProcessorCache = Zotero.Promise.coroutine(function* (itemID) {
try {
var item = yield Zotero.Items.getAsync(itemID);
var cacheFile = this.getItemProcessorCacheFile(item).path;
if (!(yield OS.File.exists(cacheFile))) {
Zotero.debug("Full-text content processor cache file doesn't exist for item " + itemID);
yield Zotero.DB.queryAsync(
"UPDATE fulltextItems SET synced=? WHERE itemID=?",
[this.SYNC_STATE_UNSYNCED, itemID]
);
return false;
}
var json = yield Zotero.File.getContentsAsync(cacheFile);
var data = JSON.parse(json);
// Write the text content to the regular cache file
var item = yield Zotero.Items.getAsync(itemID);
cacheFile = this.getItemCacheFile(item).path;
Zotero.debug("Writing full-text content to " + cacheFile);
yield Zotero.File.putContentsAsync(cacheFile, data.text);
yield indexString(
data.text,
"UTF-8",
itemID,
{
indexedChars: data.indexedChars,
totalChars: data.totalChars,
indexedPages: data.indexedPages,
totalPages: data.totalPages
},
data.version,
1
);
return true;
}
catch (e) {
Components.utils.reportError(e);
Zotero.debug(e, 1);
return false;
};
});
//
// End full-text content syncing
//
/*
* Scan a string for another string
*
* _items_ -- one or more attachment items to search
* _searchText_ -- text pattern to search for
* _mode_:
* 'regexp' -- regular expression (case-insensitive)
* 'regexpCS' -- regular expression (case-sensitive)
*
* - Slashes in regex are optional
*/
function findTextInString(content, searchText, mode) {
switch (mode){
case 'regexp':
case 'regexpCS':
case 'regexpBinary':
case 'regexpCSBinary':
// Do a multiline search by default
var flags = 'm';
var parts = searchText.match(/^\/(.*)\/([^\/]*)/);
if (parts){
searchText = parts[1];
// Ignore user-supplied flags
//flags = parts[2];
}
if (mode.indexOf('regexpCS')==-1){
flags += 'i';
}
try {
var re = new RegExp(searchText, flags);
var matches = re.exec(content);
}
catch (e) {
Zotero.debug(e, 1);
Components.utils.reportError(e);
}
if (matches){
Zotero.debug("Text found");
return content.substr(matches.index, 50);
}
break;
default:
// Case-insensitive
searchText = searchText.toLowerCase();
content = content.toLowerCase();
var pos = content.indexOf(searchText);
if (pos!=-1){
Zotero.debug('Text found');
return content.substr(pos, 50);
}
}
return -1;
}
/**
* Scan item files for a text string
*
* _items_ -- one or more attachment items to search
* _searchText_ -- text pattern to search for
* _mode_:
* 'phrase'
* 'regexp'
* 'regexpCS' -- case-sensitive regular expression
*
* Note:
* - Slashes in regex are optional
* - Add 'Binary' to the mode to search all files, not just text files
*
* @return {Promise<Array<Object>>} A promise for an array of match objects, with 'id' containing
* an itemID and 'match' containing a string snippet
*/
this.findTextInItems = Zotero.Promise.coroutine(function* (items, searchText, mode){
if (!searchText){
return [];
}
var items = yield Zotero.Items.getAsync(items);
var found = [];
for (let i=0; i<items.length; i++) {
let item = items[i];
if (!item.isAttachment()) {
continue;
}
let itemID = item.id;
let content;
let mimeType = item.attachmentContentType;
let maxLength = Zotero.Prefs.get('fulltext.textMaxLength');
let binaryMode = mode && mode.indexOf('Binary') != -1;
if (isCachedMIMEType(mimeType)) {
let file = this.getItemCacheFile(item).path;
if (!(yield OS.File.exists(file))) {
continue;
}
Zotero.debug("Searching for text '" + searchText + "' in " + file);
content = yield Zotero.File.getContentsAsync(file, 'utf-8', maxLength);
}
else {
// If not binary mode, only scan plaintext files
if (!binaryMode) {
if (!Zotero.MIME.isTextType(mimeType)) {
Zotero.debug('Not scanning MIME type ' + mimeType, 4);
continue;
}
}
// Check for a cache file
let cacheFile = this.getItemCacheFile(item).path;
if (yield OS.File.exists(cacheFile)) {
Zotero.debug("Searching for text '" + searchText + "' in " + cacheFile);
content = yield Zotero.File.getContentsAsync(cacheFile, 'utf-8', maxLength);
}
else {
// If that doesn't exist, check for the actual file
let path = yield item.getFilePathAsync();
if (!path) {
continue;
}
Zotero.debug("Searching for text '" + searchText + "' in " + path);
content = yield Zotero.File.getContentsAsync(path, item.attachmentCharset);
// If HTML and not binary mode, convert to text
if (mimeType == 'text/html' && !binaryMode) {
// Include in the cache file only as many characters as we've indexed
let chars = yield getChars(itemID);
let obj = yield convertItemHTMLToText(
itemID, content, chars ? chars.indexedChars : null
);
content = obj.text;
}
}
}
let match = findTextInString(content, searchText, mode);
if (match != -1) {
found.push({
id: itemID,
match: match
});
}
}
return found;
});
/**
* @requireTransaction
*/
this.clearItemWords = Zotero.Promise.coroutine(function* (itemID, skipCacheClear) {
Zotero.DB.requireTransaction();
var sql = "SELECT rowid FROM fulltextItems WHERE itemID=? LIMIT 1";
var indexed = yield Zotero.DB.valueQueryAsync(sql, itemID);
if (indexed) {
yield Zotero.DB.queryAsync("DELETE FROM fulltextItemWords WHERE itemID=?", itemID);
yield Zotero.DB.queryAsync("DELETE FROM fulltextItems WHERE itemID=?", itemID);
}
if (indexed) {
Zotero.Prefs.set('purge.fulltext', true);
}
if (!skipCacheClear) {
// Delete fulltext cache file if there is one
yield clearCacheFile(itemID);
}
});
/**
* @return {Promise}
*/
this.getPages = function (itemID, force) {
var sql = "SELECT indexedPages, totalPages AS total "
+ "FROM fulltextItems WHERE itemID=?";
return Zotero.DB.rowQueryAsync(sql, itemID);
}
/**
* Gets the number of pages from the PDF info cache file
*
* @private
* @return {Promise}
*/
var getTotalPagesFromFile = Zotero.Promise.coroutine(function* (itemID) {
var file = OS.Path.join(
Zotero.Attachments.getStorageDirectoryByID(itemID).path,
Zotero.Fulltext.pdfInfoCacheFile
);
if (!(yield OS.File.exists(file))) {
return false;
}
var contents = yield Zotero.File.getContentsAsync(file);
try {
// Parse pdfinfo output
var pages = contents.match('Pages:[^0-9]+([0-9]+)')[1];
}
catch (e) {
Zotero.debug(e);
return false;
}
return pages;
});
/**
* @return {Promise}
*/
function getChars(itemID) {
var sql = "SELECT indexedChars, totalChars AS total "
+ "FROM fulltextItems WHERE itemID=?";
return Zotero.DB.rowQueryAsync(sql, itemID);
}
/**
* Gets the number of characters from the PDF converter cache file
*
* @return {Promise}
*/
var getTotalCharsFromFile = Zotero.Promise.coroutine(function* (itemID) {
var item = yield Zotero.Items.getAsync(itemID);
switch (item.attachmentContentType) {
case 'application/pdf':
var file = OS.Path.join(
Zotero.Attachments.getStorageDirectory(item).path,
this.pdfConverterCacheFile
);
if (!(yield OS.File.exists(file))) {
return false;
}
break;
default:
var file = yield item.getFilePathAsync();
if (!file) {
return false;
}
}
var contents = yield Zotero.File.getContentsAsync(file);
return contents.length;
});
/**
* @return {Promise}
*/
function setPages(itemID, obj) {
var sql = "UPDATE fulltextItems SET indexedPages=?, totalPages=? WHERE itemID=?";
return Zotero.DB.queryAsync(
sql,
[
obj.indexed ? parseInt(obj.indexed) : null,
obj.total ? parseInt(obj.total) : null,
itemID
]
);
}
/**
* @param {Number} itemID
* @param {Object} obj
* @return {Promise}
*/
function setChars(itemID, obj) {
var sql = "UPDATE fulltextItems SET indexedChars=?, totalChars=? WHERE itemID=?";
return Zotero.DB.queryAsync(
sql,
[
obj.indexed ? parseInt(obj.indexed) : null,
obj.total ? parseInt(obj.total) : null,
itemID
]
);
}
/*
* Gets the indexed state of an item,
*/
this.getIndexedState = Zotero.Promise.coroutine(function* (item) {
if (!item.isAttachment()) {
throw new Error('Item is not an attachment');
}
// If the file or cache file wasn't available during syncing, mark as unindexed
var synced = yield Zotero.DB.valueQueryAsync(
"SELECT synced FROM fulltextItems WHERE itemID=?", item.id
);
if (synced === false || synced == this.SYNC_STATE_MISSING) {
return this.INDEX_STATE_UNINDEXED;
}
var itemID = item.id;
var state = this.INDEX_STATE_UNINDEXED;
switch (item.attachmentContentType) {
// Use pages for PDFs
case 'application/pdf':
var o = yield this.getPages(itemID);
if (o) {
var stats = {
indexed: o.indexedPages,
total: o.total
};
}
break;
default:
var o = yield getChars(itemID);
if (o) {
var stats = {
indexed: o.indexedChars,
total: o.total
};
}
}
if (stats) {
if (!stats.total && !stats.indexed) {
let queued = false;
try {
queued = yield OS.File.exists(this.getItemProcessorCacheFile(item).path);
}
catch (e) {
Zotero.logError(e);
}
state = queued ? this.INDEX_STATE_QUEUED : this.INDEX_STATE_UNAVAILABLE;
}
else if (!stats.indexed) {
state = this.INDEX_STATE_UNINDEXED;
}
else if (stats.indexed < stats.total) {
state = this.INDEX_STATE_PARTIAL;
}
else {
state = this.INDEX_STATE_INDEXED;
}
}
return state;
});
this.isFullyIndexed = Zotero.Promise.coroutine(function* (item) {
return (yield this.getIndexedState(item)) == this.INDEX_STATE_INDEXED;
});
/**
* @return {Promise}
*/
this.getIndexStats = Zotero.Promise.coroutine(function* () {
var sql = "SELECT COUNT(*) FROM fulltextItems WHERE synced != ? AND "
+ "((indexedPages IS NOT NULL AND indexedPages=totalPages) OR "
+ "(indexedChars IS NOT NULL AND indexedChars=totalChars))"
var indexed = yield Zotero.DB.valueQueryAsync(sql, this.SYNC_STATE_MISSING);
var sql = "SELECT COUNT(*) FROM fulltextItems WHERE "
+ "(indexedPages IS NOT NULL AND indexedPages<totalPages) OR "
+ "(indexedChars IS NOT NULL AND indexedChars<totalChars)"
var partial = yield Zotero.DB.valueQueryAsync(sql);
var sql = "SELECT COUNT(*) FROM itemAttachments WHERE itemID NOT IN "
+ "(SELECT itemID FROM fulltextItems WHERE synced != ? AND "
+ "(indexedPages IS NOT NULL OR indexedChars IS NOT NULL))";
var unindexed = yield Zotero.DB.valueQueryAsync(sql, this.SYNC_STATE_MISSING);
var sql = "SELECT COUNT(*) FROM fulltextWords";
var words = yield Zotero.DB.valueQueryAsync(sql);
return { indexed, partial, unindexed, words };
});
this.getItemCacheFile = function (item) {
var cacheFile = Zotero.Attachments.getStorageDirectory(item);
cacheFile.append(this.pdfConverterCacheFile);
return cacheFile;
}
this.getItemProcessorCacheFile = function (item) {
var cacheFile = Zotero.Attachments.getStorageDirectory(item);
cacheFile.append(_processorCacheFile);
return cacheFile;
}
/*
* Returns true if an item can be reindexed
*
* Item must be a non-web-link attachment that isn't already fully indexed
*/
this.canReindex = Zotero.Promise.coroutine(function* (item) {
if (item.isAttachment()
&& item.attachmentLinkMode != Zotero.Attachments.LINK_MODE_LINKED_URL) {
let contentType = item.attachmentContentType;
if (!contentType || contentType != 'application/pdf' && !Zotero.MIME.isTextType(contentType)) {
return false;
}
switch (yield this.getIndexedState(item)) {
case this.INDEX_STATE_UNAVAILABLE:
case this.INDEX_STATE_UNINDEXED:
case this.INDEX_STATE_PARTIAL:
case this.INDEX_STATE_QUEUED:
// TODO: automatically reindex already-indexed attachments?
case this.INDEX_STATE_INDEXED:
return true;
}
}
return false;
});
/**
* @return {Promise}
*/
this.rebuildIndex = Zotero.Promise.coroutine(function* (unindexedOnly) {
// Get all attachments other than web links
var sql = "SELECT itemID FROM itemAttachments WHERE linkMode!="
+ Zotero.Attachments.LINK_MODE_LINKED_URL;
var params = [];
if (unindexedOnly) {
sql += " AND itemID NOT IN (SELECT itemID FROM fulltextItems "
+ "WHERE synced != ? AND (indexedChars IS NOT NULL OR indexedPages IS NOT NULL))";
params.push(this.SYNC_STATE_MISSING);
}
var items = yield Zotero.DB.columnQueryAsync(sql, params);
if (items) {
yield Zotero.DB.executeTransaction(function* () {
yield Zotero.DB.queryAsync(
"DELETE FROM fulltextItemWords WHERE itemID IN (" + sql + ")", params
);
yield Zotero.DB.queryAsync(
"DELETE FROM fulltextItems WHERE itemID IN (" + sql + ")", params
);
});
yield this.indexItems(items, false, true);
}
});
/**
* Clears full-text word index and all full-text cache files
*
* @return {Promise}
*/
this.clearIndex = function (skipLinkedURLs) {
return Zotero.DB.executeTransaction(function* () {
var sql = "DELETE FROM fulltextItems";
if (skipLinkedURLs) {
var linkSQL = "SELECT itemID FROM itemAttachments WHERE linkMode ="
+ Zotero.Attachments.LINK_MODE_LINKED_URL;
sql += " WHERE itemID NOT IN (" + linkSQL + ")";
}
yield Zotero.DB.queryAsync(sql);
sql = "DELETE FROM fulltextItemWords";
if (skipLinkedURLs) {
sql += " WHERE itemID NOT IN (" + linkSQL + ")";
}
yield Zotero.DB.queryAsync(sql);
if (skipLinkedURLs) {
yield this.purgeUnusedWords();
}
else {
yield Zotero.DB.queryAsync("DELETE FROM fulltextWords");
}
yield clearCacheFiles();
}.bind(this));
}
/*
* Clears cache file for an item
*/
var clearCacheFile = Zotero.Promise.coroutine(function* (itemID) {
var item = yield Zotero.Items.getAsync(itemID);
if (!item) {
return;
}
if (!item.isAttachment()) {
Zotero.debug("Item " + itemID + " is not an attachment in Zotero.Fulltext.clearCacheFile()");
return;
}
Zotero.debug('Clearing full-text cache file for item ' + itemID);
var cacheFile = Zotero.Fulltext.getItemCacheFile(item);
if (cacheFile.exists()) {
try {
cacheFile.remove(false);
}
catch (e) {
Zotero.File.checkFileAccessError(e, cacheFile, 'delete');
}
}
});
/*
* Clear cache files for all attachments
*/
var clearCacheFiles = Zotero.Promise.coroutine(function* (skipLinkedURLs) {
var sql = "SELECT itemID FROM itemAttachments";
if (skipLinkedURLs) {
sql += " WHERE linkMode != " + Zotero.Attachments.LINK_MODE_LINKED_URL;
}
var items = yield Zotero.DB.columnQueryAsync(sql);
for (var i=0; i<items.length; i++) {
yield clearCacheFile(items[i]);
}
});
/*
function clearItemContent(itemID){
Zotero.DB.query("DELETE FROM fulltextContent WHERE itemID=" + itemID);
}
*/
/**
* @return {Promise}
*/
this.purgeUnusedWords = Zotero.Promise.coroutine(function* () {
if (!Zotero.Prefs.get('purge.fulltext')) {
return;
}
var sql = "DELETE FROM fulltextWords WHERE wordID NOT IN "
+ "(SELECT wordID FROM fulltextItemWords)";
yield Zotero.DB.queryAsync(sql);
Zotero.Prefs.set('purge.fulltext', false)
});
/**
* Convert HTML to text for an item and cache the result
*
* @return {Promise}
*/
var convertItemHTMLToText = Zotero.Promise.coroutine(function* (itemID, html, maxLength) {
// Split elements to avoid word concatentation
html = html.replace(/>/g, '> ');
var text = HTMLToText(html);
var totalChars = text.length;
if (maxLength) {
text = text.substr(0, maxLength);
}
// Write the converted text to a cache file
var item = yield Zotero.Items.getAsync(itemID);
var cacheFile = Zotero.Fulltext.getItemCacheFile(item).path;
Zotero.debug("Writing converted full-text HTML content to " + cacheFile);
if (!(yield OS.File.exists(OS.Path.dirname(cacheFile)))) {
yield Zotero.Attachments.createDirectoryForItem(item);
}
yield Zotero.File.putContentsAsync(cacheFile, text)
.catch(function (e) {
Zotero.debug(e, 1);
Components.utils.reportError(e);
});
return {
text: text,
totalChars: totalChars
};
});
function HTMLToText(html) {
var nsIFC = Components.classes['@mozilla.org/widget/htmlformatconverter;1']
.createInstance(Components.interfaces.nsIFormatConverter);
var from = Components.classes['@mozilla.org/supports-string;1']
.createInstance(Components.interfaces.nsISupportsString);
from.data = html;
var to = { value: null };
try {
nsIFC.convert('text/html', from, from.toString().length, 'text/unicode', to, {});
to = to.value.QueryInterface(Components.interfaces.nsISupportsString);
return to.toString();
}
catch(e) {
Zotero.debug(e, 1);
return html;
}
}
/**
* @param {String} text
* @param {String} [charset]
* @return {Array<String>}
*/
this.semanticSplitter = function (text, charset) {
if (!text){
Zotero.debug('No text to index');
return [];
}
try {
if (charset && charset != 'utf-8') {
text = this.decoder.convertStringToUTF8(text, charset, true);
}
} catch (err) {
Zotero.debug("Error converting from charset " + charset, 1);
Zotero.debug(err, 1);
}
var words = {};
var word = '';
var cclass = null;
var strlen = text.length;
for (var i = 0; i < strlen; i++) {
var charCode = text.charCodeAt(i);
var cc = null;
// Adjustments
if (charCode == 8216 || charCode == 8217) {
// Curly quotes to straight
var c = "'";
}
else {
var c = text.charAt(i);
}
// Consider single quote in the middle of a word a letter
if (c == "'" && word !== '') {
cc = kWbClassAlphaLetter;
}
if (!cc) {
cc = getClass(c, charCode);
}
// When we reach space or punctuation, store the previous word if there is one
if (cc == kWbClassSpace || cc == kWbClassPunct) {
if (word != '') {
words[word] = true;
word = '';
}
// When we reach Han character, store previous word and add Han character
} else if (cc == kWbClassHanLetter) {
if (word !== '') {
words[word] = true;
word = '';
}
words[c] = true;
// Otherwise, if character class hasn't changed, keep adding characters to previous word
} else if (cc == cclass) {
word += c.toLowerCase();
// If character class is different, store previous word and start new word
} else {
if (word !== '') {
words[word] = true;
}
word = c.toLowerCase();
}
cclass = cc;
}
if (word !== '') {
words[word] = true;
}
return Object.keys(words).map(function (w) {
// Trim trailing single quotes
if (w.slice(-1) == "'") {
w = w.substr(0, w.length - 1);
}
return w;
});
}
function _getScriptExtension() {
return Zotero.isWin ? 'vbs' : 'sh';
}
}