Extracts metadata from Canadian legal citations
Project description
legal_citation_parser v 0.4.1
Extracts metadata from Canadian legal citations and provides a basic CLI UI for the CanLII API.
Although legal citations are typically short strings, they contain a great deal of information compressed into a relatively small package. This Python module is designed to extract and standardize that data from from legal citation strings. This module can currently handles the following citation types:
- Neutral citations (Canadian);
- Supreme Court Reader (SCR) citations;
- CanLII citations.
Version 0.4.x is broadly focused on making the existing program more robust and user-friendly. Planned improvements include
- QoL improvements to the CanLII API functionality
- Improved error handling
- More robust testing
- Improved documentation
- Complete list of tribunals to complete court hierarchy and enable future hierarchical analysis
Version 0.4.1 begins by adding more updates to the court level dictionaries and fixing bugs with the existing court codes as they came up. Providing every decision with a court type should enable hierarchical analysis in the future. This version experiments with a few different ways to store and access this information in the canlii_constants.py file, with a winner to be determined at a future date.
Metadata
Basic citation string
The module currently extracts the following from raw CanLII citation strings:
- UID. The decision's unique ID. Corresponds to the CanLII API's
caseId
variable. - Atomic citation. The citation's human readable unique ID.
- Style of cause. The human readable case name.
- Citation type. The type of citation parsed.
- Year. The decision's year.
- Decision number. The decision's number.
- Jurisdiction. The province, territory, or federal jurisdiction the case was heard in.
- Court name. The human readable court level.
- Court level. The relative level of the court.
- CanLII URL. The decision's URL on canlii.org
CanLII API
The module is also able to use the CanLII API to retrieve additional metadata and other potentially useful case information, including:
- Short URL. The decision's short URL.
- Language. The decision's language or languages.
- Docket number. The decision's docket number or numbers.
- Decision date. The YYYY-MM-DD the court issued the decision.
- Keywords. A 'list' of keywords supplied by CanLII, separated by a '—'.
- Categories. A 'list' of categories supplied by CanLII, also separated by a '—'.
- Cases cited. A list of decisions (including databaseId, caseId, title, and citation) the case cites.
- Cases citing. A list of decisions (including databaseId, caseId, title, and citation) that cite the case.
Installation
pip
From the command line:
pip install legal_citation_parser
Usage
In Python 3.x:
>>> from legal_citation_parser import parse_citation
Kwargs
verify_url
: Pings a program-generatedlong_url
. If unsuccessful, the function checks the same URL with the alternative language selected (i.e., "fr" instead of "en", and vice versa). ReturnsNone
if neither URL ping successfully.metadata
: Retrieves CanLII metadata. Requires a CanLII API key.cited
: Returns a list of cases a decision cites. Requiees a CanLII API key.citing
: Returns a list of cases that cite the decision. Requires a CanLII API key.
Example calls
parse_citation("R v Sutherland, 2022 MBCA 23", verify_url=True, metadata=True)
Should produce:
{'uid': '2022mbca23',
'style_of_cause': 'R v Sutherland',
'atomic_citation': '2022 MBCA 23',
'citation_type': 'neutral',
'scr_citation': None,
'year': '2022',
'court': 'mbca',
'decision_number': '23',
'jurisdiction': 'mb',
'court_name': 'Court of Appeal of Manitoba',
'court_level': 'provincial appellate',
'long_url': 'https://www.canlii.org/en/mb/mbca/doc/2022/2022mbca23/2022mbca23.html',
'short_url': 'https://canlii.ca/t/jmnrg',
'language': 'en',
'docket_number': 'AR21-30-09591',
'decision_date': '2022-02-24',
'keywords': 'Criminal law — Murder — Second degree murder — Evidence — Admissibility',
'categories': 'Criminal or statutory infractions — Evidence — Practice and procedure'}
Example call:
parse_citation("R v Sutherland, 2022 MBCA 23", cited=True)
Should produce:
{'uid': '2022mbca23',
'style_of_cause': 'R v Sutherland',
'atomic_citation': '2022 MBCA 23',
'citation_type': 'neutral',
'scr_citation': None,
'year': '2022',
'court': 'mbca',
'decision_number': '23',
'jurisdiction': 'manitoba',
'court_name': 'Court of Appeal of Manitoba',
'court_level': 'provincial appellate',
'cited_cases': {'citedCases': [{'databaseId': 'csc-scc',
'caseId': {'en': '1956canlii541'},
'title': 'Chibok v. The Queen',
'citation': '1956 CanLII 541 (SCC)'},
{'databaseId': 'nbca',
'caseId': {'en': '2021nbca3'},
'title': 'Currie v. R.',
'citation': '2021 NBCA 3 (CanLII)'},
{'databaseId': 'csc-scc',
'caseId': {'en': '1982canlii33'},
'title': 'Graat v. The Queen',
'citation': '1982 CanLII 33 (SCC), [1982] 2 SCR 819'},
{'databaseId': 'onca',
'caseId': {'en': '2018onca494'},
'title': 'R. v. Ajise',
'citation': '2018 ONCA 494 (CanLII)'},
...
}
v 0.4.1 updates
Contributing
Contributions to improve this module are welcome. You can contribute by:
- Reporting bugs
- Suggesting enhancements
- Sending pull requests with bug fixes or new features
License
This project is licensed under the GPL 3.0 License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for legal_citation_parser-0.4.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 661a6384f5fcf0c59f46a617ef3e65ec771e76ddadfc5e2bbbc1d88a629f4768 |
|
MD5 | da3f13ef0f869a4b46571c5b69406aab |
|
BLAKE2b-256 | 217efe2a2ecfb76fff40efd2ac5e4306feda3872d3b4e89a9329afa23bc11daf |
Hashes for legal_citation_parser-0.4.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e8a0f2013a93cc4fb959ae0ee57c8206718e9050fcfc18e248fc800f4f2b4492 |
|
MD5 | 0facf8d3dcf6843f683d33e59798064b |
|
BLAKE2b-256 | 9436165fae4bd1a3df705438989b48789b962ea61cc15e93ed6f74c1a3df7670 |