Register a mock route.

Get user items.

Set request parameters. Will always add the user ID if it hasn't been specifically set by an API method.

Build a valid URL from base, path, and optional query parameters. This avoids string concatenation errors and leading/trailing slash issues.

Get the last recorded request.

Return the requested test document

Wait if backoff is active.

Build a local-mode Zotero client using the locale from the CLI context.

Parse body as JSON.

Serialise an object to a JSON string.

File upload functionality. Goes through upload steps 0 - 3 (private class methods), and returns a dict noting success, failure, or un

Add URL parameters. Also ensure that only valid format/content combinations are requested.

Get a Zotero client configured for local access.

Raise on HTTP error and record any server-supplied backoff. Centralises the post-request pattern used by every method that performs a

Get a specific item.

Return a JSON-encoded error message.

Create new Zotero items. Accepts the following arguments: payload: a list containing one or more item dicts parentid:

Get tags.

Get user top-level items.

Get a specific item's child items.

Format a Semantic Scholar paper for output. Args: paper: Normalised paper dict from semantic_scholar module in_library: Boolean i

Return a unique 32-char write-token.

Create attachments. Accepts a list of one or more attachment template dicts and an optional parent Item ID. If this is specified,

Add a retrieved template to the cache for 304 checking. Accepts a dict and key name, adds the retrieval time, and adds both to self.t

Raise on HTTP error and record any server-supplied backoff.

Normalise paper data from Semantic Scholar to a consistent format. Args: paper_data: Raw paper data from the API Returns: No

Retrieve Zotero items via the API. Combine endpoint and request to access the specific resource. Returns a JSON document.

Set backoff expiration time.

Remove the leading '/api' substring from urls if running in local mode.

Annotate papers with in_library status based on DOI matching. Args: papers: List of normalised paper dicts doi_map: Dict mapping

Build a mapping of normalised DOIs to Zotero item keys.

Get user collections.

Create new Zotero collections. Accepts one argument, a list of dicts containing the following keys: 'name': the name of the collectio

Retrieve all items in the library for a particular query. This method will override the 'limit' parameter if it's been set.

Extract backoff duration from response headers. The Zotero API may return backoff instructions via either the 'Backoff' or 'Retry-After' head

Make an HTTP GET request to the Semantic Scholar API. Args: url: The full URL to request params: Optional dict of query parameter

Drive the shared Semantic-Scholar-by-DOI lookup flow. Fetches papers via ``lookup(doi, id_type="doi", limit=limit)``, applies the ``min_citat

Drive the shared Semantic-Scholar-by-DOI lookup flow and return JSON. Fetches papers via ``lookup(doi, id_type="doi", limit=limit)``, applies

General method for returning total counts.

Build a mapping of normalised DOIs to Zotero item keys and original DOIs. Returns: Dict mapping normalised DOIs to dicts with 'key' and '

Check that items to be created contain no invalid dict keys. Accepts a single argument: a list of one or more dicts. The retrieved fi

Yield successive n-sized chunks from an iterable.

Get user collection.

Get a specific collection's tags.

Error handler for HTTP requests. Raises an appropriate PyZoteroError subclass for the response status code. HTTP 429 responses are a special

Return the result of the call to the URL in the 'Next' link.

Flatten Zotero creator dicts to display strings. Zotero creators may carry either (firstName, lastName) or a single ``name`` field; emit ``"<

Retrieve a subset of items. Accepts a single argument: a list of item IDs.

Get a template for a new item.

Get all recorded requests.

Normalise a DOI for case-insensitive matching. Strips common prefixes (https://doi.org/, http://doi.org/, doi:) and converts to lowercase. DO

Update an existing item. Accepts one argument, a dict containing Item data.

Return a new attachment template of the required type. Types: imported_file, imported_url, linked_file, linked_url

POST a payload to the library in chunks of DEFAULT_NUM_ITEMS. ``collection`` is the last path segment (e.g. ``"items"`` or ``"collect

Check HTTP response and raise appropriate exceptions. Args: response: httpx Response object Raises: RateLimitError: If rate

Dispatch a DELETE against one or many entities of the same type. ``collection`` is the path segment (e.g. ``"items"``); ``key_param``

Return a nicely-formatted error message for an HTTP response.

Format a paper identifier for the Semantic Scholar API. Semantic Scholar accepts various identifier formats: - DOI: DOI:10.1234/example -

Fetch a paper-list endpoint (``.../citations`` or ``.../references``). Both endpoints return ``{"data": [{<wrapper_key>: {...}}, ...], ...}``;

Drive Zupload.upload through to the register step and return that request. _get_auth is mocked to return valid auth data and the storage (S3)

Format and return data from API calls which return Tags.

Call to see if a template request returns 304. Accepts: - a string to combine with the API endpoint - a dict of format values

Add child attachments using title, filename. Args: files: One or more lists or tuples containing (title, file path).

Add attachments using filenames as title. Args: files: One or more file paths to add as attachments. parentid: Option

Get a specific collection's items.

Get a specific collection's top-level items.

Copy a specific PDF attachment from Zotero library to specified folder using dump() Args: item_id (str): Zotero item ID outp

Return headers that are always OK to include.

Delete Items from a Zotero library. Accepts a single argument: a dict containing item data OR a list of dicts contain

Get the file from a specific item.

Filter a list of papers by minimum citation count. Args: papers: List of normalised paper dicts min_citations: Minimum citation c

Get full-text content for an item.

Get all available link mode types. Note: No viable REST API route was found for this, so I tested and built a list from documentation

Get all available item fields.

Get all available item types.

Return a generator of func's results.

Return the contents of My Publications.

Search for papers by keyword query. Args: query: Search query string limit: Maximum number of results (default 100, max 100)

Update a Zotero collection property such as 'name'. Accepts one argument, a dict containing collection data retrieved using e.g. 'col

Check a url path query fragment for a specific query parameter.

Remove keys we added for internal use.

Step 0: Register intent to upload files.

Extract self, first, next, last links from a request response.

Extract the single file from a Zotero-compressed attachment response. The Zotero API zips plain-text attachments when the redirect carries the

Step 1: get upload authorisation for a file.

Create a mock Zotero client.

Parse a BibTeX response body into a BibDatabase.

Step 3: upload successful, so register it. For a new file we send ``If-None-Match: *``; when replacing an existing file's contents we

Step 2: auth successful, and file not on server. See zotero.org/support/dev/server_api/file_upload#a_full_upload reg_key and md5 are

Validate saved search conditions. Raises an error if any contain invalid operators.

Ensure that all files to be attached exist. open()'s better than exists(), cos it avoids a race condition.

Add item to a collection. Accepts two arguments: The collection ID, and an item dict.

Return dict associating collection keys to versions. Accepts a since= parameter in kwargs to limit the data to those updated since.

Get subcollections for a specific collection.