Skip to main content

Derive publish dates of Statements of Persons Nominated for UK elections

Project description


Build Status Documentation Status PyPI Code style: black

Given the polling day of an election in the UK, when should the Statement of Persons Nominated (SoPN) be published?

When an election is called in the United Kingdom, the voting public must have access to the list of candidates who have been nominated to that post.

These documents are called Statements of Persons Nominated, and must be published a set number of working days ahead of the actual election date. The number varies based on:

  • Type of Post - Parliamentary, Local, devolved Government, etc.
  • Country - The United Kingdom has up to four different rules for the same type of election, one for each country.
  • Calendar - each country has their own unique set of Bank Holidays.

This library encapsulates timetable legislation for elections run in the United Kingdom and its devolved administrations.


from sopn_publish_date import StatementPublishDate
from datetime import date

publish_date = StatementPublishDate()

print(publish_date.national_assembly_for_wales(date(2016, 5, 5)))

#, 4, 7)


Hosted by readthedocs at


pip install sopn_publish_date


python -m pytest -v

Supported Election Types

  • Local
  • United Kingdom Parliament
  • Scottish Parliament
  • National Assembly for Wales
  • Northern Ireland Assembly
  • Mayoral
  • Mayoral (London)
  • European Parliament
  • Greater London Assembly
  • Police and Crime commissioner

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sopn-publish-date-1.1.0.tar.gz (8.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page