Skip to main content

Python client for parsing SCOTUS cases from the granted/noted and orders dockets.

Project description

Getting started

pip install nyt-docket

Using nyt-docket

Command-line interface

docket grants 2015
docket orders 2015
docket opinions 2015

Demo app

Run the demo app.

python -m docket.demo

Modules

Use the docket loader manually from within your Python script.

Grants (new cases)

Grants are cases that have been granted certiorari and will be heard by the Court in this term. The most interesting thing about a grant, besides its existence, is the question the Court will be deciding. This is associated as a separate PDF file on the Court’s site but the parser attaches it to the case as a text blob.

from docket import grants

g = grants.Load()
g.scrape()

for case in g.cases:
    print case.__dict__

Slip opinions (decisions)

Slip opinions are decisions in cases the Court has either heard arguments on or has made a procedural decision on. These opinions are not final, but it’s the fastest way to know when the Court has acted on a case. The most important feature of a slip opinion is the opinion text, which is a separate PDF file. This is associated with the opinion as a hyperlink.

from docket import slipopinions

o = slipopinions.Load()
o.scrape()

for case in o.cases:
    print case.__dict__

Orders (all kinds of things)

Orders are the daily business of the Court. Denials of certiorari as well as various other procedural motions are resolved in the orders list. This plugin grabs the long orders list itself as a PDF link and then parses it out into individual cases. WARNING: The individual cases rely on regex and tomfoolery. The methods for parsing them are fragile, so YMMV.

from docket import orders

z = orders.Load()
z.scrape()
z.parse()

for order in z.orders:
    print order.__dict__

for case in z.cases:
    print "%s\t%s\t%s" % (case.docket, case.orders_type, case.casename)

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

nyt-docket-0.0.13.tar.gz (8.0 kB view details)

Uploaded Source

File details

Details for the file nyt-docket-0.0.13.tar.gz.

File metadata

  • Download URL: nyt-docket-0.0.13.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for nyt-docket-0.0.13.tar.gz
Algorithm Hash digest
SHA256 bb958122b431af69525356998bb541600e9ffc61d08e8e024d291d9005470a71
MD5 913512b5b8708748d7b419a7993cab96
BLAKE2b-256 20caad6573f7313064ca1243f698976d9ea71a3bcd46ebb0efe506417a78e044

See more details on using hashes here.

Provenance

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