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

  • [x] Local
  • [x] United Kingdom Parliament
  • [x] Scottish Parliament
  • [x] National Assembly for Wales
  • [x] Northern Ireland Assembly
  • [x] Mayoral
  • [x] Mayoral (London)
  • [x] European Parliament
  • [x] Greater London Assembly
  • [x] 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.

Files for sopn-publish-date, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size sopn-publish-date-1.1.0.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page