colrev.package_manager.package_base_classes.SearchSourcePackageBaseClass

class SearchSourcePackageBaseClass(*, source_operation, settings=None)

Bases: ABC

The base class for SearchSource packages

The following cli commands call specific methods of a SearchSource package:

colrev search --add package_name -> calls package.add_endpoint()

colrev search -> calls search operation -> calls package.search()

colrev load -> calls load operation -> calls package.load()

colrev prep -> calls prep operation -> calls package.prep()

Methods

add_endpoint	Add the SearchSource as an endpoint.
ensure_append_only	Ensure that the SearchSource is append-only.
heuristic	Heuristic to identify which SearchSource a search file belongs to.
load	Load records from the SearchSource.
prep_link_md	Retrieve masterdata from the SearchSource.
prepare	Run the custom source-prep operation.
search	Run a search of the SearchSource.

Attributes

ci_supported
settings_class
source_identifier
search_types
heuristic_status
search_source

abstract classmethod add_endpoint(operation, params)

Add the SearchSource as an endpoint.

Return type:

SearchSource

classmethod ensure_append_only(filename)

Ensure that the SearchSource is append-only.

Return type:

bool

abstract classmethod heuristic(filename, data)

Heuristic to identify which SearchSource a search file belongs to.

Return type:

dict

abstract classmethod load(*, filename, logger)

Load records from the SearchSource.

Return type:

dict

abstract prep_link_md(prep_operation, record, save_feed=True, timeout=10)

Retrieve masterdata from the SearchSource.

Return type:

Record

abstract prepare(record, source)

Run the custom source-prep operation.

Return type:

Record

abstract search(rerun)

Run a search of the SearchSource.

Return type:

None