/*
* Copyright (C) 2013 Emeric Poupon
*
* This file is part of LMS.
*
* LMS is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* LMS 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with LMS. If not, see .
*/
#include "ScannerService.hpp"
#include
#include
#include "core/IConfig.hpp"
#include "core/IJobScheduler.hpp"
#include "core/ILogger.hpp"
#include "core/ITraceLogger.hpp"
#include "database/Session.hpp"
#include "database/objects/MediaLibrary.hpp"
#include "database/objects/ScanSettings.hpp"
#include "scanners/ImageFileScanner.hpp"
#include "scanners/artistinfo/ArtistInfoFileScanner.hpp"
#include "scanners/audiofile/AudioFileScanner.hpp"
#include "scanners/lyrics/LyricsFileScanner.hpp"
#include "scanners/playlist/PlayListFileScanner.hpp"
#include "steps/ScanStepArtistReconciliation.hpp"
#include "steps/ScanStepAssociateArtistImages.hpp"
#include "steps/ScanStepAssociateExternalLyrics.hpp"
#include "steps/ScanStepAssociateMediumImages.hpp"
#include "steps/ScanStepAssociatePlayListTracks.hpp"
#include "steps/ScanStepAssociateReleaseImages.hpp"
#include "steps/ScanStepAssociateTrackImages.hpp"
#include "steps/ScanStepCheckForDuplicatedFiles.hpp"
#include "steps/ScanStepCheckForRemovedFiles.hpp"
#include "steps/ScanStepCompact.hpp"
#include "steps/ScanStepComputeClusterStats.hpp"
#include "steps/ScanStepOptimize.hpp"
#include "steps/ScanStepRemoveOrphanedDbEntries.hpp"
#include "steps/ScanStepScanFiles.hpp"
#include "steps/ScanStepUpdateLibraryFields.hpp"
#include "ScanContext.hpp"
namespace lms::scanner
{
using namespace db;
namespace
{
constexpr std::string_view currentSettingsName{};
constexpr std::string_view lastScanSettingsName{ "last_scan" };
Wt::WDate getNextMonday(Wt::WDate current)
{
do
{
current = current.addDays(1);
} while (current.dayOfWeek() != 1);
return current;
}
Wt::WDate getNextFirstOfMonth(Wt::WDate current)
{
do
{
current = current.addDays(1);
} while (current.day() != 1);
return current;
}
std::optional readScannerSettings(db::Session& session, std::string_view name)
{
std::optional settings;
auto transaction{ session.createReadTransaction() };
const ScanSettings::pointer scanSettings{ ScanSettings::find(session, name) };
if (!scanSettings)
return settings;
settings.emplace();
settings->audioScanVersion = scanSettings->getAudioScanVersion();
settings->artistInfoScanVersion = scanSettings->getArtistInfoScanVersion();
settings->startTime = scanSettings->getUpdateStartTime();
settings->updatePeriod = scanSettings->getUpdatePeriod();
MediaLibrary::find(session, [&](const MediaLibrary::pointer& mediaLibrary) {
MediaLibraryInfo info;
info.firstScan = mediaLibrary->isEmpty();
info.id = mediaLibrary->getId();
info.rootDirectory = mediaLibrary->getPath().lexically_normal();
settings->mediaLibraries.push_back(info);
});
{
const auto& tags{ scanSettings->getExtraTagsToScan() };
std::transform(std::cbegin(tags), std::cend(tags), std::back_inserter(settings->extraTags), [](std::string_view tag) { return std::string{ tag }; });
}
settings->artistTagDelimiters = scanSettings->getArtistTagDelimiters();
settings->defaultTagDelimiters = scanSettings->getDefaultTagDelimiters();
settings->artistsToNotSplit = scanSettings->getArtistsToNotSplit();
settings->skipSingleReleasePlayLists = scanSettings->getSkipSingleReleasePlayLists();
settings->allowArtistMBIDFallback = scanSettings->getAllowMBIDArtistMerge();
settings->artistImageFallbackToRelease = scanSettings->getArtistImageFallbackToReleaseField();
// TODO, store this in DB + expose in UI
settings->skipDuplicateTrackMBID = core::Service::get()->getBool("scanner-skip-duplicate-mbid", false);
return settings;
}
void writeScannerSettings(db::Session& session, std::string_view name, const ScannerSettings& settings)
{
auto transaction{ session.createWriteTransaction() };
ScanSettings::pointer scanSettings{ ScanSettings::find(session, name) };
if (!scanSettings)
scanSettings = session.create(name);
scanSettings.modify()->setAllowMBIDArtistMerge(settings.allowArtistMBIDFallback);
scanSettings.modify()->setSkipSingleReleasePlayLists(settings.skipSingleReleasePlayLists);
// TODO add more fields
}
std::size_t getScannerThreadCount()
{
std::size_t threadCount{ core::Service::get()->getULong("scanner-thread-count", 0) };
if (threadCount == 0)
threadCount = std::max(std::thread::hardware_concurrency() / 2, 1);
return threadCount;
}
} // namespace
std::unique_ptr createScannerService(db::IDb& db, const std::filesystem::path& cachePath)
{
return std::make_unique(db, cachePath);
}
ScannerService::ScannerService(db::IDb& db, const std::filesystem::path& cachePath)
: _db{ db }
, _jobScheduler{ core::createJobScheduler("Scanner", getScannerThreadCount()) }
, _cachePath{ cachePath }
{
_ioService.setThreadCount(1);
LMS_LOG(DBUPDATER, INFO, "Using " << _jobScheduler->getThreadCount() << " thread(s) for jobs");
_jobScheduler->setShouldAbortCallback([this]() { return _abortScan; });
std::size_t totalFileCount{};
{
auto& session{ _db.getTLSSession() };
auto transaction{ session.createReadTransaction() };
totalFileCount = session.getFileStats().getTotalFileCount();
}
// Force optimize in case scanner aborted during a large import, but do this only if there are enough elements in the database
// Otherwise, indexes may be not used and queries may be slower and slower while adding more and more elements in the db
LMS_LOG(DBUPDATER, INFO, "Scanned file count = " << totalFileCount);
if (totalFileCount >= 1'000)
_db.getTLSSession().fullAnalyze();
refreshTracingLoggerStats();
refreshScanSettings();
start();
}
ScannerService::~ScannerService()
{
LMS_LOG(DBUPDATER, INFO, "Stopping service...");
stop();
LMS_LOG(DBUPDATER, INFO, "Service stopped!");
}
void ScannerService::start()
{
std::scoped_lock lock{ _controlMutex };
_ioService.post([this] {
if (_abortScan)
return;
scheduleNextScan();
});
_ioService.start();
}
void ScannerService::stop()
{
std::scoped_lock lock{ _controlMutex };
_abortScan = true;
_scheduleTimer.cancel();
_ioService.stop();
}
void ScannerService::abortScan()
{
bool isRunning{};
{
std::scoped_lock lock{ _statusMutex };
isRunning = _curState == State::InProgress;
}
LMS_LOG(DBUPDATER, DEBUG, "Aborting scan...");
std::scoped_lock lock{ _controlMutex };
LMS_LOG(DBUPDATER, DEBUG, "Waiting for the scan to abort...");
_abortScan = true;
_scheduleTimer.cancel();
_ioService.stop();
LMS_LOG(DBUPDATER, DEBUG, "Scan abort done!");
_abortScan = false;
_ioService.start();
if (isRunning)
_events.scanAborted.emit();
}
void ScannerService::requestImmediateScan(const ScanOptions& scanOptions)
{
abortScan();
_ioService.post([this, scanOptions] {
if (_abortScan)
return;
scheduleScan(scanOptions);
});
}
void ScannerService::requestReload()
{
abortScan();
_ioService.post([this]() {
if (_abortScan)
return;
scheduleNextScan();
});
}
ScannerService::Status ScannerService::getStatus() const
{
Status res;
std::shared_lock lock{ _statusMutex };
res.currentState = _curState;
res.nextScheduledScan = _nextScheduledScan;
res.lastCompleteScanStats = _lastCompleteScanStats;
res.currentScanStepStats = _currentScanStepStats;
return res;
}
void ScannerService::scheduleNextScan()
{
LMS_LOG(DBUPDATER, DEBUG, "Scheduling next scan");
refreshScanSettings();
const Wt::WDateTime now{ Wt::WDateTime::currentDateTime() };
Wt::WDateTime nextScanDateTime;
switch (_settings.updatePeriod)
{
case ScanSettings::UpdatePeriod::Daily:
if (now.time() < _settings.startTime)
nextScanDateTime = { now.date(), _settings.startTime };
else
nextScanDateTime = { now.date().addDays(1), _settings.startTime };
break;
case ScanSettings::UpdatePeriod::Weekly:
if (now.time() < _settings.startTime && now.date().dayOfWeek() == 1)
nextScanDateTime = { now.date(), _settings.startTime };
else
nextScanDateTime = { getNextMonday(now.date()), _settings.startTime };
break;
case ScanSettings::UpdatePeriod::Monthly:
if (now.time() < _settings.startTime && now.date().day() == 1)
nextScanDateTime = { now.date(), _settings.startTime };
else
nextScanDateTime = { getNextFirstOfMonth(now.date()), _settings.startTime };
break;
case ScanSettings::UpdatePeriod::Hourly:
nextScanDateTime = { now.date(), now.time().addSecs(3600) };
break;
case ScanSettings::UpdatePeriod::Never:
LMS_LOG(DBUPDATER, INFO, "Auto scan disabled!");
break;
}
if (nextScanDateTime.isValid())
scheduleScan(ScanOptions{}, nextScanDateTime);
{
std::unique_lock lock{ _statusMutex };
_curState = nextScanDateTime.isValid() ? State::Scheduled : State::NotScheduled;
_nextScheduledScan = nextScanDateTime;
}
_events.scanScheduled.emit(_nextScheduledScan);
}
void ScannerService::scheduleScan(const ScanOptions& scanOptions, const Wt::WDateTime& dateTime)
{
auto cb{ [this, scanOptions](boost::system::error_code ec) {
if (ec)
return;
scan(scanOptions);
} };
if (dateTime.isNull())
{
LMS_LOG(DBUPDATER, INFO, "Scheduling next scan right now");
_scheduleTimer.expires_after(std::chrono::seconds{ 0 });
_scheduleTimer.async_wait(cb);
}
else
{
std::chrono::system_clock::time_point timePoint{ dateTime.toTimePoint() };
std::time_t t{ std::chrono::system_clock::to_time_t(timePoint) };
char ctimeStr[26];
LMS_LOG(DBUPDATER, INFO, "Scheduling next scan at " << std::string(::ctime_r(&t, ctimeStr)));
_scheduleTimer.expires_at(timePoint);
_scheduleTimer.async_wait(cb);
}
}
void ScannerService::scan(const ScanOptions& scanOptions)
{
LMS_SCOPED_TRACE_OVERVIEW("Scanner", "Scan");
_events.scanStarted.emit();
{
std::unique_lock lock{ _statusMutex };
_nextScheduledScan = {};
}
LMS_LOG(UI, INFO, "New scan started!");
refreshScanSettings();
ScanContext scanContext;
scanContext.scanOptions = scanOptions;
ScanStats& stats{ scanContext.stats };
stats.startTime = Wt::WDateTime::currentDateTime();
processScanSteps(scanContext);
{
std::unique_lock lock{ _statusMutex };
_curState = State::NotScheduled;
_currentScanStepStats.reset(); // must be sync with _curState
}
refreshTracingLoggerStats();
LMS_LOG(DBUPDATER, INFO, "Scan " << (_abortScan ? "aborted" : "complete") << ". Changes = " << stats.getChangesCount() << " (added = " << stats.additions << ", removed = " << stats.deletions << ", updated = " << stats.updates << ", failures = " << stats.failures << "), Not changed = " << stats.skips << ", Scanned = " << stats.scans << " (errors = " << stats.errorsCount << "), features fetched = " << stats.featuresFetched << ", duplicates = " << stats.duplicates.size());
{
auto transaction{ _db.getTLSSession().createReadTransaction() };
const db::FileStats stats{ _db.getTLSSession().getFileStats() };
LMS_LOG(DBUPDATER, INFO, stats.getTotalFileCount() << " total files: " << stats.artistInfoCount << " artist info, " << stats.imageCount << " images, " << stats.playListCount << " playlists, " << stats.trackCount << " tracks, " << stats.trackLyricsCount << " lyrics");
}
if (!_abortScan)
{
stats.stopTime = Wt::WDateTime::currentDateTime();
{
std::unique_lock lock{ _statusMutex };
_lastCompleteScanStats = stats;
}
// save current settings as last scan settings to compare during next scans if something changed
writeScannerSettings(_db.getTLSSession(), lastScanSettingsName, _settings);
_lastScanSettings = _settings;
LMS_LOG(DBUPDATER, DEBUG, "Scan not aborted, scheduling next scan!");
scheduleNextScan();
_events.scanComplete.emit(stats);
}
else
{
LMS_LOG(DBUPDATER, DEBUG, "Scan aborted, not scheduling next scan!");
}
}
void ScannerService::processScanSteps(ScanContext& context)
{
std::size_t stepIndex{};
for (auto& scanStep : _scanSteps)
{
context.currentStepStats = ScanStepStats{
.startTime = Wt::WDateTime::currentDateTime(),
.stepCount = _scanSteps.size(),
.stepIndex = stepIndex++,
.currentStep = scanStep->getStep(),
.totalElems = 0,
.processedElems = 0
};
if (_abortScan)
break;
if (!scanStep->needProcess(context))
{
LMS_LOG(DBUPDATER, DEBUG, "Skipping scan step '" << scanStep->getStepName() << "'");
continue;
}
{
LMS_SCOPED_TRACE_OVERVIEW("Scanner", scanStep->getStepName());
LMS_LOG(DBUPDATER, DEBUG, "Starting scan step '" << scanStep->getStepName() << "'");
notifyInProgress(context.currentStepStats);
scanStep->process(context);
notifyInProgress(context.currentStepStats);
LMS_LOG(DBUPDATER, DEBUG, "Completed scan step '" << scanStep->getStepName() << "'");
}
}
}
void ScannerService::refreshScanSettings()
{
std::optional newSettings{ readScannerSettings(_db.getTLSSession(), currentSettingsName) };
assert(newSettings.has_value());
if (_settings == *newSettings)
return;
LMS_LOG(DBUPDATER, DEBUG, "Scanner settings updated");
LMS_LOG(DBUPDATER, DEBUG, "Using audio scan version " << newSettings->audioScanVersion);
LMS_LOG(DBUPDATER, DEBUG, "Using artist info scan version " << newSettings->artistInfoScanVersion);
_settings = std::move(*newSettings);
if (!_lastScanSettings)
_lastScanSettings = readScannerSettings(_db.getTLSSession(), lastScanSettingsName);
auto progressFunc{ [this](const ScanStepStats& stats) {
notifyInProgressIfNeeded(stats);
} };
_fileScanners.clear();
_fileScanners.add(std::make_unique(_db, _settings));
_fileScanners.add(std::make_unique(_db, _settings));
_fileScanners.add(std::make_unique(_db, _settings));
_fileScanners.add(std::make_unique(_db, _settings));
_fileScanners.add(std::make_unique(_db, _settings));
_fileScanners.visit([](const IFileScanner& scanner) {
for (const std::filesystem::path& file : scanner.getSupportedFiles())
LMS_LOG(DBUPDATER, INFO, scanner.getName() << ": supporting file " << file);
for (const std::filesystem::path& extension : scanner.getSupportedExtensions())
LMS_LOG(DBUPDATER, INFO, scanner.getName() << ": supporting file extension " << extension);
});
ScanStepBase::InitParams params{
.jobScheduler = *_jobScheduler,
.settings = _settings,
.lastScanSettings = _lastScanSettings.has_value() ? &(_lastScanSettings.value()) : nullptr,
.progressCallback = progressFunc,
.abortScan = _abortScan,
.db = _db,
.fileScanners = _fileScanners,
.cachePath = _cachePath
};
// Order is important: steps are sequential
_scanSteps.clear();
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params)); // must come after ScanStepAssociateReleaseImages (because and artist image can fallback on a release image)
_scanSteps.emplace_back(std::make_unique(params)); // must come after ScanStepAssociateReleaseImages (because and medium image can fallback on a release image)
_scanSteps.emplace_back(std::make_unique(params)); // must come after ScanStepAssociateMediumImages and ScanStepAssociateReleaseImages (because and track image can fallback on a medium or release image)
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
_scanSteps.emplace_back(std::make_unique(params));
}
void ScannerService::notifyInProgress(const ScanStepStats& stepStats)
{
{
std::unique_lock lock{ _statusMutex };
_curState = State::InProgress;
_currentScanStepStats = stepStats;
}
const auto now{ std::chrono::steady_clock::now() };
_events.scanInProgress.emit(stepStats);
_lastScanInProgressEmit = now;
}
void ScannerService::notifyInProgressIfNeeded(const ScanStepStats& stepStats)
{
const auto now{ std::chrono::steady_clock::now() };
if (now - _lastScanInProgressEmit >= std::chrono::seconds{ 1 })
notifyInProgress(stepStats);
}
} // namespace lms::scanner