Skip to main content

Parse ward lists from Electoral Change Orders on http://www.legislation.gov.uk/

Project description

ECO Parser

Build Status Coverage Status PyPI Version License Python Support Code style: black

Parse ward lists from Electoral Change Orders on http://www.legislation.gov.uk/

What does this package do?

This package solves a very specific problem.

Local Government electoral divisions/wards in the UK are defined by a piece of legislation called an Electoral Change Order. An Electoral Change Order (ECO) always comes into force the day before the first election which is held using the boundaries it defines. Once this first election has happened, details of the new divisions are fairly easy to get hold of. They are published as machine-readable structured data by organisations like Ordnance Survey and the Office for National Statistics. If you need information about divisions that have already been used for one or more elections, use one of these sources. In that situation, this tool is probably the least useful route to the information you want.

In the case where we need to talk about local electoral divisions which have been defined by an ECO but which have not yet been used in an election (i.e: the ECO has been made, but has not yet come into force), the only source for the division names is the ECO legislation itself.

This package provides some routines to help with parsing ward and division names from the legislation.gov.uk's XML API outputs (which are semi-structured). It is early days, so there are probably going to be some formats we don't support yet. If you find one in new or recent legislation, raise an issue.

TL;DR

If you need the official names of electoral divisions that are already in use, get the data from OS Boundary Line, ONS Geography or a web service like mapit. This information is already published as convenient machine-readable structured data.

If you need the official names of electoral divisions that are not in use yet, this package can help you parse them from legislation.

Installation

pip install eco-parser

Usage

On the console

eco_parser "http://www.legislation.gov.uk/uksi/2017/1067/schedule/1/made/data.xml" > out.csv

As a library

from eco_parser import EcoParser, ParseError

p = EcoParser("http://www.legislation.gov.uk/uksi/2017/1067/schedule/1/made/data.xml")

try:
    result = p.parse()
except ParseError:
    raise

Licensing

The eco-parser software is made available under the MIT License.

Data Parsed from legislation.gov.uk is covered by the Open Government Licence v3. Your use of the data should comply with it.

Development

Run the tests locally:

./run_tests.py

Build package locally:

./build.sh

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

eco_parser-0.2.0.tar.gz (5.1 kB view details)

Uploaded Source

File details

Details for the file eco_parser-0.2.0.tar.gz.

File metadata

  • Download URL: eco_parser-0.2.0.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.6.8

File hashes

Hashes for eco_parser-0.2.0.tar.gz
Algorithm Hash digest
SHA256 d1b6c73b4817e27710111da2b495012e08ef9c7d67707c6793c9e344936750be
MD5 0bad4f5d1cbcf9993241b8c618913749
BLAKE2b-256 019631eb66479f0c0602d4dac3add722f15af37d2b8c6548eb331547044439b0

See more details on using hashes here.

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