Skip to content

easy.list_representatives: a dataflow's countries as a table - #12

Merged
nikolaos-paximadakis-eea merged 1 commit into
mainfrom
feat/list-representatives
Nov 21, 2026
Merged

nikolaos-paximadakis-eea merged 1 commit into
mainfrom
feat/list-representatives

Conversation

@nikolaos-paximadakis-eea

Copy link
Copy Markdown
Collaborator

Adds easy.list_representatives(client, dataflow_id, *, include_contacts=False).

  • One row per representative: representative_id, provider_id, code, label, lead_reporters (count), has_datasets, receipt_downloaded, receipt_outdated, restrict_from_public.
  • Country code and name are joined from the provider listing: one data_providers(group) call per provider group, then data_provider(id) for any provider not in its group's list.
  • Lead reporter email addresses are personal data, so they are left out unless include_contacts=True, which adds a lead_reporter_emails list column.
  • Empty dataflow gives an empty table with the columns; a 403 gets the usual id-mixup hint.

Also: easy.guide() line, glossary entry, updated live-tested note on representative.representatives, regenerated reference docs, CHANGELOG (Unreleased).

Testing: 5 new mocked tests (full suite 521 passed, ruff and mypy clean). Checked live, read-only, with a Bearer token on a sandbox dataflow that has one representative: correct country, lead reporter count 1, no email in the default table, one address with include_contacts=True.

One row per representative with the country code and name joined from
the provider listing (one lookup per provider group, then per stray
provider id). Lead reporter emails are personal data, so they are left
out unless include_contacts=True. Checked live read-only on a sandbox
dataflow with one representative (Bearer). Also in easy.guide(), the
glossary, the representatives caveat and the changelog.
@nikolaos-paximadakis-eea
nikolaos-paximadakis-eea merged commit 4328932 into main Nov 21, 2026
6 checks passed
@nikolaos-paximadakis-eea
nikolaos-paximadakis-eea deleted the feat/list-representatives branch November 21, 2026 22:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant