colrev.exceptions

Exceptions of CoLRev.

Exceptions

AppendOnlyViolation(msg)

Invalid changes to a file in append-only mode.

CleanRepoRequiredError(changedFiles, ...)

A clean git repository would be required.

CoLRevException

Base class for all exceptions raised by this package

CoLRevUpgradeError(old, new)

The version of the local CoLRev package does not match with the CoLRev version used to create the latest commit in the project.

CorrectionPreconditionException(message)

Precondition for corrections not given (clean git repository).

CuratedOutletNotUnique([msg])

The outlets (journals or conferences) with curated metadata are not unique.

DataException(*, msg)

Exception in the data operation

DedupeError(message)

An exception in the dedupe operation

DependencyConfigurationError(dep)

The required dependency is not configured correctly.

DirtyRepoAfterProcessingError(msg)

The git repository was not clean after completing the operation.

DuplicateIDsError(msg)

Duplicate IDs were detected.

FieldValueError(msg)

An error in field values was detected (in the main records).

GitConflictError(path)

There are git conflicts to be resolved before resuming operations.

GitNotAvailableError()

Git is currently not available.

ImportException(msg)

An error occured in the import functions.

InvalidLanguageCodeException(...)

Language code field does not comply with the required standard.

InvalidPDFException(path)

The PDF is invalid (empty, encrypted or broken).

InvalidQueryException(msg)

The query format is not valid.

InvalidSettingsError(*, msg[, fix_per_upgrade])

Invalid value in SETTINGS_FILE.

MissingDependencyError(dep)

The required dependency is not available.

MissingRecordQualityRuleSpecification(msg)

A quality rule is missing.

NoRecordsError()

The operation cannot be started because no records have been imported yet.

NoRecordsToImport(msg)

No records to import.

NonEmptyDirectoryError(*, filepath, content)

Trying to initialize CoLRev in a non-empty directory.

NotEnoughDataToIdentifyException(*[, msg, ...])

The meta-data is not sufficiently complete to identify the record.

NotFeedIdentifiableException([msg])

The record does not contain the required source_identifier (cannot be added to the feed).

NotTOCIdentifiableException([msg])

The record cannot be identified through table-of-contents.

OriginError(msg)

An error in the colrev_origin field values was detected.

PDFHashError(path)

An error occurred during PDF hashing.

PackageParameterError(dep)

The parameter for the package are not correct.

PackageSettingMustStartWithPackagesException(...)

package settings must start with packages key

ParameterError(*, parameter, value, options)

An invalid parameter was passed to CoLRev.

PortAlreadyRegisteredException(message)

The port (localhost) is already registered.

ProcessOrderViolation(operations_type, ...)

The process triggered dooes not have priority

PropagatedIDChange(notifications)

Changes in propagated records ID detected.

RecordNotFoundException(msg)

Record not found in the main records file.

RecordNotFoundInPrepSourceException(*, msg)

The record was not found in the prep search source.

RecordNotInIndexException(record_id)

The requested record was not found in the LocalIndex.

RecordNotInRepoException(record_id)

The record was not found in the main records.

RecordNotInTOCException(*, record_id, toc_key)

The record is not part of the table-of-contents (TOC).

RecordNotIndexableException([record_id, ...])

The requested record could not be added to the LocalIndex.

RecordNotParsableException(msg)

The record could not be parsed.

RepoInitError(*, msg)

Error during initialization of CoLRev project.

RepoSetupError([msg])

The project files are not properly set up as a CoLRev project.

ReviewManagerNotNotifiedError()

The ReviewManager was not notified about the operation.

SearchNotAutomated(msg)

The search cannot be completed automatically.

SearchSourceException(msg)

Records cannot be retrieved from the SearchSource.

ServiceNotAvailableException(dep[, ...])

An environment service is not available.

StatusFieldValueError(record, status_type, ...)

An error in the status field values was detected.

StatusTransitionError(msg)

An invalid status transition was observed

TEIException

An exception related to the TEI format

TEITimeoutException

A timeout occurred during TEI generation

TOCNotAvailableException([msg])

Tables of contents (toc) are not available for the requested item.

TemplateNotAvailableError(template_path)

The requested template is not available.

UnstagedGitChangesError(changedFiles)

Unstaged git changes were found although a clean repository is required.

UnsupportedImportFormatError(import_path)

The file format is not supported.