swh.lister.phabricator.lister module

class swh.lister.phabricator.lister.PhabricatorLister(scheduler: SchedulerInterface, url: str, instance: str | None = None, api_token: str | None = None, credentials: Dict[str, Dict[str, List[Dict[str, str]]]] | None = None, max_origins_per_page: int | None = None, max_pages: int | None = None, enable_origins: bool = True)

Bases: StatelessLister[List[Dict[str, Any]]]

List all repositories hosted on a Phabricator instance.

Parameters:

• url – base URL of a phabricator forge (for instance https://forge.softwareheritage.org)

• instance – string identifier for the listed forge, URL network location will be used if not provided

• api_token – authentication token for Conduit API

LISTER_NAME: str = 'phabricator'

API_REPOSITORY_PATH = '/api/diffusion.repository.search'

get_request_params(after: str | None) → Dict[str, str]

Get the query parameters for the request.

static filter_params(params: Dict[str, str]) → Dict[str, str]

Filter the parameters for debug purposes

get_pages() → Iterator[List[Dict[str, Any]]]

Retrieve a list of pages of listed results. This is the main loop of the lister.

Returns:

an iterator of raw pages fetched from the platform currently being listed.

get_origins_from_page(page: List[Dict[str, Any]]) → Iterator[ListedOrigin]

Extract a list of model.ListedOrigin from a raw page of results.

Parameters:

page – a single page of results

Returns:

an iterator for the origins present on the given page of results

swh.lister.phabricator.lister.get_repo_url(attachments: List[Dict[str, Any]]) → str | None

Return url for a hosted repository from its uris attachments according to the following priority lists: * protocol: https > http * identifier: shortname > callsign > id