Metadata-Version: 2.4
Name: citation-utils
Version: 0.5.0
Summary: Pattern matching Philippine Supreme Court citations.
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: citation-report>=0.2.0
Dynamic: license-file

# citation-utils

![Github CI](https://github.com/justmars/citation-utils/actions/workflows/ci.yml/badge.svg)

Regex formula of Philippine Supreme Court citations in docket format (with reports); utilized in the [LawSQL dataset](https://lawsql.com).

## Documentation

See [documentation](https://justmars.github.io/citation-utils), building on top of [citation-report](https://justmars.github.io/citation-report).

## Caveats

### DocketCategory

Each `DocketCategory` has its own nuanced regex patterns identifying its _category_, _serial_text_, and _date_

#### Adding new Citation types

Recently, the `JIB` was added as a new category. This means creating a new `CitationConstructor` object with distinct objectts.

#### Adding new DocketRules

There are are `AM` and `BM` docket numbers that represent rules rather than decisions.

### DocketReports

Based on a `CiteableDocument`, construct a temp object prior to formation of `Citation`. This temp object is either:

1. A combination of a `Docket` object with its `Report` object; or
2. A solo, undocketed `Report`.
